ServiceNowとMist Webhookの統合
統合プロセスは、ServiceNow 構成と Mist 構成の 2 つのセクションに分かれています。構成セクションの後に、Postman を使用して Webhook のセットアップをテストする検証セクションを提供します。
ServiceNowセットアップ
メモ：
このタスクで示す手順は、ServiceNow バージョン "ローマ" でテストされています。 画面キャプチャは、ServiceNow の他のバージョンと一致しない場合があります。この手順では、ServiceNow に提供する必要がある情報に関するコンテキストを提供します。
- ServiceNow インスタンスで、[スクリプト化された Web サービス] > [スクリプト化された REST API] > [システム Web サービス] に移動します。
- [新規] ボタンをクリックします。
- 新しい「スクリプト化されたRESTサービス」に名前を付けます
メモ：[名前] フィールドのフォーカスが解除されると、[ API ID ] フィールドが自動的に更新されます。
- 新しいスクリプト化されたRESTサービスを見つけてクリックします
- タブの一番下までスクロールし、[リソース]タブの[新規]をクリックします
- 新しいリソースに適切な名前を付ける
- HTTP メソッドを POST に設定します。
- [認証が必要] のチェックを外し、[送信] をクリックします。
- 新しいリソースに戻る
[リソース パス] 列の パス をメモします。 - [スクリプト] セクションに次の JavaScript を追加し、[更新] をクリックします
var Input = request.body.dataString; gs.log(Input);
このコードは、Webhook の内容を文字列として含む "Input" という名前の変数を定義します。gs.log(入力)コマンドは、変数をServiceNowのシステムログに送信します。
これで、ServiceNowでのウェブフックの初期設定は完了です。要求リソースのスクリプト セクションは、受信データを解析したり、このリソースに入力される情報に基づいてインシデントを作成したりするのに最適な場所です。
Mist の設定
:org_id が Mist 組織 ID である https://api.mist.com/api/v1/orgs/:org_id/webhooks に移動します。これ
は、[組織>設定]に移動して見つけることができます
- :org_id = Mist組織IDが設定されている https://api.mist.com/api/v1/orgs/:org_id/webhooks に移動します。
郵便配達員を使用した検証
ServiceNowとMistの設定を検証するには、Postmanを使用して偽のWebhookをServiceNowに送信します。このセクションでは、その方法を示します。
メモ：
次の例に示すバージョンとは異なるバージョンの Postman を使用している可能性があります。この例で作成する接続要求と、入力および収集するデータに注意してください。接続の種類と適切なデータを使用して、使用しているバージョンの Postman で構成をテストします。
- Mist で作成した URL を使用して、ServiceNow インスタンスへの HTTPS POST リクエストを作成します。
- [ヘッダー] タブをクリックし、application/json の値を持つ content-type という名前の新しいキーを作成します。
そうしたら
要求：
- 次の情報をコピーして、要求の本文に貼り付けます。
{ “topic”: “device-events”, "events": [ { "ap": "100000000001", "ap_name": "Access Point 1", "org_id": "12345678-1234-1234-1234-123456789abc", "site_id": "abcdefgh-abcd-abcd-abcd-abcdefghijkl", "site_name": "Test Site 1", "timestamp": 1597994894, "type": "AP_CONFIGURED" }, { "ap": "200000000002", "ap_name": "Access Point 2", "org_id": "12345678-1234-1234-1234-123456789abc", "site_id": "abcdefgh-abcd-abcd-abcd-abcdefghijkl", "site_name": " Test Site 1", "timestamp": 1597994894, "type": "AP_CONFIGURED" }, { "ap": "300000000003", "ap_name": "Access Point 3", "org_id": "12345678-1234-1234-1234-123456789abc", "site_id": "abcdefgh-abcd-abcd-abcd-abcdefghijkl", "site_name": " Test Site 1", "timestamp": 1597994894, "type": "AP_CONFIGURED" }, { "ap": "400000000004", "ap_name": "Access Point 4", "org_id": "12345678-1234-1234-1234-123456789abc", "site_id": "abcdefgh-abcd-abcd-abcd-abcdefghijkl", "site_name": " Test Site 1", "timestamp": 1597994894, "type": "AP_CONFIGURED" } ] }完了すると、要求の本文は次のようになります。
ServiceNowでWebhook情報を確認する
ServiceNow GUI で、[すべて] > [システム ログ] に移動します。
Postman 要求からのペイロード (本文) を含むログ エントリを探します
