CloudConsole

チームでCloudConsoleを使えるようにする

管理者向け:チームのアカウントとロールをまとめたセットアップリンクやQRコードを作り、普段は読み取り専用のロール、変更には別のロールを使う方法。

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

セットアップQRをスキャンしたあとにチームのメンバーに表示される画面
チームのメンバーに表示される画面

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営業日以内にご返信します。