ウェブフックの管理

コネクタ資格情報

Nexthinkが任意のサードパーティ対応ツールにデータをエクスポートする前に、新しい資格情報を作成し、定義して接続を可能にした後、Webhookを構成するときにその資格情報を適用する必要があります。 詳細は コネクタ資格情報 のドキュメントを参照してください。

Nexthinkは、サードパーティツールに送信されるメッセージの配送を調整するメカニズムを使用しており、データの過剰負荷を防ぎます。

このため、情報の配送は即時ではなく、遅延が発生することがあります。

Webhookへのアクセス

Webhookを構成するには、中央管理の特権と統合モジュールが有効にされている必要があります。

Webhookにアクセスするための手順は以下の通りです。

  1. メインメニューから 管理 > アウトバウンドコネクタ を開きます。

  2. アウトバウンドコネクタの一覧から Webhooks を選択します。

    • システムは既存の全てのWebhookをリストします。 したがって、初めてWebhooksページにアクセスした時には、何も表示されません。

構成の列のアイコンを確認しながら、既存のWebhookセットアップの有効性を確認してください。

Webhooks overview page.

以下、Webhookページのテーブルフィールドです。

  • アクティブ: Webhookをアラートやイベントが発生した際にアクションを実行するために、有効化するトグル。

  • 名前: Webhookの名称

  • 資格情報: Webhookがデータを送信するサードパーティツールの資格情報を定義。

  • 説明: Webhookが実行するアクションの意味のある説明。

Webhookの作成とテスト

管理 > アウトバウンドコネクタ > Webhooks ページから:

  1. 新しいWebhook ボタンをクリックして、Webhook設定ページを開きます。

  2. フォームを記入します。

    • Webhookを命名します。

    • Webhookが実行するアクションの説明

    • NQL条件はアラートまたはイベントがアクションを起動する条件を特定したNQLクエリです。 Webhook NQL 条件の構成について のドキュメントを参照してください。

    • 資格情報はターゲットとするサードパーティツールの資格情報を指定します。

    • リクエストメソッドリソースペイロードはサードパーティツールに実行されるアクションを表す情報を定義します。 Webhookのフィールド:メソッド、リソース、およびペイロードの構成のドキュメントを参照して、リクエストメソッド、リソースAPI、ペイロードについての情報を参照してください。

  3. 送信テストを使用して、資格情報リクエストメソッドリソースおよびペイロードの正しい構成を検証します。

    • システムは、間違いまたは構成フィールドの不足を警告します。

    • テストは、ペイロード内のプレースホルダー(例:{{variable_name}})の使用を代替しません。 システムはすべての変数を単純な文字列として扱います。

以下の図はWebhook構成フィールドの例を示しています。

Creating webhooks.

以下の画像は、Webhook設定ページからの送信テストボタンを使用して作成されたServiceNowのインシデントを示しています。

ServiceNow incident created using Sent test button

既存のWebhookの編集/削除

管理 > アウトバウンドコネクタ > Webhooks ページから:

  1. Webhookにカーソルを合わせ、選択したアイテムの右側にアイコンを表示させます。

    • 鉛筆アイコンをクリックしてWebhookの構成ページを開きます。

    • ゴミ箱アイコンをクリックしてWebhookを削除します。

Webhookの削除は元に戻すことができません。

Editing webhooks.

Webhookの無効化

Webhookを無効にすると、NQL条件がアラート設定要件を満たしていても、サードパーティツールは切り離されます。

Webhookを無効にするアクティブトグルを切り替えることができる場所が2箇所あります。

  • WebhooksページのWebhookリストのアクティブ列に配置されたトグル。

  • Webhook編集ページでWebhookのアクティブプロパティを編集します。

Enabling or disabling a webhook.

関連タスク

コネクタ資格情報

Last updated

Was this helpful?