View a markdown version of this page

パスワード復旧手順 - AWS Wickr
概要パスワード復旧キーポリシーPython スクリプトガイドWindowsmacOSLinux

このガイドでは、2025 年 3 月 13 日にリリースされた新しい AWS Wickr 管理コンソールについて説明します。AWS Wickr 管理コンソールのクラシックバージョンのドキュメントについては、「 Classic Administration Guide」を参照してください。

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

パスワード復旧手順

概要

データ保持アカウントの生成フロー中に、サービスが既に設定されたデータ保持ボットを検出し、サーバーレスデータ保持がない場合、パスワード収集スクリプト (collect.py) が S3 バケットにアップロードされます。このスクリプトをローカルでダウンロードして実行し、Wickr データ保持パスワードを指定して、サービスがボットの ID を回復できるようにする必要があります。

スクリプトを実行する前に、IAM ロールまたはユーザーにパスワード復旧キーと S3 バケットに対する必要なアクセス許可があることを確認します。アクセスを設定するには、以下のパスワード復旧キーポリシーセクションを参照してください。

パスワード復旧キーポリシー

パスワード復旧スクリプトを実行するには、そのスクリプトを実行する IAM プリンシパルに次のアクセス許可が必要です。

  • パスワード復旧キーの kms:GetPublicKey

  • DRS S3 バケットの S3:PutObject

リソース ARNs の検索

パスワード復旧キーが製品によって生成された場合は、Service Catalog 出力でキー ARN を見つけることができます。

  1. AWS Service Catalog コンソールを開く

  2. プロビジョニング済み製品に移動します。

  3. Wickr データ保持製品を選択します。

  4. [Outputs (出力)] タブをクリックします。

  5. PasswordRecoveryKeyArn 出力を見つけます。

  6. 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 から最新の Python インストーラをダウンロードします。Python 3.10 以降では、「Windows インストーラ (64 ビット）」を選択します。

  2. インストーラーを実行します。Install Now を選択する前に、最初の画面の下部にある python.exe を PATH に追加するチェックボックスをオンにします。

  3. コマンドプロンプトまたは PowerShell を開いて、インストールを確認します。

    python --version

    Python 3.10.x またはそれ以降の出力が表示されます。

  4. 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 .

  2. zip ファイルを抽出します。

    Expand-Archive -Path collect.zip -DestinationPath .

  3. (オプション) スクリプトチェックサムが 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 から macOS インストーラをダウンロードします。Python 3.10 以降を選択します。

  2. .pkg インストーラを実行し、プロンプトに従います。

  3. 検証:

    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 .

  2. zip ファイルを抽出します。

    unzip collect.zip

  3. (オプション) スクリプトチェックサムを確認します。

    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 .

  2. zip ファイルを抽出します。

    unzip collect.zip

    がインストールされunzipていない場合: sudo apt install unzip (Debian/Ubuntu) または sudo dnf install unzip (Fedora/RHEL/AL2023)。

  3. (オプション) スクリプトチェックサムを確認します。

    sha256sum collect.py

    想定される sha256sum の結果は次のとおりです。

    31c5c85ec16587fbc284ed963bc0cae3723713ea9cb54a2cdc3941726bcc662a

    出力を Wickr AWS コンソールに表示されるチェックサムと比較します。

スクリプトの実行

python3 collect.py

正常に完了したら、ローカルファイルを削除します。

rm collect.py config.json collect.zip