アラート通知用Webhook
Webhook を使用して、受信 Webhook URL が設定されているサードパーティ製アプリケーションに Citrix Analytics のアラート通知を送信できます。Webhook は、サービスプロバイダーアプリケーションとコンシューマーアプリケーション間のリアルタイムメッセージングを可能にする HTTP コールバックです。アラート通知はリアルタイムで送信されるため、イベント発生時に通知を受け取ることができます。
Citrix Analytics がアラートをトリガーすると、関連付けられた Webhook がターゲットアプリケーションの URL にアラートメッセージを送信します。アラートは、HTTP POST または PUT リクエストを介して JSON ペイロードの形式で送信されます。たとえば、ユーザーがリスクインジケーターをトリガーしたり、VDI マシンのパフォーマンスが低下したりした場合、Webhook を設定してアラート通知を Slack チャネルに送信できます。 アラート管理のために Webhook を設定すると、アプリケーションでリアルタイム通知を受け取ることができます。セキュリティリスクを軽減したり、Citrix Virtual Apps and Desktops™ 展開のパフォーマンスを向上させたりするために、タイムリーな措置を講じることができます。
Webhook プロファイルの作成
Citrix Analytics で Webhook プロファイルを作成するには:
-
Citrix Analytics にサインインします。
-
プロファイル名と Webhook の目的を識別するための説明を入力します。
-
アラートメッセージを送信するための HTTP メソッドとアプリケーションの Webhook URL を選択します。
-
Webhook URL に送信するアラートに関するメッセージを入力します。メッセージは、ターゲットアプリケーションで定義されている JSON または XML などの形式で構造化されている必要があります。詳細については、「Webhook の例」を参照してください。
-
(オプション) メッセージのヘッダーキーと値を入力します。ヘッダーには、ペイロードをアプリケーションに安全に送信するための認証トークンやその他のカスタムキーと値のペアを含めることができます。
Webhook 設定例
このセクションでは、Slack や Microsoft Teams などのサードパーティアプリケーションにアラートを送信するための Webhook の設定例を示します。
Slack にアラートメッセージを送信する
Slack でアラートを送信する前に、以下のタスクを完了していることを確認してください。
-
まだお持ちでない場合は、Citrix Analytics 用の Slack アプリを作成します。
-
アプリケーションで、受信 Webhook 機能を有効にし、受信 Webhook を作成します。
-
アプリがメッセージを投稿するチャネルを選択します。
-
アプリを承認すると、メッセージを送信するための Webhook URL が取得されます。 詳細については、「受信 Webhook の使用開始」を参照してください。
メッセージ形式の例
curl --location --request POST 'WEBHOOK URL' --header 'Content-Type: application/json' --data-raw '{"text": "Test Citrix Analytics Alert."}
出力
Microsoft Teams にアラートメッセージを送信する
Microsoft Teams でアラートを送信する前に、以下のタスクを完了していることを確認してください。
-
Teams内にTeamsグループがまだない場合は作成します。
-
Webhookコネクタを作成します。メッセージの作成と送信の記事に記載されている手順を参照してください。
-
WebhookのURLを取得します。
メッセージ形式の例
curl --location --request POST 'WEBHOOK URL' --header 'Content-Type: application/json' --data-raw '{"text": "Test Citrix Analytics Alert."}
出力
