使用 Amazon EventBridge 监控您的 WorkSpaces - Amazon WorkSpaces
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅 中国的 Amazon Web Services 服务入门 (PDF)

使用 Amazon EventBridge 监控您的 WorkSpaces

您可以使用 Amazon WorkSpaces 中的事件查看、搜索、下载、存档、分析和响应对您的 WorkSpaces 的成功登录。例如,您可以将事件用于以下目的:

  • 将 WorkSpaces 登录事件存储或存档为日志以供日后参考,分析日志以查找模式,并根据这些模式采取措施。

  • 使用 WAN IP 地址确定用户登录的位置,然后使用策略允许用户仅访问 WorkSpace 中符合在 WorkSpaces Access 事件类型中找到的访问条件的文件或数据。

  • 使用 Amazon Lambda 分析登录数据并执行自动操作。

  • 使用策略控制阻止未经授权的 IP 地址访问文件和应用程序。

  • 查找用于连接 WorkSpaces 的 WorkSpaces 客户端版本。

Amazon WorkSpaces 尽最大努力发出这些事件。事件将近乎实时传输到 EventBridge。您可以使用 EventBridge 创建触发编程操作以响应事件的规则。例如,您可以配置规则,以调用 SNS 主题发送电子邮件通知,或者调用 Lambda 函数执行某些操作。有关更多信息,请参阅 Amazon EventBridge 用户指南

WorkSpaces 访问事件

WorkSpaces 客户端应用程序在用户成功登录 WorkSpace 时发送 WorkSpaces Access 事件。所有 WorkSpaces 客户端都发送这些事件。

使用 DCV 为 WorkSpaces 发出的事件需要 WorkSpaces 客户端应用程序 4.0.1 或更高版本。

事件表示为 JSON 对象。以下是 WorkSpaces Access 事件的示例数据。

{ "version": "0", "id": "64ca0eda-9751-dc55-c41a-1bd50b4fc9b7", "detail-type": "WorkSpaces Access", "source": "aws.workspaces", "account": "123456789012", "time": "2023-04-05T16:13:59Z", "region": "us-east-1", "resources": [], "detail": { "clientIpAddress": "192.0.2.3", "actionType": "successfulLogin", "workspacesClientProductName": "WorkSpacesWebClient", "loginTime": "2023-04-05T16:13:37.603Z", "clientPlatform": "Windows", "directoryId": "domain/d-123456789", "clientVersion": "5.7.0.3472", "workspaceId": "ws-xyskdga" } }
特定于事件的字段
clientIpAddress

客户端应用程序的 WAN IP 地址。对于 PCoIP 零客户端,这是 Teradici 身份验证客户端的 IP 地址。

actionType

此值始终为 successfulLogin

workspacesClientProductName

以下值区分大小写。

  • WorkSpaces Desktop client - Windows、macOS 和 Linux 客户端

  • Amazon WorkSpaces Mobile client - iOS 客户端

  • WorkSpaces Mobile Client - Android 客户端

  • WorkSpacesWebClient - Web Access 客户端

  • AmazonWorkSpacesThinClient - Amazon WorkSpaces 瘦客户端设备

  • Teradici PCoIP Zero Client, Teradici PCoIP Desktop Client, or Dell Wyse PCoIP Client - 零客户端

loginTime

登录 WorkSpace 的时间。

clientPlatform
  • Android

  • iOS

  • Linux

  • OSX

  • Windows

  • Teradici PCoIP Zero Client and Tera2

  • Web

directoryId

WorkSpace 的目录的标识符。必须在目录标识符前面加上 domain/。例如 "domain/d-123456789"

clientVersion

用于连接 WorkSpaces 的客户端版本。

workspaceId

WorkSpace 的标识符。

创建一个规则来处理 WorkSpaces 事件

使用以下过程创建一个 规则来处理 WorkSpaces 事件。

先决条件

要接收电子邮件通知,请创建 Amazon Simple Notification Service 主题。

  1. 通过 https://console.aws.amazon.com/sns/v3/home 打开 Amazon SNS 控制台。

  2. 在导航窗格中,选择 Topics(主题)

  3. 选择创建主题

  4. 对于类型,选择标准

  5. 对于 Name(名称),请为主题输入一个名称。

  6. 选择创建主题

  7. 选择创建订阅

  8. 对于协议,选择电子邮件

  9. 对于 Endpoint(端点),请输入接收通知的电子邮件地址。

  10. 选择创建订阅

  11. 您将收到电子邮件消息,其主题行为:Amazon Notification - Subscription Confirmation。请按照说明确认订阅。

创建一个规则来处理 WorkSpaces 事件
  1. 打开位于 https://console.aws.amazon.com/events/ 的 Amazon EventBridge 控制台。

  2. 选择 Create rule (创建规则)

  3. 对于 Name(名称),请为规则输入一个名称。

  4. 对于规则类型,选择具有事件模式的规则

  5. 选择下一步

  6. 对于 Event pattern(事件模式),执行以下操作:

    1. 对于事件源,选择 Amazon Web Services 服务

    2. 对于 Amazon Web Services 服务,选择 WorkSpaces

    3. 对于事件类型,选择 WorkSpaces 访问

    4. 默认情况下,我们会就每个事件发送通知。如果愿意,您可以创建一种事件模式来筛选特定客户端或 WorkSpaces 的事件。

  7. 选择下一步

  8. 按以下操作指定目标:

    1. 对于 Target types(目标类型),选择 Amazon Web Services 服务

    2. 对于 Select a target(选择一个目标),选择 SNS topic(SNS 主题)。

    3. 对于主题,选择您为通知创建的 SNS 主题。

  9. 选择下一步

  10. (可选)向规则添加标签。

  11. 选择下一步

  12. 选择创建规则