CloudConsole

Assumir uma função em outra conta

Acesse outras contas e funções a partir de uma que você já adicionou, como o source_profile no ~/.aws/config.

Depois que você tem uma conta no app, pode adicionar funções assumidas a partir dela. É assim que você chega a outras contas quando entra com chaves de acesso, ou a funções fora dos seus conjuntos de permissões do SSO.

Formulário Assume a role: conta de origem, ARN da função, ID externo, nome e região
Assumir uma função

Passos

  1. Vá em Account → Add account → Assume a role. (A opção aparece quando você tem pelo menos uma conta.)
  2. Em From, escolha a conta cujas credenciais vão assumir a função.
  3. Digite o Role ARN, por exemplo arn:aws:iam::123456789012:role/ReadOnly.
  4. Se quiser, dê um Name, escolha a região e toque em Check and add.

O app obtém credenciais de 1 hora para a função e as renova quando necessário. O nome da sessão é CloudConsole, e é assim que ela aparece no CloudTrail.

O que os dois lados precisam

A política de confiança da função precisa confiar na conta (ou no usuário, ou na função) a partir da qual você a assume:

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Principal": {
        "AWS": "arn:aws:iam::111122223333:root"
      },
      "Action": "sts:AssumeRole"
    }
  ]
}

E a identidade a partir da qual você a assume precisa de permissão para chamar sts:AssumeRole nela:

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": "sts:AssumeRole",
      "Resource": "arn:aws:iam::123456789012:role/ReadOnly"
    }
  ]
}

Bom saber

  • As funções podem ser encadeadas, em até três saltos.
  • Se a política de confiança exigir MFA, assuma a função a partir de uma conta com chaves de acesso e MFA ativado.
  • Se a política de confiança da função exigir um ID externo (sts:ExternalId), digite-o em External ID.
  • Remover a conta a partir da qual uma função é assumida também remove a função.
  • Uma função conta como uma conta: no plano gratuito, adicionar uma exige o Pro.
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.