CloudConsole

Add accounts from a setup link or QR code

Scan a setup QR or paste a cloudconsole.dev/connect link to add several AWS accounts and roles at once. Links hold no keys.

A setup link lists AWS accounts and roles: which access portal to sign in at, which account, role and region, and which roles to assume from them. Your team can share one, or you can make one from your laptop's ~/.aws/config with the AWS config to QR tool. It never contains keys, passwords or tokens: you still sign in as yourself.

Set up from a link: two SSO accounts on one portal, one sign-in, and a role whose source is missing
Add these accounts?

Open a setup link

  • Scan: go to Account → Add account → Scan setup QR and point the camera at the code. The camera is only used while that screen is open.
  • Paste: copy the link, then go to Account → Add account → Paste setup link. If the clipboard holds a setup link, it's already filled in; tap Continue.
  • Tap it: a https://cloudconsole.dev/connect#v1.… link opened on a phone with CloudConsole installed opens the app straight away. Without the app, the link opens a web page that lists what it would add.

Still in the demo? On the Account tab, Use access keys opens the same list of ways to add an account, including the two setup-link options.

Check what it adds

The Set up from a link screen asks Add these accounts? and lists everything in the link, with a tick box each:

  • SSO accounts, grouped by access portal. Each group says which region IAM Identity Center is in and one sign-in covers all of these. An entry without an account says Choose accounts and roles after signing in.
  • Assumed roles: the role, its account, and the profile it's assumed from, plus the region and whether it uses an external ID.

Untick anything you don't want, then tap Add 3 profiles (the number is however many are ticked).

Sign in once per portal

For each access portal, the Sign in to your portal screen opens with the start URL and regions filled in, and the sign-in starts by itself: tap Open AWS sign-in and approve, as in Sign in with SSO. That one approval adds every ticked account on that portal. If this phone is already signed in to the portal, there's no approval at all. Roles are added after the accounts they're assumed from, including chains of roles.

If a sign-in doesn't finish, its accounts show Not added with Not signed in. Tap Add to try again. Everything that was added stays added.

Roles whose source is missing

A role is assumed from another profile, named in the link. If that profile isn't in the link or already in the app, the role can't be ticked and says Assumed from "…", which isn't in this link or the app. If you already have accounts in the app, pick one under Assume it from an account in the app. If you untick a role's source, the role says which is unticked until you tick it again.

When a link is refused

Can't use this setup link means the link is damaged or isn't a CloudConsole link. A link that contains anything that looks like an access key or secret is refused as a whole: "This setup link contains AWS credentials, so it was rejected. Setup links never carry keys or tokens." Ask whoever sent it for a new one.

The free plan includes one account. If a link would take you past that, CloudConsole Pro is needed to add the rest (see Free and Pro).

Questions

Is it safe to share a setup link?

Yes. It only says where to sign in and which account, role and region to use. Anyone who opens it still has to sign in with their own AWS identity, and can only use what that identity already allows. Links that contain keys are refused.

Does the link reach a CloudConsole server?

No. The details are in the part of the link after #, which browsers never send to a server. The app and the /connect page read it on the device.

Do I approve each account separately?

No. You approve once for each IAM Identity Center access portal in the link, and every ticked account on that portal is added.

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.