チームでCloudConsoleを使えるようにする
管理者向け:チームのアカウントとロールをまとめたセットアップリンクやQRコードを作り、普段は読み取り専用のロール、変更には別のロールを使う方法。
チームの複数のメンバーがCloudConsoleを使う場合は、スタートURL、アカウントID、ロール名の一覧の代わりに、1つのセットアップリンクまたはQRコードを渡しましょう。各メンバーはそれをスキャンするか開き、アクセスポータルごとに1回サインインを承認するだけで、同じアカウント、ロール、リージョンを使えます。リンクには秘密情報が含まれないので、社内wikiに載せておけます。

1. ~/.aws/configからリンクを作る
チームで使うプロファイルがAWS CLIの設定にすでにあるなら、無料のAWS config to QRツールに貼り付けます。ツールはブラウザの中で動作し、IAM Identity Centerのプロファイル(sso-sessionと古い形式の両方)とロールのプロファイル(role_arn + source_profile、external_idや連鎖を含む)を取り込み、見つかったキーは除外します。チームに不要なもののチェックを外してから、リンクをコピーするかQRコードを保存します。
2. 手作業で作る
セットアップリンクは、https://cloudconsole.dev/connect#v1.のあとにJSONのリストを続けたもので、raw deflateで圧縮し、パディングなしのbase64urlで表記します。リストの各項目はSSOアカウントかロールです。例:
[{"t":"sso","k":"prod","u":"https://acme.awsapps.com/start","sr":"eu-west-2",
"a":"111122223333","n":"acme-prod","ro":"CloudConsoleReadOnly","r":"eu-west-2"},
{"t":"role","k":"prod-operator","arn":"arn:aws:iam::111122223333:role/Operator",
"src":"prod","x":"acme-oncall","r":"eu-west-2"}]
- sso:
u(スタートURL)とsr(Identity Centerのリージョン)は必須です。a(アカウントID)とro(ロール名)はセットで指定します。両方を省略すると、サインイン後に各自が選べます。nはアプリに表示されるアカウント名、rは開くリージョン、kはプロファイル名です。 - role:
arnとsrcは必須です。srcは別の項目のkか、その人のアプリにすでにあるアカウントの名前です。xは外部IDです。
このリストを入れたファイルteam.jsonをリンクにするには:
python3 -c 'import json,sys,zlib,base64
d=json.dumps(json.load(open(sys.argv[1])),separators=(",",":")).encode()
c=zlib.compressobj(9,zlib.DEFLATED,-15); z=c.compress(d)+c.flush()
print("https://cloudconsole.dev/connect#v1."+base64.urlsafe_b64encode(z).decode().rstrip("="))' team.json
リンクをブラウザで開いて確認しましょう。/connect (EN)ページに、追加される内容か、問題点が表示されます。各フィールドの値はキーやシークレットのように見えてはいけません。そう見える値があると、リンク全体が拒否されます。
3. 読み取り専用のロールと、変更用の別のロール
全員に、日々の確認用の読み取り専用ロールと、スマホから行ってよい変更のための別のロールを用意しましょう。
- 読み取り専用:AWS管理ポリシー
ReadOnlyAccess、または推奨する権限にある、より絞り込んだCloudConsoleのポリシーを使ったIAM Identity Centerの許可セット。 - 変更用:変更に必要な権限のうち、チームがオンコール中に使うべき操作だけを持つ2つ目の許可セット(または1つ目から引き受けるロール)。可能な範囲でリソースを絞り込み、タグの条件を追加しましょう。
両方をリンクに含めます。たとえば、読み取り専用ロールのprodと、変更用ロールのprod-operatorです。変更用アカウントのガードレールを、アプリでTyped + Face IDに設定するようメンバーに依頼してください(ガードレール)。ガードレールや読み取り専用の設定は、リンクでは指定できません。
4. 共有する
リンクとQRコードを、アプリのインストール方法と並べてwikiやランブックに載せます。パソコンの画面に表示したQRコードはScan setup QRで読み取れ、スマホではリンクをタップするだけです。1つのQRコードに入るのは約2,300文字なので、プロファイルが多い場合はリンクを共有するか、コードを2つに分けてください。
アプリから変更を行うには、変更を行う人それぞれにCloudConsole Proが必要です。1つのアカウントの閲覧は無料です。無料版とProをご覧ください。
よくある質問
共有のIAMユーザーのアクセスキーをリンクに含められますか?
いいえ。リンクに認証情報が含まれることはなく、キーやシークレットのように見えるものを含むリンクはアプリが拒否します。IAM Identity Centerを使うか、各自に自分のキーを追加してもらってください。
リンクを変更するとどうなりますか?
古いリンクをすでに使ったスマホでは何も変わりません。メンバーは新しいリンクを開き、すでにあるもののチェックを外します。アカウントとロールが同じ項目は、重複せずに置き換えられます。
リンクでガードレールや読み取り専用を設定できますか?
いいえ。それらは各スマホでアカウントごとに、Account → Accounts → 設定アイコンで設定します。
試したことと、アプリに表示されたメッセージを添えて[email protected]までメールでお問い合わせください。アクセスキーやシークレットは送らないでください。2営業日以内にご返信します。