# 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](https://cloudconsole.dev/help/setup-links) 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.

Screenshot: What a team member sees after scanning the setup QR

## 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](https://cloudconsole.dev/tools/aws-config-to-qr). 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) and `sr` (Identity Center region) are required. `a` (account ID) and `ro` (role name) go together; leave both out to let people pick after signing in. `n` is the account name shown in the app, `r` the region it opens in, `k` the profile name.
- **role**: `arn` and `src` are required. `src` is the `k` of another entry, or the name of an account already in the person's app. `x` is 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](https://cloudconsole.dev/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 `ReadOnlyAccess` policy or the tighter CloudConsole policy in [Recommended permissions](https://cloudconsole.dev/help/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](https://cloudconsole.dev/help/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](https://cloudconsole.dev/help/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](https://cloudconsole.dev/help/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.

**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
- [Recommended read-only permissions](https://cloudconsole.dev/help/recommended-permissions) – Permissions & errors
- [Permissions for changes (Pro actions)](https://cloudconsole.dev/help/permissions-for-changes) – Permissions & errors
- [Guardrails: how changes are confirmed](https://cloudconsole.dev/help/guardrails) – Safety & changes

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

---

Source: https://cloudconsole.dev/help/team-setup

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