アラート通知用webhook
Webhookを使用して、受信Webhook URLが設定されている任意のサードパーティアプリケーションにCitrix Analyticsのアラート通知を送信できます。Webhook は、サービスプロバイダーアプリケーションとコンシューマーアプリケーション間のリアルタイムメッセージングを可能にする HTTP コールバックです。アラート通知はリアルタイムで送信されるため、イベントが発生すると通知されます。
Citrix Analyticsがアラートをトリガーすると、関連するWebhookがアラートメッセージをターゲットアプリケーションのURLに送信します。アラートは、HTTP POST または PUT リクエストを通じて JSON ペイロードの形式で送信されます。たとえば、ユーザーがリスク指標をトリガーしたり、VDI マシンのパフォーマンスが低下したりした場合に、アラート通知を Slack チャンネルに送信するwebhookを設定できます。 アラート管理用にWebhookを設定すると、アプリケーションでリアルタイムの通知を受け取ることができます。セキュリティリスクを軽減したり、Citrix Virtual Apps and Desktops 環境のパフォーマンスを改善したりするために、タイムリーなアクションを実行できます。
Webhook プロファイルの作成
Citrix Analytics でウェブフックプロファイルを作成するには:
- Citrix Analyticsにログインします。
- 購読しているサービスに応じて、「 管理 」をクリックして「セキュリティ分析」または「パフォーマンス分析」にアクセスします。
- トップバーから [設定] > [ アラート設定] > [Webhook] をクリックします。
- 「 webhookの作成」を選択します。
- プロファイル名とwebhookの説明を入力して、目的を特定します。
-
アラートメッセージを送信するアプリケーションの HTTP メソッドとwebhook URL を選択します。
注: 通常、送信webhookは HTTP POST リクエストを介して送信されます。アプリケーションのwebhook URL に認証トークンを含めることもできます。
- Webhook URL に送信するアラートに関するメッセージを入力します。メッセージは、ターゲットアプリケーションで定義されている JSON や XML などの形式で構造化する必要があります。詳細については、Webhook の例を参照してください。
- (オプション) メッセージのヘッダーキーと値を入力します。ヘッダーには、ペイロードをアプリケーションへ安全に送信するための認証トークンやその他のカスタムキーと値のペアを含めることができます。
- Webhook の設定を検証するには、「 テスト」をクリックします。 このテストでは、送信Webhook URL、ペイロード構造、およびヘッダーキーを検証します。構成に問題が見つからない場合は、「テスト成功」のメッセージが表示されます。
webhookの設定例
このセクションでは、Slack や Microsoft Teams などのサードパーティアプリケーションにアラートを送信するようにwebhookを設定する例を紹介します。
注: Webhook URL の取得方法と 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."}