# Entrar com o IAM Identity Center (AWS SSO)

Digite a URL do seu portal de acesso da AWS: o app encontra a região e mostra um código; você aprova no navegador e escolhe contas e funções.

Esta é a forma recomendada de entrar. O app obtém credenciais temporárias para a conta e a função que você escolher, do mesmo jeito que o `aws sso login --use-device-code`, então nenhuma chave permanente fica no seu celular.

Screenshot: Connect with SSO: URL inicial e a linha Regions em Automatic, com Change

Screenshot: Your sign-in code QXVN-KTRB com um botão Open AWS sign-in, aguardando aprovação

## Passos

1. Toque em **Connect with AWS SSO** na tela de boas-vindas, ou em **Account → Add account → AWS SSO (IAM Identity Center)**. A tela se chama **Connect with SSO**.
2. Digite sua **Start URL**: o endereço do portal de acesso da AWS que você usa no notebook, por exemplo `https://my-org.awsapps.com/start`. Você pode omitir `https://` e `/start`.
3. Deixe **Regions** como está (*Automatic: found from your portal URL*). Só toque em **Change** se quiser escolher as regiões você mesmo.
4. Toque em **Continue**. Enquanto o app consulta seu portal, o botão mostra **Finding your region…**.
5. Aparece **Your sign-in code**. Toque em **Open AWS sign-in**: o app copia o código e abre a página de login da AWS no navegador. Confira se a página mostra o mesmo código, entre se for pedido e permita o acesso. Se a página pedir para digitar o código, cole-o.
6. Volte ao CloudConsole: ele percebe a aprovação sozinho (*Waiting for approval…*). Em **Choose accounts**, se as suas contas tiverem mais de um conjunto de permissões, escolha primeiro o **Permission set** no topo. Ele lista cada um com quantas contas o têm (*in N of M accounts*) e começa com o último que você usou neste portal; senão, um somente leitura como `ReadOnlyAccess`; senão, o mais comum. Depois marque uma ou mais contas, ou toque em **Select all** para marcar todas as contas que têm esse conjunto de permissões. Com mais de seis contas, aparece uma caixa de busca (nome, ID ou e-mail). As contas marcadas recebem o conjunto de permissões; uma conta sem ele mostra *No <permission set> here* e, se você marcá-la, recebe a única função dela; senão, uma somente leitura; senão, a primeira. Toque na função abaixo de uma conta para escolher outra.
7. Toque em **Add N accounts**. Cada conta vira uma entrada própria no app, e todas compartilham este único login.

## Como a região é encontrada

Há duas regiões envolvidas: a **SSO region**, onde o IAM Identity Center está configurado, e a **Region for your resources**, em que o app abre. Com *Automatic*, o app lê a região de SSO no seu portal: endereços de portal mais novos trazem a região (`….portal.eu-west-2.app.aws`), e portais `awsapps.com` a revelam na própria página. A região dos seus recursos começa igual; troque quando quiser pelo chip de região em uma tela de serviço ou nas configurações da conta.

Se o app não conseguir descobrir, ele mostra os dois seletores (**SSO region (where Identity Center is set up)** e **Region for your resources**) com esta mensagem: *"Couldn't tell this portal's region. Pick the region IAM Identity Center is set up in (shown in the AWS console under IAM Identity Center → Settings)."* Se você usa a AWS CLI com SSO, é o `sso_region` em `~/.aws/config`. Uma região escolhida por você nunca é sobrescrita.

## Continuar conectado

O app se registra para receber tokens de atualização, como o `aws sso login` faz com uma `sso-session`, e guarda o token no armazenamento seguro do celular. Ele renova as credenciais da sua função em segundo plano enquanto durar sua sessão do IAM Identity Center. Essa duração é definida pelo administrador no IAM Identity Center, então pode ser de horas ou de dias. Uma conexão que cai ou uma AWS sobrecarregada não desconecta você; só a recusa da renovação pela AWS faz isso.

Quando a sessão termina, as telas mostram **Signed out** com um botão **Sign in**. Ao entrar de novo, todas as contas que você adicionou daquele portal continuam lá: veja [Desconectado](https://cloudconsole.dev/pt-br/help/signed-out-and-mfa).

## Mais de uma conta

Você pode adicionar várias contas de um portal de uma vez, como acima. Para trocar de conta, toque no nome da conta na Home. O seletor de contas agrupa as contas por portal: abaixo de cada portal vêm as contas que você adicionou e, depois, as outras contas do portal, marcadas com **Add**. Toque em uma delas para adicioná-la e trocar para ela de uma vez. É usado o conjunto de permissões do portal, mostrado no topo da seção do portal como **Permission set: …** quando há mais de um (toque nele para trocar), ou a única função da conta; senão, o app pergunta qual função. O seletor atualiza a lista de contas do portal em segundo plano (*Updating…*). Com mais de seis contas, aparece uma caixa de busca, que também encontra contas que você não adicionou.

Para escolher várias contas a mais de uma vez, não é preciso fazer login de novo: use **More accounts from <your portal>**, a primeira opção em **Add account**, **Add accounts from <your portal>** abaixo da lista em **Accounts**, ou **Add more accounts from this portal** nas configurações de uma conta SSO. A lista de contas abre na hora; contas e funções que você já adicionou aparecem marcadas. Se a sua sessão do IAM Identity Center tiver terminado, o app pede que você faça login primeiro, aqui e no seletor de contas.

O plano gratuito inclui uma conta. Se você marcar mais, o botão mostra **Add N accounts (Pro)** e abre a tela do [Pro](https://cloudconsole.dev/pt-br/help/free-and-pro); depois que você assina, as contas são adicionadas. Tocar no seletor em uma conta que você não adicionou abre a tela do Pro do mesmo jeito. Com o Pro não há limite.

## Se não funcionar

- **"Enter your AWS access portal URL, e.g. https://my-org.awsapps.com/start"**: a Start URL está vazia ou não é um endereço web.
- **"Couldn't tell this portal's region…"**: escolha você mesmo a região de SSO, como descrito acima.
- **"Check the start URL and that IAM Identity Center is in …"**: a URL foi digitada errada ou a região de SSO está incorreta. Toque em **Change** em **Regions** e confira.
- **"Sign-in was denied in the browser."**: você (ou seu provedor de identidade) recusou a solicitação. Toque em **Continue** para começar de novo.
- **"The sign-in code expired. Try again."**: a etapa no navegador demorou demais. Toque em **Continue** para receber um novo código.
- O navegador não abriu, ou você o fechou cedo demais: toque em **Open sign-in page again**.
- Nenhuma conta listada: você não tem nenhum conjunto de permissões atribuído em nenhuma conta. Fale com o administrador.

## Perguntas frequentes

### É a mesma coisa que o aws sso login?

Sim. O CloudConsole usa o mesmo fluxo OAuth de autorização de dispositivo do aws sso login --use-device-code e depois pede ao IAM Identity Center credenciais para a conta e a função que você escolher.

### Posso adicionar todas as minhas contas de uma vez?

Sim. Marque as contas que quiser, ou Select all, e elas são adicionadas com um único login. O plano gratuito inclui uma conta; para mais, é preciso o Pro.

### Preciso entrar todos os dias?

Não. O app usa tokens de atualização como o aws sso login e renova suas credenciais até o fim da sua sessão do IAM Identity Center. A duração é definida pelo administrador.

### Por que o código aparece antes de o navegador abrir?

Para você conferir se a página da AWS mostra o mesmo código antes de permitir o acesso. O Open AWS sign-in também copia o código, caso a página peça para digitá-lo.

### Qual conjunto de permissões devo usar?

Um somente leitura para o dia a dia. O artigo de permissões recomendadas tem um conjunto de permissões pronto.

**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
- [“Signed out” ou “MFA code needed”](https://cloudconsole.dev/pt-br/help/signed-out-and-mfa) – Solução de problemas
- [Permissões recomendadas de somente leitura](https://cloudconsole.dev/pt-br/help/recommended-permissions) – Permissões e erros
- [Trocar, renomear e remover contas](https://cloudconsole.dev/pt-br/help/manage-accounts) – Conectar contas da AWS

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

---

Source: https://cloudconsole.dev/pt-br/help/connect-with-sso

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