# 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.

Screenshot: Connect with SSO: start URL and a Regions row set to Automatic, with Change

Screenshot: Your sign-in code QXVN-KTRB with an Open AWS sign-in button, waiting for approval

## 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](https://cloudconsole.dev/help/signed-out-and-mfa).

## 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](https://cloudconsole.dev/help/free-and-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 [support@cloudconsole.dev](mailto:support@cloudconsole.dev) with what you tried and any message the app showed. Don’t send access keys or secrets. We reply within two working days.

## Related

- [Add accounts from a setup link or QR code](https://cloudconsole.dev/help/setup-links) – Connecting AWS accounts
- ["Signed out" or "MFA code needed"](https://cloudconsole.dev/help/signed-out-and-mfa) – Troubleshooting
- [Recommended read-only permissions](https://cloudconsole.dev/help/recommended-permissions) – Permissions & errors
- [Switch, rename and remove accounts](https://cloudconsole.dev/help/manage-accounts) – Connecting AWS accounts

[All help topics →](https://cloudconsole.dev/help/)

---

Source: https://cloudconsole.dev/help/connect-with-sso

CloudConsole is an independent iPhone and Android app for Amazon Web Services by Cloudconcur Ltd. It is not affiliated with Amazon Web Services.
