ウェブフックの管理

コネクター資格情報

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

Webhookへのアクセス

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

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

1. メインメニューから Administration > Outbound connectors を開きます。

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

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

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

• Active: アラートやイベントの発生を検知し、アクションを実行するためのWebhookを有効にするトグル

• Name: Webhookの名前

• Credentials: Webhookがデータを送信する外部ツールの資格情報を定義する

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

Webhookの作成とテスト

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

1. Webhookの設定ページを開くために、新しいWebhookボタンをクリックします。

2. フォームに記入してください:

   • 作成するWebhookの名前。

   • Webhookによって実行されるアクションの説明。

   • NQL条件とは、アラートやイベントの発生をトリガーする条件を指定するNQLクエリであり、リクエストメソッドセクションで設定されたアクションをトリガーします。 WebhookのNQL条件の設定ドキュメントを参照してください。

   • 資格情報は、ターゲットとする情報の第三者ツールの資格情報を指定します。

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

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

   • システムは、設定フィールドの欠落や間違いについて警告します。

   • テストにおいてプレースホルダーの使用がペイロード内で置き換えられることはありません。例えば: {{variable_name}}。 システムはすべての変数を通常の文字列として扱います。

以下の画像はWebhook設定フィールドの例を示しています。

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

既存のWebhookの編集/削除

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

1. Webhookをホバーして、選択した項目の右側にアイコンを表示します:

   • Webhookの設定ページを開くために、鉛筆のアイコンをクリックします。

   • Webhookを削除するために、ゴミ箱のアイコンをクリックします。

Webhookの無効化

Webhookを無効化すると、NQL条件が警告設定要件を満たしても、外部ツールとの接続は切断されます。

Webhookのアクティブトグルをオフにする場所は2箇所あります:

• Webhookページ上のWebhookリストのアクティブ列で。

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

関連タスク

コネクター資格情報