Webhookの管理

コネクタの認証情報

Nexthinkが任意のサードパーティ対応ツールにデータをエクスポートする前に、新しい認証情報を作成して、接続とそのコミュニケーションを有効にし、Webhookを設定する際にその認証情報を適用する必要があります。詳細については、コネクタの認証情報のドキュメントを参照してください。

Nexthink は、サードパーティツールに送信されたメッセージの配信を規制する仕組みを使用しており、データで負荷がかかることを防ぎます。

これにより、情報の配信が即時ではなく、一部の遅延が発生する可能性があります。

Webhookへのアクセス

Webhookを設定するには、中央管理者権限と統合モジュールが有効である必要があります。

Webhookにアクセスするには、次の手順に従います:

メインメニューから管理 > アウトバウンドコネクタを開きます。
アウトバウンドコネクタのリストからWebhookを選択します。
- システムは存在する全てのWebhookを一覧表示します。したがって、Webhookページに初めてアクセスするときは、要素は表示されません。

設定欄のアイコンを確認してホバーすることで、既存のWebhookセットアップの有効性を確認できます。

Webhookページのテーブルフィールドは以下となります:

有効: アラートやイベントが発生した場合にアクションを実行するためのWebhookを有効にするトグル
名前: Webhookの名前
認証情報: Webhookがデータをプッシュするサードパーティツールの認証情報を定義
説明: Webhookによって実行されるアクションの意味のある説明

Webhookの作成とテスト

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

Webhook設定ページを開くには、新しいWebhookボタンをクリックしてください。
フォームに記入します。
- 作成中のWebhookに名前を付けます。
- Webhookによって実行されるアクションの説明
- NQL条件は、リクエストメソッドセクションで構成されたアクションをトリガーするアラートまたはイベントの条件を指定するNQLクエリです。 WebhookのNQL条件の設定のドキュメントを参照してください。
- 認証情報は、ターゲットにしたいサードパーティツールの認証情報を指定します。
- リクエストメソッド、リソース、およびペイロードは、サードパーティツールで実行されたアクションを表す情報を定義します。リクエストメソッド、リソースAPI、およびペイロードに関する情報については、Webhookフィールド設定: メソッド、リソース、ペイロードのドキュメントを参照してください。
テストの送信を使用して、認証情報、リクエストメソッド、リソース、およびペイロードの正しい設定を確認します。
- システムは、設定フィールドに誤りや不足がある場合には警告を発します。
- テストはペイロード内のプレースホルダーの使用を置き換えません。例として: {{variable_name}}。システムはすべての変数をプレーンな文字列として扱います。