AWS CLI のプロファイルをスマホへ
~/.aws/config を QR コードに変換
貼り付けるのは config だけにし、~/.aws/credentials は絶対に貼り付けないでください。テキストはこのタブ内にとどまり、アップロードはなく、ページはリクエストを送信しません。
プロファイルが見つかりません。[profile …] 行を含む ~/.aws/config の内容を貼り付けたか確認してください。
スマホで CloudConsole を開き、Account → Add account → Scan setup QR に進むか、カメラアプリをコードに向けます。その後、アクセスポータルごとに 1 回サインインを承認します。
[default] region = eu-west-2 [sso-session acme] sso_start_url = https://acme.awsapps.com/start sso_region = eu-west-2 sso_registration_scopes = sso:account:access [profile prod] sso_session = acme sso_account_id = 111122223333 sso_role_name = ReadOnly region = eu-west-2 [profile staging] sso_session = acme sso_account_id = 444455556666 sso_role_name = AdministratorAccess region = us-east-1 [profile prod-deploy] role_arn = arn:aws:iam::111122223333:role/Deploy source_profile = prod [profile old-laptop-user] aws_access_key_id = AKIAIOSFODNN7EXAMPLE aws_secret_access_key = wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY region = us-east-1
上に ~/.aws/config を貼り付け、必要なプロファイルにチェックを入れ、CloudConsole で QR コードを読み取ります。SSO とロールのプロファイル(スタート URL、アカウント、ロール、リージョン、ロール ARN、ソースプロファイル、外部 ID)がスマホに移ります。キーは移らず、スマホでは自分の ID でサインインします。
移るものと移らないもの
AWS CLI は 2 つのファイルを使います。~/.aws/config は認証情報をどこから得るか(IAM Identity Center のセッション、アカウント ID、ロール、リージョン)を示し、~/.aws/credentials は認証情報そのもの(アクセスキーとセッショントークン)を保持します。このツールが読むのは前者の情報だけです。
| config の内容 | スマホに移るか |
|---|---|
sso_start_url、sso_region を含む [sso-session] | はい:それを使うすべてのプロファイルで 1 回のサインイン |
sso_account_id, sso_role_name, region | はい:サインイン直後にアカウントが追加されます |
旧形式の SSO プロファイル(プロファイル内に sso_start_url) | あり |
role_arn + source_profile (+ external_id) | はい、ロールチェーンも含めて |
aws_access_key_id, aws_secret_access_key, aws_session_token | いいえ:警告を表示して除外 |
credential_process, credential_source, web_identity_token_file | いいえ:ノート PC や AWS のコンピューティングに依存するため |
QR コードの仕組み
選んだプロファイルは短いテンプレートの一覧として書き出され、圧縮されて、cloudconsole.dev/connect リンクの # の後ろに置かれます。ブラウザはリンクのこの部分をサーバーに送信しないため、リンクをブラウザで開いてもプロファイルは端末内にとどまります。QR コードはこのページに組み込まれた小さなエンコーダーで描画され、外部の QR サービスは呼び出しません。
CloudConsole はコードを読み取ると、まずすべてのアカウントとロールを表示するので、不要なものはチェックを外せます。同じアクセスポータルのプロファイルは 1 回のサインインを共有し、ロールは引き受け元のプロファイルの後に追加されます。引き受け元がコードに含まれていないロールには印が付き、代わりにアプリにすでにあるアカウントを選べます。
よくある質問
ここに AWS の config を貼り付けても安全ですか?
このページにはサーバー側がありません。テキストはこのタブ内の JavaScript が読み取り、アップロードされることはなく、読み込み後のページはネットワークリクエストを送りません(念のため先にオフラインにしても構いません)。~/.aws/config には通常シークレットは含まれず、サインイン先だけが書かれています。それでもキーが見つかった場合、ツールはそれを QR コードから除外し、その旨を表示します。
~/.aws/credentials はどうですか?
貼り付けないでください。このファイルにはアクセスキーが含まれており、QR コードで移すのは不適切です。画面を見た人なら誰でもコピーできてしまいます。このツールが QR コードにキーを入れることはありません。IAM ユーザーの場合は、アプリの Access keys 画面でキーを入力するか、より良い方法として IAM Identity Center(AWS SSO)を使い、スマホに長期キーを置かないようにしてください。
どのプロファイルを移せますか?
IAM Identity Center(SSO)のプロファイル(現在 aws configure sso が書き出す sso-session 形式と、プロファイル内に sso_start_url を持つ旧形式の両方)と、role_arn と source_profile を使うロールプロファイル(external_id やロールチェーンを含む)です。アクセスキー、credential_process、credential_source、ウェブ ID トークンを使うプロファイルはノート PC に残ります。
スマホでもサインインが必要ですか?
はい。QR コードが示すのは、どこにサインインし、どのアカウント、ロール、リージョンを使うかだけです。その後 CloudConsole が、aws sso login と同じように、アクセスポータルごとに 1 回ブラウザでのサインイン承認を求めます。あなた自身の AWS ID にできないことは何もできません。
QR コードをチームで共有できますか?
はい、そのためのものです。シークレットを含まないので、チームの Wiki ページに載せれば、全員が同じアカウント、ロール、リージョンを使えます。サインインは各自が自分の ID で行います。
選択が大きすぎると表示されるのはなぜですか?
1 つの QR コードに入るのは約 2,300 文字です。いくつかのプロファイルのチェックを外して 2 つのコードに分けるか、代わりにリンクをコピーしてください。リンクには実質的にこの上限がありません。密度の高いコードは画面から読み取るのにも時間がかかるので、1 つのコードのプロファイルを減らすと速く読み取れます。
CloudConsole は AWS CLI と同様に IAM Identity Center でサインインし、トークンをスマホのセキュアストレージに保存して、AWS と直接通信します。すべてのアカウントとリージョンのアラーム、ログ、コスト、リソースを確認できます。
アプリについて →