このガイドでは、2025 年 3 月 13 日にリリースされた新しい AWS Wickr 管理コンソールについて説明します。AWS Wickr 管理コンソールのクラシックバージョンのドキュメントについては、[「 Classic Administration Guide](https://docs.aws.amazon.com/wickr/latest/adminguide-classic/what-is-wickr.html)」を参照してください。 翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。 # パスワード復旧手順 ## 概要 データ保持アカウントの生成フロー中に、サービスが既に設定されたデータ保持ボットを検出し、サーバーレスデータ保持がない場合、パスワード収集スクリプト (`collect.py`) が S3 バケットにアップロードされます。このスクリプトをローカルでダウンロードして実行し、Wickr データ保持パスワードを指定して、サービスがボットの ID を回復できるようにする必要があります。 スクリプトを実行する前に、IAM ロールまたはユーザーにパスワード復旧キーと S3 バケットに対する必要なアクセス許可があることを確認します。アクセスを設定するには、以下のパスワード復旧キーポリシーセクションを参照してください。 ## パスワード復旧キーポリシー パスワード復旧スクリプトを実行するには、そのスクリプトを実行する IAM プリンシパルに次のアクセス許可が必要です。 + パスワード復旧キーの kms:GetPublicKey + DRS S3 バケットの S3:PutObject ### リソース ARNs の検索 パスワード復旧キーが製品によって生成された場合は、Service Catalog 出力でキー ARN を見つけることができます。 1. AWS Service Catalog コンソールを開く 1. プロビジョニング済み製品に移動します。 1. Wickr データ保持製品を選択します。 1. [**Outputs (出力)**] タブをクリックします。 1. **PasswordRecoveryKeyArn** 出力を見つけます。 1. **RetentionBucketName** 出力を見つけます。 ### 必要なアクセス許可の追加 パスワード復旧 KMS キーポリシーに次のステートメントを追加します。{your-role-or-user-arn} を、スクリプトを実行する IAM ロールまたはユーザーの ARN に置き換えます。 ``` { "Sid": "PasswordRecoveryScriptAccess", "Effect": "Allow", "Principal": { "AWS": "{your-role-or-user-arn}" }, "Action": "kms:GetPublicKey", "Resource": "*" } ``` 同じプリンシパルには、データ保持 DRS S3 バケットに S3:PutObject も必要です。ロールまたはユーザーにアタッチされた IAM ID ポリシーを使用してこれを付与します。 **注記** パスワード復旧キーは、Docker-bot データ保持下で以前に暗号化されたデータを移行する場合にのみ使用されます。 ## Python スクリプトガイド スクリプトには以下が必要です。 + Python 3.8 以降 (3.10 以降を推奨) + pip (Python パッケージマネージャー、Python 3.4 以降に付属) + 2 つの Python パッケージ: `boto3`と `cryptography` + AWS DRS KMS キーと S3 バケットへのアクセスで設定された 認証情報 ## Windows ### Python のインストール 1. [python.org](https://www.python.org) から最新の Python インストーラをダウンロードします。Python 3.10 以降では、「Windows インストーラ (64 ビット）」を選択します。 1. インストーラーを実行します。Install **Now** を選択する前に、最初の画面の下部にある **python.exe を PATH に追加する**チェックボックスをオンにします。 1. コマンドプロンプトまたは PowerShell を開いて、インストールを確認します。 ``` python --version ``` `Python 3.10.x` またはそれ以降の出力が表示されます。 1. pip が使用可能であることを確認します。 ``` pip --version ``` ### 依存関係のインストール コマンドプロンプトまたは PowerShell を開き、以下を実行します。 ``` pip install boto3 cryptography ``` ### AWS 認証情報を設定する AWS 認証情報が設定されていることを確認します。最も簡単な方法は、 CLI AWS を使用することです。 ``` aws configure ``` アクセスキー ID、シークレットアクセスキー、デフォルトリージョンを指定します。認証情報には次のものが必要です。 + `kms:GetPublicKey` DRS パスワード復旧キー + `s3:PutObject` DRS S3 バケットの + `s3:GetObject` DRS S3 バケットで (スクリプトをダウンロードするには) ### スクリプトをダウンロードして抽出する 1. S3 バケットから zip ファイルをダウンロードします。 ``` aws s3 cp s3://{{your-bucket}}/wickr-drs-password-tool/collect.zip . ``` 1. zip ファイルを抽出します。 ``` Expand-Archive -Path collect.zip -DestinationPath . ``` 1. (オプション) スクリプトチェックサムが Wickr AWS コンソールに表示される値と一致することを確認します。 ``` certutil -hashfile collect.py SHA256 ``` 予想されるハッシュファイルの結果は次のとおりです。 ``` 31c5c85ec16587fbc284ed963bc0cae3723713ea9cb54a2cdc3941726bcc662a ``` ### スクリプトの実行 ``` python collect.py ``` 正常に完了したら、ローカルファイルを削除します。 ``` del collect.py config.json collect.zip ``` ## macOS ### Python のインストール macOS にはシステム Python が付属していますが、古い場合があります。次のいずれかの方法を使用して、最新バージョンをインストールします。 **オプション A: 公式インストーラ (最もシンプル)** 1. [python.org](https://www.python.org) から macOS インストーラをダウンロードします。Python 3.10 以降を選択します。 1. `.pkg` インストーラを実行し、プロンプトに従います。 1. 検証: ``` python3 --version ``` **オプション B: Homebrew** Homebrew がインストールされている場合: ``` brew install python@3.12 ``` 検証: ``` python3 --version ``` ### 依存関係のインストール ``` pip3 install boto3 cryptography ``` アクセス許可エラーが発生した場合は、以下を使用します。 ``` pip3 install --user boto3 cryptography ``` ### AWS 認証情報を設定する ``` aws configure ``` アクセスキー ID、シークレットアクセスキー、デフォルトリージョンを指定します。認証情報には次のものが必要です。 + `kms:GetPublicKey` DRS パスワード復旧キー + `s3:PutObject` DRS S3 バケットの + `s3:GetObject` DRS S3 バケットで (スクリプトをダウンロードするには) ### スクリプトをダウンロードして抽出する 1. S3 バケットから zip ファイルをダウンロードします。 ``` aws s3 cp s3://{{your-bucket}}/wickr-drs-password-tool/collect.zip . ``` 1. zip ファイルを抽出します。 ``` unzip collect.zip ``` 1. (オプション) スクリプトチェックサムを確認します。 ``` shasum -a 256 collect.py ``` 想定されるシャサムの結果は次のとおりです。 ``` 31c5c85ec16587fbc284ed963bc0cae3723713ea9cb54a2cdc3941726bcc662a ``` 出力を Wickr AWS コンソールに表示されるチェックサムと比較します。 ### スクリプトの実行 ``` python3 collect.py ``` 正常に完了したら、ローカルファイルを削除します。 ``` rm collect.py config.json collect.zip ``` ## Linux ### Python のインストール ほとんどの Linux ディストリビューションには Python 3 が含まれています。現在のバージョンを確認します。 ``` python3 --version ``` Python がインストールされていない場合、または 3.8 を下回っている場合は、ディストリビューションのパッケージマネージャーを使用してインストールします。 **Ubuntu/Debian** ``` sudo apt update sudo apt install python3 python3-pip ``` **Amazon Linux 2023 / Fedora / RHEL 9\+** ``` sudo dnf install python3 python3-pip ``` **Amazon Linux 2 / RHEL 7-8 / CentOS 7-8** ``` sudo yum install python3 python3-pip ``` 検証: ``` python3 --version pip3 --version ``` ### 依存関係のインストール ``` pip3 install boto3 cryptography ``` アクセス許可エラーが発生した場合は、以下を使用します。 ``` pip3 install --user boto3 cryptography ``` ### AWS 認証情報を設定する ``` aws configure ``` アクセスキー ID、シークレットアクセスキー、デフォルトリージョンを指定します。認証情報には次のものが必要です。 + `kms:GetPublicKey` DRS パスワード復旧キー + `s3:PutObject` DRS S3 バケットの + `s3:GetObject` DRS S3 バケットで (スクリプトをダウンロードするには) ### スクリプトをダウンロードして抽出する 1. S3 バケットから zip ファイルをダウンロードします。 ``` aws s3 cp s3://{{your-bucket}}/wickr-drs-password-tool/collect.zip . ``` 1. zip ファイルを抽出します。 ``` unzip collect.zip ``` がインストールされ`unzip`ていない場合: `sudo apt install unzip` (Debian/Ubuntu) または `sudo dnf install unzip` (Fedora/RHEL/AL2023)。 1. (オプション) スクリプトチェックサムを確認します。 ``` sha256sum collect.py ``` 想定される sha256sum の結果は次のとおりです。 ``` 31c5c85ec16587fbc284ed963bc0cae3723713ea9cb54a2cdc3941726bcc662a ``` 出力を Wickr AWS コンソールに表示されるチェックサムと比較します。 ### スクリプトの実行 ``` python3 collect.py ``` 正常に完了したら、ローカルファイルを削除します。 ``` rm collect.py config.json collect.zip ```