アラート通知用Webhook
Webhookを使用すると、Citrix Analyticsのアラート通知を、受信Webhook URLが構成されているサードパーティアプリケーションに送信できます。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にサインインします。
- サブスクライブしているサービスに応じて、ManageをクリックしてSecurity AnalyticsまたはPerformance Analyticsにアクセスします。
- 上部のバーから、Settings > Alert Settings > Webhookをクリックします。
-
Create Webhookを選択します。
- Webhookの目的を識別するために、プロファイル名と説明を入力します。
-
アラートメッセージを送信するアプリケーションのHTTPメソッドとWebhook URLを選択します。
注: 通常、送信WebhookはHTTP POSTリクエストを介して送信されます。アプリケーションのWebhook URLに認証トークンを含めることもできます。
- Webhook URLに送信するアラートに関するメッセージを入力します。メッセージは、ターゲットアプリケーションで定義されているJSONまたはXMLなどの形式で構造化する必要があります。詳細については、「Webhookの例」を参照してください。
- (オプション) メッセージのヘッダーキーと値を入力します。ヘッダーには、ペイロードをアプリケーションに安全に送信するための認証トークンやその他のカスタムキーと値のペアを含めることができます。
- Webhook構成を検証するには、Testをクリックします。 テストでは、送信Webhook URL、ペイロード構造、およびヘッダーキーが検証されます。構成に問題がない場合、「Test successful」メッセージが表示されます。
Webhook構成の例
このセクションでは、SlackやMicrosoft Teamsなどのサードパーティアプリケーションにアラートを送信するためのWebhook構成の例を示します。
注: Webhook URLの取得方法とWebhookに必要な構成については、サードパーティアプリケーションの製品ドキュメントを参照してください。
Slackへのアラートメッセージの送信
Slackでアラートを送信する前に、次のタスクを完了していることを確認してください。
- Citrix Analytics用のSlackアプリをまだ作成していない場合は、作成します。
- アプリで、受信Webhook機能を有効にし、受信Webhookを作成します。
- アプリがメッセージを投稿するチャネルを選択します。
- アプリを承認すると、メッセージ送信用のWebhook URLが取得されます。 詳細については、「Incoming Webhooksの概要」を参照してください。
サンプルメッセージ形式
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."}
出力
