本指南記載於 2025 年 3 月 13 日發行的新 AWS Wickr 管理主控台。如需 AWS Wickr 管理主控台傳統版本的文件，請參閱[傳統管理指南](https://docs.aws.amazon.com/wickr/latest/adminguide-classic/what-is-wickr.html)。

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# AWS Wickr 中資料保留機器人的密碼
<a name="data-retention-password"></a>

第一次啟動資料保留機器人時，您可以使用下列其中一個選項來指定初始密碼：
+ `WICKRIO_BOT_PASSWORD` 環境變數。本指南稍後的 [在 AWS Wickr 中設定資料保留機器人的環境變數](data-retention-bot-env-variables.md)一節概述了資料保留機器人環境變數。
+ `AWS_SECRET_NAME` 環境變數在 Secrets Manager 中識別**的密碼**值。本指南稍後的 [AWS Wickr 的 Secrets Manager 值](data-retention-aws-secret-values.md)一節概述了資料保留機器人的 Secrets Manager 值。
+ 在資料保留機器人提示時輸入密碼。您將需要使用 `-ti`選項搭配互動式 TTY 存取來執行資料保留機器人。

第一次設定資料保留機器人時，會產生新密碼。如果您需要重新安裝資料保留機器人，請使用產生的密碼。初始密碼在初始安裝資料保留機器人之後無效。您可以輪換產生的密碼。若要輪換產生的密碼，請使用下列各節中提供的指引。

## 密碼輪換
<a name="password-rotation"></a>

資料保留機器人 （最低版本 6.66.01.00) 可以在啟動時透過設定 WICKRIO\_ROTATE\_PASSWORD 環境變數，以程式設計方式輪換其 Wickr 帳戶密碼。

## Usage
<a name="usage"></a>

使用 docker 執行啟動機器人時，設定環境變數 WICKRIO\_ROTATE\_PASSWORD：

 `-e WICKRIO_ROTATE_PASSWORD="{{new_password}}" ` 

啟動時，機器人成功使用其目前密碼 （來自 WICKRIO\_BOT\_PASSWORD 或 AWS Secrets Manager) 登入後，會執行下列動作：

1. 從程序環境讀取 WICKRIO\_ROTATE\_PASSWORD。

1. 驗證新密碼 （最少 12 個字元，必須與目前的密碼不同）。

1. 呼叫 AWS Wickr 服務來輪換密碼。

輪換成功後，在下次重新啟動之前，請將 WICKRIO\_BOT\_PASSWORD （或 Secrets Manager 中的 AWS 秘密） 更新為新密碼。

新產生的密碼會顯示如下範例所示。

**重要**  
將密碼儲存於安全處。如果您遺失密碼，您將無法重新安裝資料保留機器人。請勿共用此密碼。它可讓您開始 Wickr 網路的資料保留。

```
********************************************************************
**** GENERATED PASSWORD
**** DO NOT LOSE THIS PASSWORD, YOU WILL NEED TO ENTER IT EVERY TIME
**** TO START THE BOT
 "HuEXAMPLERAW4lGgEXAMPLEn"
 ********************************************************************
```

## 密碼要求
<a name="password-requirements"></a>
+  新密碼必須至少為 12 個字元。
+  新密碼必須與目前的密碼不同。
+  機器人必須先能夠使用目前的密碼登入。