用于警报通知的 Webhook

您可以使用 Webhook 将 Citrix Analytics 警报通知发送给配置了传入 Webhook URL 的任何第三方应用程序。Webhook 是 HTTP 回调,可在服务提供商应用程序和消费者应用程序之间实现实时消息传递。由于警报通知是实时发送的,因此您会在事件发生时收到通知。

当 Citrix Analytics 触发警报时,关联的 Webhook 会将警报消息发送到目标应用程序的 URL。警报以 JSON 负载的形式通过 HTTP POST 或 PUT 请求发送。例如,当用户触发风险指示器或 VDI 计算机的性能下降时,您可以设置 Webhook 将警报通知发送到您的 Slack 频道。 为警报管理设置 Webhook 可帮助您在应用程序中获取实时通知。您可以及时采取措施来降低安全风险或提高 Citrix Virtual Apps and Desktops 部署的性能。

创建 Webhook 配置文件

要在 Citrix Analytics 上创建 Webhook 配置文件,请执行以下操作:

  1. 登录 Citrix Analytics。
  2. 根据您订阅的产品,单击“管理”以访问 Security Analytics 或 Performance Analytics。
  3. 在顶栏中,单击“设置”>“警报设置”>“Webhook”。
  4. 选择 创建 Webhook创建 Webhook 配置文件
  5. 输入 Webhook 的配置文件名称和描述以确定其用途。
  6. 选择应用程序的 HTTP 方法和 Webhook URL 来发送警报消息。

    注意: 传出的 Webhook 通常是通过 HTTP POST 请求发送的。您还可以在应用程序的 Webhook URL 中包含身份验证令牌。

  7. 输入有关您要发送到 Webhook URL 的警报的消息。消息的结构必须采用目标应用程序定义的 JSON 或 XML 等格式。有关更多信息,请参阅 Webhook 示例。
  8. (可选)输入消息的标题键和值。标头可以包含身份验证令牌或其他自定义键值对,以将负载安全地发送到您的应用程序。
  9. 要验证 Webhook 配置,请单击“测试”。 该测试会验证传出的 Webhook URL、负载结构和标头密钥。如果在配置中未发现任何问题,则会收到“测试成功”消息。

Webhook 配置示例

本节提供了配置 Webhook 以向 Slack 和 Microsoft Teams 等第三方应用程序发送警报的示例。

注意: 有关如何获取 Webhook URL 和 Webhook 所需的配置,请参阅第三方应用程序的产品文档。

向 Slack 发送警报消息

在 Slack 上,请确保在发送警报之前已完成以下任务:

  1. 如果您还没有 Slack 应用程序,请为 Citrix Analytics 创建一个 Slack 应用程序。
  2. 对于应用程序,启用传入 Webhook 功能并创建传入 Webhook。
  3. 选择应用程序向其发布消息的频道。
  4. 当您授权应用程序时,您将获得用于发送消息的 Webhook URL。 有关信息,请参阅传入 Webhook 入门

示例消息格式

curl --location --request POST 'WEBHOOK URL' --header 'Content-Type: application/json' --data-raw '{"text": "Test Citrix Analytics Alert."}

输出

Slack 中的警报消息示例

向Microsoft Teams 发送警报消息

在 Microsoft Teams 上,请确保在发送警报之前已完成以下任务:

  1. 如果您还没有 Teams 组,请在 Teams 中创建一个 Teams 组。
  2. 创建 Webhook 连接器。请参阅“创建和发送消息”一文中描述的步骤。
  3. 获取 Webhook 的 URL。

示例消息格式

curl --location --request POST 'WEBHOOK URL' --header 'Content-Type: application/json' --data-raw '{"text": "Test Citrix Analytics Alert."}

输出

Teams 中的警报消息示例

用于警报通知的 Webhook