CloudConsole

Sign in with IAM Identity Center (AWS SSO)

Enter your AWS access portal URL: the app finds the region, shows a sign-in code, and you approve in the browser and pick accounts and roles.

This is the recommended way in. The app gets short-lived credentials for the account and role you choose, the same way aws sso login --use-device-code does, so no long-lived keys sit on your phone.

Connect with SSO: start URL and a Regions row set to Automatic, with Change
1. Start URL; regions found for you
Your sign-in code QXVN-KTRB with an Open AWS sign-in button, waiting for approval
2. Check the code, open AWS sign-in

Steps

  1. Tap Connect with AWS SSO on the welcome screen, or Account → Add account → AWS SSO (IAM Identity Center). The screen is called Connect with SSO.
  2. Enter your Start URL: the AWS access portal address you sign in with on your laptop, for example https://my-org.awsapps.com/start. You can leave out https:// and /start.
  3. Leave Regions as it is (Automatic: found from your portal URL). Tap Change only if you want to pick the regions yourself.
  4. Tap Continue. While the app looks up your portal, the button says Finding your region….
  5. Your sign-in code appears. Tap Open AWS sign-in: the app copies the code and opens AWS's sign-in page in your browser. Check the page shows the same code, sign in if asked, and allow access. If the page asks you to type the code, paste it.
  6. Come back to CloudConsole: it notices the approval by itself (Waiting for approval…). Under Choose accounts, if your accounts have more than one permission set, choose the Permission set at the top first. It lists each one with how many accounts have it (in N of M accounts) and starts with the one you last used on this portal, otherwise a read-only one such as ReadOnlyAccess, otherwise the most common. Then tick one or more accounts, or tap Select all to tick every account that has that permission set. With more than six accounts there's a search box (name, ID or email). Ticked accounts get the permission set; an account without it shows No <permission set> here and, if you tick it, gets its only role, otherwise a read-only one, otherwise the first. Tap the role under an account to pick another.
  7. Tap Add N accounts. Each account becomes its own entry in the app, and they all share this one sign-in.

How the region is found

Two regions are involved: the SSO region, where IAM Identity Center is set up, and the Region for your resources, which the app opens in. With Automatic, the app reads the SSO region from your portal: newer portal addresses name it (….portal.eu-west-2.app.aws), and awsapps.com portals give it away in the portal page. Your resource region starts as the same region; switch it any time from the region chip on a service screen, or in the account's settings.

If the app can't tell, it shows both pickers (SSO region (where Identity Center is set up) and Region for your resources) with this message: "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)." If you use the AWS CLI with SSO, it's sso_region in ~/.aws/config. A region you pick yourself is never overwritten.

Staying signed in

The app registers for refresh tokens, the way aws sso login does with an sso-session, and keeps the token in the phone's secure storage. It renews your role credentials in the background for as long as your IAM Identity Center session lasts. Your administrator sets that length in IAM Identity Center, so it may be hours or days. A dropped connection or a busy AWS doesn't sign you out; only AWS refusing the refresh does.

When the session ends, screens show Signed out with a Sign in button. Signing in again keeps every account you added from that portal: see Signed out.

More than one account

You can add several accounts from a portal in one go, as above. To switch accounts, tap the account name on Home. The switcher groups accounts by portal: under each portal come the accounts you've added, then the portal's other accounts, marked Add. Tap one of those to add it and switch to it in one go. It uses the portal's permission set, shown at the top of the portal's section as Permission set: … when there's more than one (tap it to change it), or the account's only role; otherwise the app asks which role. The switcher updates the portal's account list in the background (Updating…). With more than six accounts there's a search box, which also finds accounts you haven't added.

To pick several more accounts at once, you don't need to sign in again: use More accounts from <your portal>, the first option in Add account, Add accounts from <your portal> under the list in Accounts, or Add more accounts from this portal in an SSO account's settings. The account list opens straight away; accounts and roles you've already added show a tick. If your IAM Identity Center session has ended, the app asks you to sign in first, here and in the switcher.

The free plan includes one account. If you tick more than that, the button says Add N accounts (Pro) and opens the Pro screen; after you subscribe, the accounts are added. Tapping an account you haven't added in the switcher opens the Pro screen the same way. With Pro there's no limit.

If it doesn't work

  • "Enter your AWS access portal URL, e.g. https://my-org.awsapps.com/start": the Start URL is empty or isn't a web address.
  • "Couldn't tell this portal's region…": pick the SSO region yourself, as above.
  • "Check the start URL and that IAM Identity Center is in …": the URL is mistyped, or the SSO region is wrong. Tap Change under Regions and check it.
  • "Sign-in was denied in the browser.": you (or your identity provider) refused the request. Tap Continue to start again.
  • "The sign-in code expired. Try again.": the browser step took too long. Tap Continue for a new code.
  • The browser didn't open, or you closed it too early: tap Open sign-in page again.
  • No accounts listed: you have no permission set assigned in any account. Ask your administrator.

Questions

Is this the same as aws sso login?

Yes. CloudConsole uses the same OAuth device authorisation flow as aws sso login --use-device-code, then asks IAM Identity Center for role credentials for the account and role you pick.

Can I add all my accounts at once?

Yes. Tick the accounts you want, or Select all, and they are added with one sign-in. The free plan includes one account; more need Pro.

Do I have to sign in every day?

No. The app uses refresh tokens like aws sso login and renews your credentials until your IAM Identity Center session ends. Your administrator sets how long that is.

Why does the code show before the browser opens?

So you can check that the AWS page shows the same code before you allow access. Open AWS sign-in also copies the code, in case the page asks you to type it.

Which permission set should I use?

A read-only one for day-to-day use. See the recommended permissions article for a ready-made permission set.

Still stuck?

Email [email protected] with what you tried and any message the app showed. Don’t send access keys or secrets. We reply within two working days.