CloudConsole

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

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

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. 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) 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.
  • 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 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); 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.

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 [email protected] 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.