ウェブフックの管理

コネクター資格情報

Nexthinkが外部ツールへデータをエクスポートする前に、新しい資格情報を作成し、接続と通信を可能にする必要があります。その後、Webhookを設定する際にその資格情報を適用します。詳細については、コネクター資格情報ドキュメントを参照してください。

Nexthinkは、外部ツールに送信されたメッセージの配信を調整するメカニズムを使用しており、ツールがデータで過負荷になるのを防いでいます。&#x20

これにより、情報配信が即時ではなく、遅延が生じる場合があります。

Webhookへのアクセス

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

Webhookにアクセスするには、以下の手順に従ってください:

メインメニューから Administration > Outbound connectors を開きます。
アウトバウンドコネクターのリストから Webhooks を選択します。
- システムは、既存のすべてのWebhookをリストします。従って、Webhookページに初めてアクセスした時には、要素は表示されません。

Configuration列のアイコンを確認し、ホバーして既存のWebhookセットアップの有効性を確認します。

Webhookページの表フィールドは以下の通りです:

Active: アラートやイベントの発生を検知し、アクションを実行するためのWebhookを有効にするトグル
Name: Webhookの名前
Credentials: Webhookがデータを送信する外部ツールの資格情報を定義する
Description: Webhookが実行するアクションの意味のある説明

Webhookの作成とテスト

Administration > Outbound connectors > Webhooks ページから:

Webhookの設定ページを開くために、新しいWebhookボタンをクリックします。
フォームに記入してください:
- 作成するWebhookの名前。
- Webhookによって実行されるアクションの説明。
- NQL条件とは、アラートやイベントの発生をトリガーする条件を指定するNQLクエリであり、リクエストメソッドセクションで設定されたアクションをトリガーします。 WebhookのNQL条件の設定ドキュメントを参照してください。
- 資格情報は、ターゲットとする情報の第三者ツールの資格情報を指定します。
- リクエストメソッド、リソース、およびペイロードは、外部ツールで実行されるアクションを表す情報を定義します。リクエストメソッド、リソースAPI、ペイロードについての情報は、Webhookフィールドの設定: リクエストメソッド、リソース、ペイロードドキュメントを参照してください。
テスト送信を使用して、資格情報、リクエストメソッド、リソース、およびペイロードの正しい設定を確認します。
- システムは、設定フィールドの欠落や間違いについて警告します。
- テストにおいてプレースホルダーの使用がペイロード内で置き換えられることはありません。例えば: {{variable_name}}。システムはすべての変数を通常の文字列として扱います。