Ir para o conteúdo

Como faço para integrar o Amazon SES a um grupo de usuários do Amazon Cognito?

5 minuto de leitura
0

Quero integrar o Amazon Simple Email Service (Amazon SES) a um grupo de usuários do Amazon Cognito.

Resolução

Observação: se você receber mensagens de erro ao executar comandos da AWS Command Line Interface (AWS CLI), consulte Solução de problemas da AWS CLI. Além disso, verifique se você está usando a versão mais recente da AWS CLI.

Pré-requisitos

O Amazon Cognito e o Amazon SES não oferecem suporte a integrações entre contas. Você não pode configurar um grupo de usuários do Amazon Cognito em uma conta e depois integrar o grupo de usuários com um endereço de e-mail do Amazon SES em uma conta diferente.

Configure sua conta do Amazon SES

Para evitar fraudes e abusos, o Amazon SES coloca todas as novas contas do Amazon SES na sandbox do Amazon SES. Ao usar uma sandbox do Amazon SES, verifique as restrições. Em seguida, conclua as etapas a seguir para remover sua conta da sandbox do Amazon SES:

  1. Analise a tabela de mapeamento de regiões da AWS na configuração de e-mail do Amazon SES. A tabela de mapeamento mostra as regiões nas quais você pode integrar as identidades do Amazon SES aos grupos de usuários do Amazon Cognito. Certifique-se de usar regiões compatíveis antes de mover a conta do Amazon SES para fora da sandbox.
  2. Solicite acesso à produção para sua conta do Amazon SES. A equipe do AWS Support fornece uma resposta inicial à sua solicitação em 24 horas.

Observação: você deve migrar para a nova experiência de console do Amazon Cognito para integrar o Amazon Cognito ao Amazon SES na mesma região.

Você também deve verificar suas identidades de domínio e endereços de e-mail no Amazon SES.

Integre seu grupo de usuários a uma identidade verificada

Conclua as etapas a seguir:

  1. Faça login no console do Amazon Cognito e clique em User Pools (Grupos de usuários).
  2. Selecione o grupo de usuários.
  3. No menu Authentication methods (Métodos de autenticação), selecione Email configuration (Configuração de e-mail). Em seguida, clique em Edit (Editar).
  4. Em FROM email address (FROM endereço de e-mail), selecione a identidade de domínio verificada do Amazon SES. Por exemplo, exemplo.com.
  5. Em FROM sender name (FROM nome do remetente) , insira seu endereço de e-mail. Por exemplo, admin@exemplo.com.

Você pode adicionar um endereço de e-mail personalizado na identidade do domínio. A API UpdateUserPool configura o grupo de usuários do Amazon Cognito com uma identidade do Amazon SES.

Exemplo de comando update-user-pool:

$ aws cognito-idp update-user-pool --user-pool-id example_pool_id --email-configuration SourceArn=arn:aws:ses:example_region:example_account_number:identity/example_domain,EmailSendingAccount=DEVELOPER,From=user@example.com --region example_region  

Importante: a API UpdateUserPool redefine a configuração atual do grupo de usuários. Para redefinir a configuração, você deve invocar a API DescribeUserPool e, em seguida, enviar todos os parâmetros do grupo de usuários existente para a API UpdateUserPool.

Seguem as descrições do comando update-user-pool:

  • example_pool_id corresponde ao ID do grupo de usuários do Amazon Cognito. Exemplo: ap-southeast-1_xxxxxxxx.
  • arn:aws:ses:example_region:example_account_number:identity/example_domain é o nome do recurso da Amazon (ARN) da sua identidade de domínio do Amazon SES.
  • Substitua user@example.com pela sua identidade de e-mail.
  • example_region representa a região onde está seu grupo de usuários do Amazon Cognito. Exemplo: ap-southeast-1.

Solucione erros

Com base no seu problema, conclua as seguintes tarefas.

Resolva erros de endereço de e-mail não verificado

Se você tentar enviar um e-mail de uma conta sandbox do Amazon SES para um endereço de e-mail não verificado, pode receber a seguinte mensagem de erro:

“Email address is not verified. The following identities failed the check in region AP-SOUTHEAST-1: user@example.com.”

Para resolver esse erro, mova sua conta do Amazon SES para fora da sandbox ou verifique o endereço de e-mail do destinatário no Amazon SES.

Mensagens de e-mail ausentes

Se os usuários não estiverem recebendo e-mails do seu grupo de usuários do Amazon Cognito, conclua as seguintes etapas:

Exemplo de comando describe-user-pool:

aws cognito-idp describe-user-pool --user-pool-id example_pool_id --region example_region --query 'UserPool.EmailConfiguration'  

Exemplo de saída 1:

{  "SourceArn": "arn:aws:ses:us-east-1:123456789012:identity/admin@example.com",
  "EmailSendingAccount": "DEVELOPER",
  "From": "admin@example.com"
}  

Exemplo de saída 2:

{  "SourceArn": "arn:aws:ses:us-east-1:123456789012:identity/admin@example.com",
  "EmailSendingAccount": "COGNITO_DEFAULT"
}  

Se EmailSendingAccount for DEVELOPER, seu grupo de usuários usa o Amazon SES para enviar mensagens de e-mail. Você também pode revisar os logs do Amazon SES para obter mais informações sobre problemas de entrega.

Se EmailSendingAccount for COGNITO_DEFAULT, seu grupo de usuários está usando a funcionalidade de e-mail padrão do Amazon Cognito para enviar mensagens de e-mail. Essa funcionalidade tem uma cota de e-mails enviados por grupo de usuários que pode causar erros na cota diária de e-mail.

Resolva erros na cota diária de e-mails

Se você exceder a cota da configuração padrão de e-mail do Amazon Cognito, pode receber a seguinte mensagem de erro:

“Exceeded daily email limit for the operation or account. Number of allowed operation has exceeded. If a higher limit is required, please configure your user pool to use your own Amazon SES configuration for sending email messages.”

Para resolver esse erro, configure seu grupo de usuários para usar sua própria configuração do Amazon SES para enviar e-mails. Essa configuração aumenta suas cotas de envio do Amazon SES.

Informações relacionadas

Por que o Amazon Cognito não envia o código de verificação por e-mail ou mensagem de texto SMS com a chamada de API ForgotPassword?

AWS OFICIALAtualizada há 7 meses