Desativando a notificação por e-mail padrão do AWS Cognito

Visão geral das configurações de e-mail do AWS Cognito

Amazon Web Services (AWS) Cognito é amplamente usado para gerenciar autenticação de usuários e sincronização de dados. Um desafio comum é o envio automático de e-mails de convite padrão por meio da API AdminCreateUser, que pode não estar alinhado com todos os protocolos operacionais.

Para personalizar a experiência do usuário e integrar mecanismos de e-mail personalizados, é necessário entender as possibilidades de configuração do AWS Cognito. Especificamente, o foco está em saber se existe uma configuração no console da AWS para suprimir esses e-mails universalmente, ignorando a necessidade de ajustar as chamadas de API individualmente.

Explicando os scripts de supressão de e-mail do AWS Cognito

Os scripts fornecidos demonstram como desabilitar os e-mails de convite padrão ao adicionar novos usuários ao AWS Cognito. Isso é particularmente útil para organizações que preferem usar um mecanismo de email personalizado em vez do recurso integrado do Cognito. O primeiro script usa o AWS SDK do Node.js para adicionar programaticamente um novo usuário com atributos específicos. Ele inicializa o cliente do provedor de serviços Cognito chamando AWS.CognitoIdentityServiceProvider(). O script então configura os parâmetros necessários, incluindo o ID do grupo de usuários, nome de usuário e atributos do usuário, como e-mail. Mais importante ainda, ele usa o MessageAction: 'SUPPRESS' parâmetro para garantir que nenhum e-mail padrão seja enviado na criação do usuário.

A segunda parte do script, que envolve a navegação no AWS Management Console, foi projetada para administradores que preferem definir configurações de e-mail diretamente no console, sem codificação. Este método envolve acessar as configurações do grupo de usuários e ajustar as ‘Personalizações de mensagens’ para desativar as mensagens padrão. Aqui, etapas como selecionar ‘Manage User Pools’ e navegando para ‘Message customizations’ são cruciais. Essas ações permitem que o administrador defina as configurações de email globalmente para todas as novas criações de usuários, eliminando assim a necessidade repetitiva de suprimir emails por meio de código para cada usuário.

const AWS = require('aws-sdk');
AWS.config.update({ region: 'your-region' });
const cognito = new AWS.CognitoIdentityServiceProvider();
const params = {
    UserPoolId: 'your-user-pool-id',
    Username: 'new-user-email',
    MessageAction: 'SUPPRESS',
    TemporaryPassword: 'TempPassword123!',
    UserAttributes: [{
        Name: 'email',
        Value: 'email@example.com'
    }, {
        Name: 'email_verified',
        Value: 'true'
    }]
};
cognito.adminCreateUser(params, function(err, data) {
    if (err) console.log(err, err.stack);
    else console.log('User created successfully without sending default email.', data);
});

1. Login to the AWS Management Console.
2. Navigate to the Amazon Cognito service.
3. Select ‘Manage User Pools’ and choose the specific user pool.
4. Go to ‘Message customizations’ under ‘Message’ configurations.
5. Scroll down to ‘Do you want Cognito to send invitation messages to your new users?’
6. Select ‘No’ to disable automatic emails.
7. Save the changes.
8. Note: This setting needs to be revisited if default settings are ever reset.
9. For each new user creation, ensure MessageAction: 'SUPPRESS' is set programmatically if using APIs.
10. Verify changes by testing user registration without receiving default emails.

Configuração avançada no AWS Cognito

Explorando ainda mais os recursos do AWS Cognito, além da supressão de e-mails padrão, existem configurações avançadas que melhoram a segurança e a flexibilidade de gerenciamento de usuários. Essas configurações podem ser gerenciadas diretamente pelo console AWS ou via API, permitindo fluxos de autenticação personalizados. Um aspecto importante é o uso de gatilhos Lambda, que oferecem uma maneira de executar ações personalizadas durante vários estágios do ciclo de vida do usuário, como validação, pré-autenticação e pós-confirmação do usuário.

Outra capacidade significativa é a integração de provedores terceirizados para autenticação. Isso permite que o Cognito sirva como uma ponte entre os serviços da AWS e os provedores de identidade externos, expandindo assim as opções de autenticação disponíveis para desenvolvedores e administradores. Ao aproveitar essas configurações avançadas, os administradores podem criar uma experiência de gerenciamento de usuários mais segura e personalizada.