Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

 
 

ジュニパー Mist ポータルに Webhook を追加する

これらの手順に従って、ジュニパー Mist™ポータルを使用して新しいWebhookを設定します。

  1. ジュニパー Mist™ポータルで、組織またはサイトの設定に移動します。

    • 組織レベルのWebhookの場合は、 組織 > 設定を選択します。

    • サイト レベルの Webhook の場合は、[ 組織] > [サイトの構成] を選択し、サイトを選択します。

      注:

      次の例は、サイトレベルのWebhookを設定する方法を示しています。組織レベルのWebhookを設定する場合、選択できるWebhookトピックのリストなど、表示されるオプションは異なります。
  2. Webhooksセクションまで下にスクロールし、Webhookを追加をクリックします。
    Location of the Add Webhook button
  3. 情報を入力します。

    • 名前—このWebhookを識別するための名前を入力します。

    • Webhookタイプ—HTTP Post、OAuth2、またはSplunkを選択します。OAuth2の場合、Mistクラウドは選択したタイプのクライアントとして機能し、認証サーバーに対して認証してトークンを取得し、それをWebhook認証ヘッダーに追加します。

    • URL—MistがWebhookの送信先として入力します。

    • 許可タイプ—(OAuth2のみ)顧客システムからアクセストークンを要求するには、2つの方法があります。

      • パスワードベース:リソース所有者のユーザー名とパスワードが必要です。

      • クライアント資格情報ベース。OAuth IDPから提供されるクライアントIDとクライアントシークレットが必要です。

    • トピック—Webhookを受信するトピックを選択します。少なくとも1つ選択する必要があります。

  4. (オプション)追加オプションについては、詳細設定をクリックします。

    • 証明書の確認—このオプションはデフォルトで有効になっています。Webhook受信者の証明書が有効であることをMistで検証しない場合は、[ いいえ]をクリックします。この方法は安全ではありませんが、Webhook レシーバーに有効な署名付き証明書がない場合に、ある程度の柔軟性があります。セキュリティ上の理由から、この方法は推奨されません。

    • シークレット(HTTP-POSTのみ)—シークレットを使用すると、HTTPヘッダーのペアの計算に使用するシークレット(パスワードなど)を指定できます。シークレットを使用すると、メッセージがジュニパー Mistから送信されており、変更されていないことを確認できます。

    • カスタムヘッダー—カスタムヘッダー設定では、Webhookレシーバーに必要なカスタムヘッダーを指定できます。一部の受信者(またはそのプロキシ)では、トークンベースの認証方法、ユーザーベースの認証、または送信されるデータのタイプを示すカスタムヘッダーを表示する方法が必要です。

    注:

    シークレットヘッダーとカスタムヘッダーのどちらを使用するかを検討する際には、次の注意事項に留意してください。

    • シークレットを指定すると、2つのHTTPヘッダーが追加されます。
      • X-Mist-Signature:HMAC_SHA1(シークレット、本文)
      • X-Mist-Signature-v2:HMAC_SHA256(シークレット、本文)
    • ヘッダー形式が無効な場合は、"X-Mist-Error": "headers format invalid"が送信されます。
    • ヘッダーの合計バイト数が1000を超えると、"X-Mist-Error:"headers too big"が送信されます。
    • ヘッダー値が文字列でない場合、"X-Mist-Error": "header[%s] not a string" が送信されます。
  5. 追加をクリックします。