Désactivation de la notification par e-mail par défaut d'AWS Cognito

Présentation des paramètres de messagerie AWS Cognito

Amazon Web Services (AWS) Cognito est largement utilisé pour gérer l'authentification des utilisateurs et la synchronisation des données. Un défi courant est l'envoi automatique d'e-mails d'invitation par défaut via l'API AdminCreateUser, qui peut ne pas correspondre à tous les protocoles opérationnels.

Pour personnaliser l'expérience utilisateur et intégrer des mécanismes de messagerie personnalisés, il est nécessaire de comprendre les possibilités de configuration au sein d'AWS Cognito. Plus précisément, l'accent est mis sur l'existence d'un paramètre dans la console AWS permettant de supprimer ces e-mails de manière universelle, évitant ainsi la nécessité d'ajuster les appels d'API individuellement.

Explication des scripts de suppression d'e-mails AWS Cognito

Les scripts fournis montrent comment désactiver les e-mails d'invitation par défaut lors de l'ajout de nouveaux utilisateurs à AWS Cognito. Ceci est particulièrement utile pour les organisations qui préfèrent utiliser un mécanisme d'e-mail personnalisé plutôt que la fonctionnalité intégrée de Cognito. Le premier script utilise le SDK AWS Node.js pour ajouter par programme un nouvel utilisateur avec des attributs spécifiques. Il initialise le client du fournisseur de services Cognito en appelant AWS.CognitoIdentityServiceProvider(). Le script configure ensuite les paramètres nécessaires, notamment l'ID du groupe d'utilisateurs, le nom d'utilisateur et les attributs utilisateur tels que l'e-mail. Plus important encore, il utilise le MessageAction: 'SUPPRESS' paramètre pour garantir qu’aucun e-mail par défaut n’est envoyé lors de la création de l’utilisateur.

La deuxième partie du script, qui implique la navigation dans la console de gestion AWS, est conçue pour les administrateurs préférant définir les configurations de messagerie directement dans la console sans codage. Cette méthode implique d'accéder aux paramètres du pool d'utilisateurs et d'ajuster les « Personnalisations des messages » pour désactiver la messagerie par défaut. Ici, des étapes comme la sélection ‘Manage User Pools’ et naviguer vers ‘Message customizations’ sont cruciaux. Ces actions permettent à l'administrateur de configurer les paramètres de messagerie de manière globale pour toutes les créations de nouveaux utilisateurs, éliminant ainsi le besoin répétitif de supprimer les e-mails via du code pour chaque utilisateur.

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.

Configuration avancée dans AWS Cognito

En explorant plus en détail les capacités d'AWS Cognito, au-delà de la suppression des e-mails par défaut, il existe des configurations avancées qui améliorent la sécurité et la flexibilité de la gestion des utilisateurs. Ces configurations peuvent être gérées directement via la console AWS ou via l'API, permettant des flux d'authentification personnalisés. Un aspect clé est l'utilisation de déclencheurs Lambda, qui offrent un moyen d'exécuter des actions personnalisées à différentes étapes du cycle de vie de l'utilisateur, telles que la validation de l'utilisateur, la pré-authentification et la post-confirmation.

Une autre capacité importante est l’intégration de fournisseurs tiers pour l’authentification. Cela permet à Cognito de servir de pont entre les services AWS et les fournisseurs d'identité externes, élargissant ainsi les options d'authentification disponibles pour les développeurs et les administrateurs. En tirant parti de ces paramètres avancés, les administrateurs peuvent créer une expérience de gestion des utilisateurs plus sécurisée et personnalisée.