本指南记录了 2025 年 3 月 13 日发布的全新 AWS Wickr 管理控制台。有关经典版 AWS Wickr 管理控制台的文档，请参阅[经典管理指南](https://docs.aws.amazon.com/wickr/latest/adminguide-classic/what-is-wickr.html)。

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 为你的 Wickr 网络举办的亚马逊 SNS 活动
<a name="sns-events"></a>

以下事件发布到由使用 `WICKRIO_SNS_TOPIC_ARN` 环境变量或 `sns_topic_arn` Secrets Manager 密钥值识别的 Amazon 资源名称（ARN）值定义的 Amazon SNS 主题。有关更多信息，请参阅[在 AWS Wickr 中配置数据保留机器人的环境变量](data-retention-bot-env-variables.md)和[AWS Wickr 的 Secrets Manager 值](data-retention-aws-secret-values.md)。

数据留存机器人生成的事件以 JSON 字符串的形式发送。从 5.116 版的数据留存机器人起，这些事件中包含以下值。


| Name | 值 | 
| --- | --- | 
| complianceBot | 数据留存机器人的用户名。 | 
| dataTime | 事件发生时的日期和时间。 | 
| 设备 | 对特定机器人设备或实例的描述。在运行多个机器人实例时很有用。 | 
| dockerImage | 与机器人关联的 Docker 映像。 | 
| dockerTag | Docker 映像的标签或版本。 | 
| message | 事件消息。有关更多信息，请参阅[关键事件](#sns-critical-events)和[正常事件](#sns-normal-events)。 | 
| notificationType | 这个值将是 `Bot Event`。 | 
| severity | 事件的严重性。可以是 `normal` 或 `critical`。 | 

必须订阅 Amazon SNS 主题才能接收事件。如果您使用电子邮件地址进行订阅，则系统会向您发送一封包含类似于以下示例的信息的电子邮件。

```
{
"complianceBot": "compliance_1234567890_bot",
 "dateTime": "2022-10-12T13:05:39",
 "device": "Desktop 1234567890ab",
 "dockerImage": "public.ecr.aws/x3s2s6k3/wickrio/bot-compliance-cloud",
 "dockerTag": "5.116.13.01",
 "message": "Logged in",
 "notificationType": "Bot Event",
 "severity": "normal"
}
```

## 关键事件
<a name="sns-critical-events"></a>

这些事件将导致机器人停止或重启。重启次数受到限制，以免导致其他问题。

**登录失败**

以下是机器人登录失败时可能生成的事件。每条消息都会指出登录失败的原因。


| 事件类型 | 事件消息 | 
| --- | --- | 
| failedlogin | 凭证不正确。检查密码。 | 
| failedlogin | 未找到用户。 | 
| failedlogin | 账户或设备已被暂停。 | 
| 预置 | 用户退出命令。 | 
| 预置 | `config.wickr` 文件的密码不正确。 | 
| 预置 | 无法读取 `config.wickr` 文件。 | 
| failedlogin | 登录全部失败。 | 
| failedlogin | 新用户但数据库已存在。 | 

**更多关键事件**


| 事件类型 | 事件消息 | 
| --- | --- | 
| 账户暂停 | WickrIOClientMain:: slotAdminUserSuspend: 代码 (%1)：原因：%2” | 
| BotDevice 已暂停 | 设备已暂停！ | 
| WatchDog |  SwitchBoard 系统停机时间超过 < {{N}} > 分钟 | 
| S3 失败 | 无法将文件 < {{file-name}} ≫ 放在 S3 存储桶上。错误：< {{AWS-error}} > | 
| 回退键 | 服务器提交的回退键：不是已识别客户端活跃回退键。请向桌面工程部门提交日志。 | 

## 正常事件
<a name="sns-normal-events"></a>

以下是警告您发生正常操作的事件。在特定时间段内出现过多此类事件可能是担忧的原因。

**设备已添加到账户**

此事件在向数据留存机器人账户添加新设备时生成。在某些情况下，这可能是一个重要迹象，表明有人已创建数据留存机器人实例。以下是此事件的消息。

```
A device has been added to this account!
```

**机器人已登录**

此事件在机器人已成功登录时生成。以下是此事件的消息。

```
Logged in
```

**正在关闭**

此事件在机器人正在关闭时生成。如果用户没有明确发起此操作，则可能表示存在问题。以下是此事件的消息。

```
Shutting down
```

**有更新可用**

此事件在数据留存机器人启动时生成，它表明关联的 Docker 映像有更新的版本可用。此事件在机器人启动时生成，并且每天都会生成。此事件包括用于识别可用新版本的 `versions` 数组字段。以下为此事件具体形式的示例。

```
{
  "complianceBot": "compliance_1234567890_bot",
  "dateTime": "2022-10-12T13:05:55",
  "device": "Desktop 1234567890ab",
  "dockerImage": "public.ecr.aws/x3s2s6k3/wickrio/bot-compliance-cloud",
  "dockerTag": "5.116.13.01",
  "message": "There are updates available",
  "notificationType": "Bot Event",
  "severity": "normal",
  "versions": [
    "5.116.10.01"
  ]
}
```