이 가이드는 2025년 3월 13일에 릴리스된 새로운 AWS Wickr 관리 콘솔을 문서화합니다. AWS Wickr 관리 콘솔의 클래식 버전에 대한 설명서는 [Classic 관리 안내서](https://docs.aws.amazon.com/wickr/latest/adminguide-classic/what-is-wickr.html)를 참조하세요.

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# Wickr 네트워크에 대한 Amazon SNS 이벤트
<a name="sns-events"></a>

다음 이벤트는 `WICKRIO_SNS_TOPIC_ARN`환경 변수 또는 Secrets Manager `sns_topic_arn` 비밀 값을 사용하여 식별된 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 버전부터 이벤트에 포함된 값은 다음과 같습니다.


| 이름 | 값 | 
| --- | --- | 
|  complianceBot  |  데이터 보존 봇의 사용자 이름.  | 
|  dataTime  |  이벤트가 발생한 날짜와 시간.  | 
|  디바이스  |  특정 봇 디바이스 또는 인스턴스에 대한 설명. 여러 봇 인스턴스를 실행하는 경우 유용합니다.  | 
|  dockerImage  |  봇과 관련된 도커 이미지.  | 
|  dockerTag  |  도커 이미지의 태그 또는 버전입니다.  | 
|  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": "wickr/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  |  계정 또는 기기가 일시 중지되었습니다.  | 
|  provisioning  |  사용자가 명령을 종료합니다.  | 
|  provisioning  |  `config.wickr`파일의 비밀번호가 잘못되었습니다.  | 
|  provisioning  |  `config.wickr`파일을 읽을 수 없습니다.  | 
|  failedlogin  |  로그인이 모두 실패했습니다.  | 
|  failedlogin  |  새 사용자이지만 데이터베이스가 이미 있습니다.  | 

**더 중요한 이벤트**


| 이벤트 유형 | 이벤트 메시지 | 
| --- | --- | 
|  일시 중지된 계정  |  WickrIOClientMain::slotAdminUserSuspend: code(%1): reason: %2“  | 
|  BotDevice Suspended  |  기기가 일시 중지되었습니다\$1  | 
|  WatchDog  |  SwitchBoard 시스템이 <*N*> 분 이상 다운되었습니다.  | 
|  S3 실패  |  S3 버킷에 파일 <*file-name*≫을 넣지 못했습니다. *오류: <AWS-error*>  | 
|  Fallback Key  |  서버에서 제출한 폴백 키: 인식된 클라이언트 활성 폴백 키가 아닙니다. 데스크탑 엔지니어링에 로그를 제출하십시오.  | 

## 일반 이벤트
<a name="sns-normal-events"></a>

다음은 정상 작동 발생에 대해 경고하는 이벤트입니다. 특정 기간 내에 이러한 유형의 이벤트가 너무 많이 발생하는 것은 우려의 원인이 될 수 있습니다.

**계정에 추가된 기기**

이 이벤트는 새 기기가 데이터 보존 봇 계정에 추가될 때 생성됩니다. 경우에 따라 이는 누군가가 데이터 보존 봇의 인스턴스를 생성했다는 중요한 표시일 수 있습니다. 다음은 이 이벤트의 메시지입니다.

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

**봇이 로그인**

이 이벤트는 봇이 성공적으로 로그인했을 때 생성됩니다. 다음은 이 이벤트의 메시지입니다.

```
Logged in
```

**시스템 종료**

이 이벤트는 봇이 종료될 때 생성됩니다. 사용자가 이를 명시적으로 시작하지 않았다면 문제가 있다는 신호일 수 있습니다. 다음은 이 이벤트의 메시지입니다.

```
Shutting down
```

**업데이트 사용 가능**

이 이벤트는 데이터 보존 봇이 시작될 때 생성되며 관련 도커 이미지의 최신 버전을 사용할 수 있음을 식별합니다. 이 이벤트는 봇이 시작될 때 매일 생성됩니다. 이 이벤트에는 사용 가능한 새 버전을 식별하는 `versions`배열 필드가 포함됩니다. 다음은 이 이벤트의 모습에 대한 예시입니다.

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