IAM Identity Center(AWS SSO)でサインインする
AWSアクセスポータルのURLを入力すると、アプリがリージョンを見つけてサインインコードを表示します。ブラウザで承認し、アカウントとロールを選びます(複数可)。
推奨のサインイン方法です。アプリはaws sso login --use-device-codeと同じ方法で、選んだアカウントとロールの一時的な認証情報を取得するため、スマホに長期のキーが残りません。


手順
- ウェルカム画面でConnect with AWS SSOをタップするか、Account → Add account → AWS SSO (IAM Identity Center)を開きます。画面名はConnect with SSOです。
- Start URLを入力します。ノートPCでサインインするときのAWSアクセスポータルのアドレスで、たとえば
https://my-org.awsapps.com/startです。https://と/startは省略できます。 - Regionsはそのまま(Automatic: found from your portal URL)にします。リージョンを自分で選びたい場合だけChangeをタップします。
- Continueをタップします。アプリがポータルを調べている間、ボタンにはFinding your region…と表示されます。
- Your sign-in codeが表示されます。Open AWS sign-inをタップすると、アプリがコードをコピーし、ブラウザでAWSのサインインページを開きます。ページに同じコードが表示されていることを確認し、求められたらサインインして、アクセスを許可します。コードの入力を求められたら、貼り付けてください。
- CloudConsoleに戻ると、アプリが承認を自動で検知します(Waiting for approval…)。Choose accountsで、アカウントに許可セットが複数ある場合は、まず上部のPermission setを選びます。各許可セットが、それを持つアカウントの数(in N of M accounts)とともに一覧表示されます。初期値は、このポータルで前回使った許可セット、なければ
ReadOnlyAccessなどの読み取り専用のもの、それもなければ最も多いものです。次に1つ以上のアカウントにチェックを入れるか、Select allをタップしてその許可セットを持つすべてのアカウントにチェックを入れます。アカウントが6つを超える場合は検索ボックス(名前、ID、メールアドレス)が表示されます。チェックしたアカウントにはその許可セットが割り当てられます。許可セットを持たないアカウントにはNo <permission set> hereと表示され、チェックすると、ロールが1つだけならそのロール、それ以外は読み取り専用ロール、なければ最初のロールが割り当てられます。別のロールを選ぶには、アカウントの下のロールをタップします。 - Add N accountsをタップします。各アカウントはアプリ内でそれぞれ別の項目になり、すべてがこの1回のサインインを共有します。
リージョンの見つけ方
関係するリージョンは2つあります。IAM Identity Centerが設定されているSSO regionと、アプリが開くRegion for your resourcesです。Automaticの場合、アプリはポータルからSSOリージョンを読み取ります。新しい形式のポータルアドレスにはリージョンが含まれており(….portal.eu-west-2.app.aws)、awsapps.comのポータルではポータルのページからわかります。リソースのリージョンは最初は同じリージョンになり、サービス画面のリージョンのチップやアカウントの設定からいつでも切り替えられます。
アプリが判別できない場合は、2つの選択欄(SSO region (where Identity Center is set up)とRegion for your resources)と、次のメッセージが表示されます:"Couldn't tell this portal's region. Pick the region IAM Identity Center is set up in (shown in the AWS console under IAM Identity Center → Settings)." AWS CLIをSSOで使っている場合は、~/.aws/configのsso_regionがそれです。自分で選んだリージョンが上書きされることはありません。
サインインを維持する
アプリは、aws sso loginがsso-sessionで行うのと同じようにリフレッシュトークンを登録し、スマホの安全なストレージに保存します。IAM Identity Centerのセッションが続く限り、ロールの認証情報をバックグラウンドで更新します。セッションの長さは管理者がIAM Identity Centerで設定するもので、数時間のことも数日のこともあります。接続が切れたりAWSが混み合ったりしてもサインアウトにはならず、AWSが更新を拒否したときだけサインアウトになります。
セッションが終了すると、各画面にSigned outとSign inボタンが表示されます。サインインし直しても、そのポータルから追加したアカウントはすべて残ります。サインアウトされた場合をご覧ください。
複数のアカウント
上の手順のとおり、1つのポータルから複数のアカウントをまとめて追加できます。アカウントを切り替えるには、Homeでアカウント名をタップします。切り替え画面ではアカウントがポータルごとにまとめて表示されます。各ポータルの下に、追加済みのアカウント、続いてそのポータルのほかのアカウントがAdd付きで並びます。それをタップすると、追加と切り替えが一度に行われます。使われるのはポータルの許可セット(複数ある場合はポータルのセクション上部にPermission set: …として表示され、タップで変更できます)か、アカウントの唯一のロールです。どちらでもなければ、どのロールを使うかアプリが尋ねます。切り替え画面はポータルのアカウント一覧をバックグラウンドで更新します(Updating…)。アカウントが6つを超えると検索ボックスが表示され、まだ追加していないアカウントも検索できます。
さらに複数のアカウントをまとめて選ぶ場合も、サインインし直す必要はありません。Add accountの最初の項目であるMore accounts from <your portal>、Accountsのリストの下にあるAdd accounts from <your portal>、またはSSOアカウントの設定にあるAdd more accounts from this portalを使います。アカウントの一覧がすぐに開き、追加済みのアカウントとロールにはチェックが付いています。IAM Identity Centerのセッションが終了している場合は、ここでも切り替え画面でも、先にサインインを求められます。
無料プランには1つのアカウントが含まれます。それより多くチェックすると、ボタンがAdd N accounts (Pro)になり、Proの画面が開きます。購読するとアカウントが追加されます。切り替え画面でまだ追加していないアカウントをタップした場合も、同じようにProの画面が開きます。Proなら上限はありません。
うまくいかない場合
- "Enter your AWS access portal URL, e.g. https://my-org.awsapps.com/start":Start URLが空か、ウェブアドレスになっていません。
- "Couldn't tell this portal's region…":上記のとおり、SSOリージョンを自分で選んでください。
- "Check the start URL and that IAM Identity Center is in …":URLの入力ミスか、SSOリージョンが間違っています。RegionsのChangeをタップして確認してください。
- "Sign-in was denied in the browser.":お客様(またはIDプロバイダー)がリクエストを拒否しました。Continueをタップしてやり直してください。
- "The sign-in code expired. Try again.":ブラウザでの手順に時間がかかりすぎました。Continueをタップして新しいコードを取得してください。
- ブラウザが開かなかった、または早く閉じてしまった場合:Open sign-in page againをタップします。
- アカウントが表示されない場合:どのアカウントでも許可セットが割り当てられていません。管理者に問い合わせてください。
よくある質問
aws sso loginと同じですか?
はい。CloudConsoleはaws sso login --use-device-codeと同じOAuthデバイス認可フローを使い、そのあとIAM Identity Centerに、選んだアカウントとロールの認証情報を要求します。
すべてのアカウントを一度に追加できますか?
はい。追加したいアカウントにチェックを入れるか、Select allを選ぶと、1回のサインインで追加されます。無料プランには1つのアカウントが含まれ、それ以上にはProが必要です。
毎日サインインする必要がありますか?
いいえ。アプリはaws sso loginと同じようにリフレッシュトークンを使い、IAM Identity Centerのセッションが終わるまで認証情報を更新します。その長さは管理者が設定します。
ブラウザが開く前にコードが表示されるのはなぜですか?
アクセスを許可する前に、AWSのページに同じコードが表示されているかを確認できるようにするためです。ページでコードの入力を求められた場合に備えて、Open AWS sign-inはコードのコピーも行います。
どの許可セットを使うべきですか?
普段使いには読み取り専用のものを使ってください。推奨する権限の記事に、すぐに使える許可セットがあります。
試したことと、アプリに表示されたメッセージを添えて[email protected]までメールでお問い合わせください。アクセスキーやシークレットは送らないでください。2営業日以内にご返信します。