# Configurar o CloudConsole para a sua equipe

Para administradores: crie um link ou QR code de configuração com as contas e funções da equipe, use uma função somente leitura no dia a dia e outra separada para alterações.

Se várias pessoas da equipe usam o CloudConsole, dê a elas um [link ou QR code de configuração](https://cloudconsole.dev/pt-br/help/setup-links) em vez de uma lista de URLs iniciais, IDs de conta e nomes de funções. Cada pessoa escaneia ou abre o link, aprova o login uma vez por portal de acesso e recebe as mesmas contas, funções e regiões. O link não tem segredos, então pode ficar na sua wiki.

Screenshot: O que um membro da equipe vê depois de escanear o QR de configuração

## 1. Crie o link a partir do ~/.aws/config

Se a configuração da sua AWS CLI já tem os perfis que a equipe usa, cole-a na [ferramenta gratuita AWS config to QR](https://cloudconsole.dev/pt-br/tools/aws-config-to-qr). Ela roda no seu navegador, mantém os perfis do IAM Identity Center (tanto `sso-session` quanto o formato antigo) e os perfis de função (`role_arn` + `source_profile`, com `external_id` e cadeias) e descarta qualquer chave que encontrar. Desmarque o que a equipe não precisa e depois copie o link ou salve o QR code.

## 2. Ou monte um manualmente

Um link de configuração é `https://cloudconsole.dev/connect#v1.` seguido de uma lista JSON, comprimida com raw deflate e escrita em base64url sem preenchimento. Cada item da lista é uma conta de SSO ou uma função, por exemplo:

```
[{"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` (URL inicial) e `sr` (região do Identity Center) são obrigatórios. `a` (ID da conta) e `ro` (nome da função) andam juntos; omita os dois para que cada pessoa escolha depois de entrar. `n` é o nome da conta exibido no app, `r` a região em que ele abre e `k` o nome do perfil.
- **role**: `arn` e `src` são obrigatórios. `src` é o `k` de outro item, ou o nome de uma conta que a pessoa já tem no app. `x` é um ID externo.

Para transformar em link um arquivo `team.json` com essa lista:

```
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
```

Abra o link no navegador para conferir: a página [/connect (EN)](https://cloudconsole.dev/connect) lista o que ele adiciona ou diz o que está errado. Os valores dos campos não podem parecer chaves ou segredos; se algum parecer, o link inteiro é recusado.

## 3. Uma função somente leitura e outra separada para alterações

Dê a todos uma função somente leitura para as verificações do dia a dia e outra separada para as alterações que você quer permitir pelo celular:

- **Somente leitura**: um conjunto de permissões do IAM Identity Center com a política gerenciada pela AWS `ReadOnlyAccess` ou com a política mais restrita do CloudConsole em [Permissões recomendadas](https://cloudconsole.dev/pt-br/help/recommended-permissions).
- **Alterações**: um segundo conjunto de permissões (ou uma função assumida a partir do primeiro) só com as ações de [Permissões para alterações](https://cloudconsole.dev/pt-br/help/permissions-for-changes) que a equipe deve usar no plantão. Restrinja os recursos e adicione condições de tags sempre que puder.

Coloque os dois no link, por exemplo `prod` com a função somente leitura e `prod-operator` com a função de alterações. Peça a cada pessoa para ajustar a proteção da conta de alterações para **Typed + Face ID** no app ([Proteções](https://cloudconsole.dev/pt-br/help/guardrails)); um link não consegue definir proteções nem somente leitura por elas.

## 4. Compartilhe

Coloque o link e o QR code na sua wiki ou runbook, ao lado das instruções de instalação do app. No computador, as pessoas escaneiam o QR code na tela com **Scan setup QR**; no celular, tocam no link. Um QR code comporta cerca de 2.300 caracteres, então, com muitos perfis, compartilhe o link ou crie dois códigos.

Fazer alterações pelo app exige o CloudConsole Pro para cada pessoa que as faz; a leitura é gratuita para uma conta. Veja [Grátis e Pro](https://cloudconsole.dev/pt-br/help/free-and-pro).

## Perguntas frequentes

### O link pode incluir chaves de acesso de um usuário do IAM compartilhado?

Não. Os links nunca levam credenciais, e o app recusa qualquer link que contenha algo parecido com uma chave ou um segredo. Use o IAM Identity Center ou deixe cada pessoa adicionar as próprias chaves.

### O que acontece quando mudamos o link?

Nada muda nos celulares que já usaram o antigo. As pessoas abrem o link novo e desmarcam o que já têm; itens com a mesma conta e a mesma função são substituídos em vez de duplicados.

### Posso definir proteções ou somente leitura no link?

Não. Isso é definido por conta em cada celular, em Account → Accounts → o ícone de configurações.

**Ainda com dúvidas?**

Escreva para [support@cloudconsole.dev](mailto:support@cloudconsole.dev) contando o que você tentou e qual mensagem o app mostrou. Não envie chaves de acesso nem segredos. Respondemos em até dois dias úteis.

## Veja também

- [Adicionar contas com um link ou QR code de configuração](https://cloudconsole.dev/pt-br/help/setup-links) – Conectar contas da AWS
- [Permissões recomendadas de somente leitura](https://cloudconsole.dev/pt-br/help/recommended-permissions) – Permissões e erros
- [Permissões para alterações (ações do Pro)](https://cloudconsole.dev/pt-br/help/permissions-for-changes) – Permissões e erros
- [Proteções: como as alterações são confirmadas](https://cloudconsole.dev/pt-br/help/guardrails) – Segurança e alterações

[Todos os tópicos de ajuda →](https://cloudconsole.dev/pt-br/help/)

---

Source: https://cloudconsole.dev/pt-br/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.
