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

Screenshot: Formulário Assume a role: conta de origem, ARN da função, ID externo, nome e regiã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](https://cloudconsole.dev/pt-br/help/free-and-pro).

**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 um usuário do IAM com chaves de acesso (e MFA)](https://cloudconsole.dev/pt-br/help/connect-with-access-keys) – Conectar contas da AWS
- [Trocar, renomear e remover contas](https://cloudconsole.dev/pt-br/help/manage-accounts) – Conectar contas da AWS
- [Entenda “No permission” e outros erros de acesso](https://cloudconsole.dev/pt-br/help/access-denied) – Permissões e erros
- [Permissões recomendadas de somente leitura](https://cloudconsole.dev/pt-br/help/recommended-permissions) – Permissões e erros

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

---

Source: https://cloudconsole.dev/pt-br/help/assume-a-role

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