View a markdown version of this page

Autenticação com grupos de usuários do Amazon Cognito - Amazon Cognito

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Autenticação com grupos de usuários do Amazon Cognito

O Amazon Cognito inclui vários métodos para autenticar os usuários. Os usuários podem fazer login com WebAuthn senhas e chaves de acesso. O Amazon Cognito pode enviar a eles uma senha de uso único por e-mail ou SMS. Você pode implementar funções do Lambda que orquestram sua própria sequência de desafios e respostas. Esses são fluxos de autenticação. Nos fluxos de autenticação, os usuários fornecem um segredo e o Amazon Cognito verifica o segredo e emite tokens web JSON (JWTs) para as aplicações processarem com bibliotecas do OIDC. Este capítulo descreve como configurar seus grupos de usuários e clientes de aplicativos para vários fluxos de autenticação em vários ambientes de aplicativos. Ele abrange opções para o uso das páginas de login hospedadas do login gerenciado e para criar sua própria lógica e front-end em um AWS SDK.

Todos os grupos de usuários, independentemente de você ter um domínio ou não, podem autenticar usuários na API de grupos de usuários. Se adicionar um domínio ao grupo de usuários, você poderá usar os endpoints do grupo de usuários. A API de grupos de usuários é compatível com uma variedade de modelos de autorização e fluxos de solicitações de API.

Para verificar a identidade dos usuários, o Amazon Cognito é compatível com fluxos de autenticação que incorporam tipos de desafio, além de senhas, como senhas de uso único e chaves de acesso enviadas por e-mail e SMS.

Antes de configurar os detalhes, escolha a abordagem de autenticação adequada ao seu aplicativo. O auxílio de decisão a seguir resume os dois pontos de entrada e, em um aplicativo personalizado, os dois fluxos iniciais de login. Cada opção está vinculada à sua seção detalhada.

Você quer que o Amazon Cognito hospede as páginas de login ou crie seu próprio front-end?

Se você quiser o caminho de menor esforço, use o login gerenciado. O Amazon Cognito hospeda as páginas de login, saída e redefinição de senha, e seu aplicativo processa o resultado com uma biblioteca independente do OpenID Connect (OIDC). O login gerenciado apresenta automaticamente os métodos de autenticação que seu grupo de usuários e a configuração do cliente do aplicativo permitem.

Se você quiser criar sua própria interface de usuário e controlar a lógica de login, use um AWS SDK. Seu aplicativo chama a API de grupos de usuários diretamente e você implementa a lógica de resposta ao desafio.

Em um aplicativo personalizado, você coleta o método de login do usuário ou o declara antecipadamente?

Escolha a autenticação baseada em opções (o USER_AUTH fluxo) quando quiser oferecer aos usuários uma lista dos métodos de login disponíveis e permitir que eles selecionem um. Esse fluxo é a única maneira de oferecer login sem senha e com chave de acesso.

Escolha a autenticação baseada no cliente quando seu aplicativo já sabe como o usuário fará login e declara o fluxo com antecedência, por exemplo. USER_SRP_AUTH Client-baseda autenticação é a única maneira de usar a autenticação personalizada e atualizar os fluxos de token.

Pré-requisitos para autenticação baseada em opções

Choice-based a autenticação se aplica tanto ao login gerenciado quanto aos AWS SDKs. Para usá-lo, adicione ALLOW_USER_AUTH aos fluxos de autenticação permitidos do seu cliente de aplicativo. Além disso, os métodos sem senha e chave de acesso exigem um domínio de login gerenciado e um plano de recursos acima do nível Lite (Essentials ou Plus).

Um exemplo de sessão de autenticação

O diagrama a seguir e o guia passo a passo ilustram um cenário típico em que um usuário faz login em uma aplicação. A aplicação de exemplo apresenta ao usuário várias opções de login. Ele seleciona uma inserindo suas credenciais, fornece um fator de autenticação adicional e faz login.

Um fluxograma que mostra um aplicativo que solicita a entrada do usuário e faz login com um AWS SDK.

Imagine uma aplicação com uma página de login na qual os usuários podem fazer login com nome de usuário e senha, solicitar um código de uso único enviado por e-mail ou escolher uma opção de impressão digital.

  1. Sign-in prompt: Seu aplicativo mostra uma tela inicial com um botão de login.

  2. Solicitar login: o usuário seleciona Fazer login. Com base em um cookie ou cache, a aplicação recupera o nome de usuário ou solicita que ele o insira.

  3. Opções de solicitação: a aplicação solicita as opções de login do usuário por meio de uma solicitação de API InitiateAuth com o fluxo USER_AUTH, solicitando os métodos de login disponíveis para o usuário.

  4. Enviar opções de login: o Amazon Cognito responde com PASSWORD, EMAIL_OTP e WEB_AUTHN. A resposta inclui um identificador de sessão para você reproduzir na próxima resposta.

  5. Opções de exibição: a aplicação mostra elementos de IU para que o usuário insira seu nome de usuário e senha, obtenha um código de uso único ou escaneie sua impressão digital.

  6. Escolha option/Enter as credenciais: o usuário insere seu nome de usuário e senha.

  7. Iniciar autenticação: a aplicação fornece as informações de login do usuário por meio de uma solicitação de API RespondToAuthChallenge que confirma o login com nome de usuário e senha e fornece o nome de usuário e a senha.

  8. Validar credenciais: o Amazon Cognito confirma as credenciais do usuário.

  9. Desafio adicional: o usuário tem a autenticação multifator configurada com uma aplicação autenticadora. O Amazon Cognito retorna um desafio SOFTWARE_TOKEN_MFA.

  10. Solicitação de desafio: a aplicação exibe um formulário solicitando uma senha de uso único com marcação temporal (TOTP) da aplicação autenticadora do usuário.

  11. Responder ao desafio: o usuário envia a TOTP.

  12. Responder ao desafio: em outra solicitação RespondToAuthChallenge, a aplicação fornece a TOTP do usuário.

  13. Validar a resposta ao desafio: o Amazon Cognito confirma o código do usuário e determina que o grupo de usuários está configurado para não emitir desafios adicionais para o usuário atual.

  14. Emitir tokens: o Amazon Cognito retorna tokens web JSON (JWTs) de ID, acesso e atualização. A autenticação inicial do usuário está concluída.

  15. Armazenar tokens: a aplicação armazena em cache os tokens do usuário para poder referenciar os dados do usuário, autorizar o acesso a recursos e atualizar os tokens quando eles expirarem.

  16. Renderizar conteúdo autorizado: a aplicação determina o acesso do usuário aos recursos com base em sua identidade e funções e fornece o conteúdo da aplicação.

  17. Acessar conteúdo: o usuário está conectado e começa a usar a aplicação.

  18. Solicitar conteúdo com token expirado: posteriormente, o usuário solicita um recurso que requer autorização. O token em cache do usuário expirou.

  19. Tokens de atualização: a aplicação faz uma solicitação InitiateAuth com o token de atualização salvo do usuário.

  20. Emitir tokens: o Amazon Cognito retorna novos JWTs de ID e acesso. A sessão do usuário é atualizada com segurança sem solicitações adicionais de credenciais.

Você pode usar acionadores do AWS Lambda para personalizar a maneira como os usuários se autenticam. Esses triggers emitem e verificam seus próprios desafios como parte do fluxo de autenticação.

Você também pode usar o fluxo de autenticação do administrador para servidores back-end seguros. Você pode usar o fluxo de autenticação de migração de usuários para possibilitar a migração de usuários sem exigir que seus usuários redefinam suas senhas.