メインコンテンツまでスキップ

ServiceNowにインシデント登録する　～Webhook通報の使い方【テーブルAPI編】～

概要の説明​

WebSAM Cloud 通報サービスのWebhook通報機能を使って、監視システムで発生したアラートをServiceNowと統合する方法を説明します。

Webhook通報とServiceNowの統合の設定をすると、WebSAM Cloud 通報サービスが受信したアラートメールをServiceNowへWebhookして、ServiceNowのテーブルAPIを介してインシデントを登録することができます。

Scripted REST APIsを使用したインシデント登録はServiceNowにインシデント登録する　～Webhook通報の使い方【Scripted REST APIs編】を参照してください。

WebSAM Cloud 通報サービスのWebhook通報機能を使って、アラートをServiceNowと統合する設定の流れは次の通りです。

  1. ServiceNowにWebhook受信用のユーザを作成する

  2. ServiceNowでインシデント登録用のACLを作成する

  3. WebSAM Cloud 通報サービスでWebhook設定をする

  4. Webhook通報用のパターン登録をする

ServiceNowにWebhook受信用のユーザを作成する​

WebSAM Cloud 通報サービスから送信されるWebhookを受信するためのユーザをServiceNowに作成します。

  1. ServiceNowの [Organization]セクションの[Users]をクリックします。

  2. [New]をクリックして、ユーザを新しく作成します。

  3. [User ID]にユーザの名前を入力します。

    例：rest.amcuser

  4. [Web service access only]のチェックボックスにチェックを入れます。

  5. [Time zone]のドロップダウンリストをクリックして、Asia/Tokyoを選択します。

  6. [Submit]をクリックします。

  7. ユーザ一覧の画面から作成したユーザを選択して、ユーザ詳細画面に移動します。

  8. [Set Password]をクリックします。

  9. Set Password画面で[Generate]をクリックしてパスワードを生成し、[Save Password]をクリックして保存します。

    作成したパスワードは後程、Webhookの設定で利用します。

ServiceNowでインシデント登録用のACLを作成する​

WebSAM Cloud 通報サービスから送信されるWebhookを受信して、ServiceNowのインシデントテーブルにレコードを作成するためのACLルールを作成します。 本手順ではsecurity_adminロールが必要です。

  1. security_adminロールに権限を昇格します。

  2. ServiceNowの [System Security]セクションの[Access Control(ACL)]をクリックします。

  3. [New]をクリックします。

  4. フォームに必要事項を入力します。

    ここではインシデントテーブルのDescriptionに書き込む(write)権限を、rest.amcuserユーザに付与するルールを作成します。

  5. [Submit]をクリックして[Continue]をクリックします。

WebSAM Cloud 通報サービスでWebhook設定をする​

  1. WebSAM Cloud 通報サービスの[プロジェクト]をクリックしてプロジェクト一覧を表示します。

  2. プロジェクト一覧からWebhookを設定するプロジェクトの[編集]をクリックします。

  3. [Webhook設定]のセクションの[Webhook設定]を有効に設定します。

  4. カスタムWebhookで追加をクリックします。

  5. [Webhook名称]には識別しやすい名前を入力し、[WebhookURL]に、ServiceNowのテーブルAPIのURLを入力します。

    https://<InstanceName>.service-now.com/api/now/table/incident

  6. [ペイロード]にServiceNowに渡すデータをjson形式で設定します。

    本手順では、インシデントテーブルのShort descriptionにアラートメールの件名、Descriptionにアラートメール本文を登録します。 WebSAM Cloud 通報サービスの他のデータを渡したい場合は、ペイロードで利用可能なマクロ一覧を参照してください。

    インシデントテーブルの他のカラムに情報を登録したい場合はServiceNowのドキュメントを参照の上設定してください。 カラムによってはACLルールの登録が必要な場合があります。

    {
        "short_description": "${MAIL_SUBJECT}",
        "description": "${MAIL_BODY}"
    }

  7. [カスタムパラメータ]の[+追加]をクリックします。

  8. 追加したカスタムパラメータに以下のように設定します

    [キー]にAuthorizationを入力します。

    [値]にBasic (BASE64エンコード)Webhook受信用ユーザ名:パスワードを入力します。

    (例) (BASE64エンコード) rest.amcuser:12345 → cmVzdC5hbWN1c2VyOjEyMzQ1

  9. [確認]をクリックし、[更新]をクリックしてプロジェクト更新を完了します。

Webhook通報用のパターン登録をする​

  1. WebSAM Cloud 通報サービスの[パターン]をクリックしてパターン一覧を表示します。

  2. [+パターン追加]をクリックして、新しいパターンを作成してください。

  3. パターン登録画面で[通報設定]セクションの[Webhook]を有効にし、Webhook通報先にはプロジェクトに登録したWebhook名称を設定してください。

ServiceNowは米国およびその他の国における ServiceNow, Inc.の商標または登録商標です。