CloudConsole

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.

Connect with SSO: URL inicial e a linha Regions em Automatic, com Change
1. URL inicial; regiões encontradas para você
Your sign-in code QXVN-KTRB com um botão Open AWS sign-in, aguardando aprovação
2. Confira o código e abra o login da AWS

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.

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