# 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](https://cloudconsole.dev/tools/aws-config-to-qr). It never contains keys, passwords or tokens: you still sign in as yourself.

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

## 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](https://cloudconsole.dev/help/connect-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](https://cloudconsole.dev/help/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 [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

- [Set up CloudConsole for your team](https://cloudconsole.dev/help/team-setup) – Connecting AWS accounts
- [Sign in with IAM Identity Center (AWS SSO)](https://cloudconsole.dev/help/connect-with-sso) – Connecting AWS accounts
- [Assume a role in another account](https://cloudconsole.dev/help/assume-a-role) – Connecting AWS accounts
- [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/setup-links

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