Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

 
 

イベント通知を受信するようにWebhookを設定する

Webhookを使用して、ソースアプリケーションから宛先アプリケーションへのイベント通知の送信を自動化します。Webhookを設定して、サブスクリプションしているイベントが管理対象デバイスでトリガーされたときに、Routing DirectorがSlackなどのサードパーティアプリケーションに通知を送信できるようにすることができます。

注:

Routing Directorがサードパーティ製アプリケーションに接続するには、インターネット接続が必要です。

次のセクションでは、Slack でイベント通知を受信するように Webhook を設定する方法について説明します。

Slack と互換性のある形式で Webhook 通知を受信するには、送信および受信アプリケーションと対話できる仲介者 (この場合は Routing Director と Slack) を構成する必要があります。推奨される仲介プラットフォームはMakeです。通知を処理するために、Make はシナリオと呼ばれるワークフローを使用し、通知を Slack がサポートする形式に変換します。各イベント通知は、Makeのシナリオ用に生成されたURLに送信されます。その後、通知はSlackがサポートする形式に変換され、設定されたSlackチャネルに配信されます。

Makeのシナリオについては、「 シナリオ」を参照してください。

Routing Director で Webhooks を設定して、Slack チャネルに通知を送信するには:

  1. ログイン してMake https://www.make.com/en/login。ホームページから、左側のナビゲーションメニューのシナリオに移動します。
  2. シナリオ の作成を参照してください。説明に従ってシナリオ設定 を構成します

    Make は URL を生成します。イベントがトリガーされるたびに、Routing Director はこの URL に Webhook 通知を送信します。

  3. Routing Director GUIで、組織設定(設定メニュー>システム設定)に移動します。

    組織設定ページが表示されます。

  4. Webhooksタイルで、Webhooksを有効にします。
  5. Webhooks設定を構成します。Webhookフィールドの説明については、表1を参照してください。
    注:
    • URLフィールドに、ステップ 2で生成されたURLを入力します。

    • *とマークされたフィールドは必須です。

  6. (オプション)デバイスの CLI にログインし、イベントを生成することで、Webhook と Slack の統合を確認します。

    例えば、デバイスCLIで以下のコマンドを実行してアラートを生成します。

  7. (オプション)以下を確認します。
    • 生成したイベントは、イベントページ(監視機能>イベント)にリストされます。

    • Slackチャネルでイベントの通知を受け取りました。

      注:
      • Slack でイベント通知を表示するには、Slack チャネルへのアクセス権が必要です。

      • 是正措置を実行するには、ネットワーク管理者のロールを持つ管理者である必要があります。

    表1:Webhookを設定するパラメーター
    フィールド の説明
    お名前*

    Webhookの名前を入力します。名前には英数字と特殊文字を含めることができます。

    URL*

    シナリオ用にMakeで生成されたURLを入力します。

    SSL証明書の確認*

    クリックして、Webhook宛先のSSL証明書の検証を有効または無効にします(デフォルト)。

    シークレット

    シークレットを入力して、受信した通知が有効なホストからのものであることを検証します。

    シークレットには、英数字と特殊文字の文字列を含めることができます。

    Webhookヘッダー

    Webhookカスタムヘッダーは、通知に関する追加情報を提供するキーと値のペアです。

    複数のカスタムヘッダーを追加できます。

    • 設定されたエンドポイントに送信されるWebhook通知に関する追加情報を、デフォルトのヘッダーとともにプレーンテキストで提供します。

    • APIキーなどのセキュリティを提供し、エンドツーエンドのデータ整合性を検証したり、承認を行うなどを行います。

    追加アイコン(+)をクリックして、Webhookヘッダーを追加します。

    Webhookヘッダーページが表示されます。

    • ヘッダーキー*—一意のキーを入力します。

    • ヘッダー値*—キーの一意の値を入力します。値には英数字を含めることができます。

    削除アイコン(ゴミ箱)をクリックして、Webhookヘッダーを削除します。
    ストリーミングAPI

    通知を受信するイベントを有効にします。

    アラート、監査、デバイスステータス、デバイスアラームなどのイベントを購読して、イベントが発生したときにリアルタイムで通知を受け取ることができます。

    • アラート—クリックして、管理対象デバイスでサブスクライブされたアラートが生成された場合の通知の受信を有効または無効にします。アラート通知はデフォルトで無効になっています。

    • 監査—クリックして、ユーザーが組織にアクセスしたり、組織設定を変更したりしたときに通知の受信を有効または無効にします。監査通知はデフォルトで無効になっています。

    • デバイスステータス—クリックすると、リンクのアップまたはダウン、デバイスのRouting Directorからの切断などのイベントによりデバイスのステータスが変化したときに、通知の受信を有効または無効にできます。デバイスステータス通知はデフォルトで無効になっています。

    • デバイスアラーム—クリックすると、管理対象デバイスでサブスクライブしたアラームが生成されたときに通知の受信を有効または無効にできます。デバイスアラーム通知はデフォルトで無効になっています。