Set up CloudConsole for your team
For admins: make one setup link or QR code with your team's accounts and roles, use a read-only role day to day and a separate role for changes.
If several people on your team use CloudConsole, give them one setup link or QR code instead of a list of start URLs, account IDs and role names. Each person scans or opens it, approves the sign-in once per access portal, and gets the same accounts, roles and regions. The link holds no secrets, so it can live on your wiki.

1. Make the link from ~/.aws/config
If your AWS CLI config already has the profiles your team uses, paste it into the free AWS config to QR tool. It runs in your browser, keeps IAM Identity Center profiles (both sso-session and the older style) and role profiles (role_arn + source_profile, with external_id and chains), and leaves out any keys it finds. Untick what the team doesn't need, then copy the link or save the QR code.
2. Or build one by hand
A setup link is https://cloudconsole.dev/connect#v1. followed by a JSON list, compressed with raw deflate and written as base64url without padding. Each entry in the list is an SSO account or a role, for example:
[{"t":"sso","k":"prod","u":"https://acme.awsapps.com/start","sr":"eu-west-2",
"a":"111122223333","n":"acme-prod","ro":"CloudConsoleReadOnly","r":"eu-west-2"},
{"t":"role","k":"prod-operator","arn":"arn:aws:iam::111122223333:role/Operator",
"src":"prod","x":"acme-oncall","r":"eu-west-2"}]
- sso:
u(start URL) andsr(Identity Center region) are required.a(account ID) andro(role name) go together; leave both out to let people pick after signing in.nis the account name shown in the app,rthe region it opens in,kthe profile name. - role:
arnandsrcare required.srcis thekof another entry, or the name of an account already in the person's app.xis an external ID.
To turn a file team.json holding that list into a link:
python3 -c 'import json,sys,zlib,base64
d=json.dumps(json.load(open(sys.argv[1])),separators=(",",":")).encode()
c=zlib.compressobj(9,zlib.DEFLATED,-15); z=c.compress(d)+c.flush()
print("https://cloudconsole.dev/connect#v1."+base64.urlsafe_b64encode(z).decode().rstrip("="))' team.json
Open the link in a browser to check it: the /connect page lists what it adds, or says what's wrong. Field values can't look like keys or secrets; if one does, the whole link is refused.
3. A read-only role, and a separate role for changes
Give everyone a read-only role for day-to-day checking, and a separate role for the changes you want people to make from a phone:
- Read-only: an IAM Identity Center permission set with the AWS managed
ReadOnlyAccesspolicy or the tighter CloudConsole policy in Recommended permissions. - Changes: a second permission set (or a role assumed from the first) with only the actions your team should use on call, from Permissions for changes. Narrow the resources and add tag conditions where you can.
Put both in the link, for example prod with the read-only role and prod-operator with the change role. Ask people to set the change account's guardrail to Typed + Face ID in the app (Guardrails); a link can't set guardrails or read-only for them.
4. Share it
Put the link and the QR code on your wiki or runbook page, next to how to install the app. On a computer, people can scan the QR code from the screen with Scan setup QR; on a phone, they tap the link. One QR code holds about 2,300 characters, so for many profiles share the link, or make two codes.
Making changes from the app needs CloudConsole Pro for each person who makes them; reading is free for one account. See Free and Pro.
Questions
Can the link include access keys for a shared IAM user?
No. Links never carry credentials, and the app refuses any link that contains something that looks like a key or secret. Use IAM Identity Center, or let each person add their own keys.
What happens when we change the link?
Nothing changes on phones that already used the old one. People open the new link and untick what they already have; accounts with the same account and role are replaced rather than duplicated.
Can I set guardrails or read-only in the link?
No. Those are set per account on each phone, in Account → Accounts → the settings icon.
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.