Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Configuration des messages SMS, e-mails de vérification et messages d'invitation des utilisateurs

Avec Amazon Cognito, vous pouvez personnaliser les messages de vérification par SMS et e-mail ainsi que les messages d'invitation des utilisateurs, afin d'améliorer la sécurité et l'expérience utilisateur de votre application. Avec Amazon Cognito, vous pouvez choisir entre des vérifications basées sur le code ou des vérifications de liens en un clic pour répondre aux besoins de votre application. Cette rubrique explique comment personnaliser l'authentification multifactorielle (MFA) et les communications de vérification dans la console Amazon Cognito.

Dans l'onglet Messagerie, sous Modèles de messages, vous pouvez personnaliser :

Modèles de messages

Vous pouvez utiliser des modèles de message pour insérer des espaces réservés dans vos messages. Amazon Cognito remplace les espaces réservés par les valeurs correspondantes. Vous pouvez faire référence aux espaces réservés aux modèles universels dans les modèles de messages de tout type, bien que ces valeurs ne soient pas présentes dans tous les types de messages.

L'une des réponses automatisées disponibles avec des fonctionnalités de sécurité avancées consiste à informer l'utilisateur qu'Amazon Cognito a détecté une activité potentiellement malveillante. Vous pouvez utiliser des espaces réservés de modèle avec sécurité avancée pour effectuer les opérations suivantes :

Les fonctionnalités de sécurité avancées ajoutent les espaces réservés suivants que vous pouvez insérer dans les modèles de message :

Personnalisation du message SMS

Vous pouvez personnaliser le message SMS pour l'authentification multifactorielle (MFA) dans l'onglet Messagerie situé sous le titre Modèles de messages.

Amazon Cognito impose une longueur maximale pour les SMS, code d'authentification compris, avec 140 caractères UTF-8.

Personnalisation des messages de vérification par SMS

Vous pouvez personnaliser le message SMS envoyé pour vérifier le numéro de téléphone. Pour ce faire, modifiez le modèle sous la question Souhaitez-vous personnaliser vos messages de vérification par SMS ?.

La longueur maximale du message est de 140 caractères UTF-8, en comptant le code de vérification.

Personnalisation des messages de vérification d'adresse e-mail

Pour vérifier l'adresse e-mail d'un utilisateur de votre groupe d'utilisateurs avec Amazon Cognito, vous pouvez envoyer à l'utilisateur un message électronique contenant un lien qu'il peut sélectionner ou lui envoyer un code à saisir.

Pour personnaliser l'objet et le contenu du message pour les messages de vérification d'adresse e-mail, modifiez le modèle Message de vérification dans l'onglet Messagerie de votre groupe d'utilisateurs. Vous pouvez choisir un Type de vérification par Code ou Lien lorsque vous modifiez votre modèle Message de vérification.

Lorsque vous choisissez Code comme type de vérification, votre message personnalisé doit contenir l'espace réservé {####}. Quand vous envoyez ce message, le code de vérification remplace cet espace réservé.

Si vous choisissez Lien comme type de vérification, votre message personnalisé doit inclure un espace réservé au format {##Verify Your Email##}. Vous pouvez modifier la chaîne de texte entre les caractères d'espace réservé, par exemple {##Click here##}. Un lien de vérification intitulé Verify Your Email (Vérifiez votre adresse e-mail) remplace cet espace réservé.

Le lien vers un message de vérification par e-mail redirige votre utilisateur vers une URL comme dans l'exemple suivant.

https://<your user pool domain>/confirmUser/?client_id=abcdefg12345678&user_name=emailtest&confirmation_code=123456

La longueur maximale du message est de 20 000 caractères UTF-8, en comptant le code de vérification (le cas échéant). Vous pouvez utiliser des balises HTML dans ce message pour formater le contenu.

Personnalisation des messages d'invitation des utilisateurs

Vous pouvez personnaliser le message d'invitation des utilisateurs qu'Amazon Cognito envoie par SMS ou e-mail aux nouveaux utilisateurs en modifiant le modèle Messages d'invitation sous l'onglet Messagerie.

La longueur maximale d'un message SMS est de 140 caractères UTF-8, code de vérification inclus. La longueur maximale d'un message e-mail est de 20 000 caractères UTF-8, code de vérification inclus. Vous pouvez utiliser des balises HTML dans vos e-mails pour formater le contenu.

Personnalisation de votre adresse e-mail

Par défaut, les messages e-mail qu'Amazon Cognito envoie aux utilisateurs dans vos groupes d'utilisateurs arrivent par l'adresse no-reply@verificationemail.com. Vous pouvez choisir de spécifier des adresses e-mail DE et RÉPONDRE À personnalisées qui remplaceront no-reply@verificationemail.com.

Autoriser Amazon Cognito à envoyer des e-mails Amazon SES en votre nom (à partir d'une adresse DE personnalisée)

Vous pouvez configurer Amazon Cognito pour qu'il envoie des e-mails à partir d'une adresse e-mail DE personnalisée au lieu de son adresse par défaut. Pour utiliser une adresse personnalisée, vous devez autoriser Amazon Cognito à envoyer un e-mail à partir d'une identité vérifiée Amazon SES. Dans la plupart des cas, vous pouvez accorder une autorisation en créant une politique d'autorisation d'envoi. Pour plus d'informations, consultez la section Utilisation de l'autorisation d'envoi avec Amazon SES dans le Guide du développeur Amazon Simple Email Service.

Lorsque vous configurez un groupe d'utilisateurs pour qu'il utilise Amazon SES pour les e-mails, Amazon Cognito crée le rôle AWSServiceRoleForAmazonCognitoIdpEmailService dans votre compte pour accorder l'accès à Amazon SES. Aucune politique d'autorisation d'envoi n'est nécessaire lorsque le rôle lié à un service AWSServiceRoleForAmazonCognitoIdpEmailService est utilisé. Vous n'avez besoin d'ajouter une politique d'autorisation d'envoi que lorsque vous utilisez la fonctionnalité de messagerie par défaut de votre groupe d'utilisateurs et une identité Amazon SES vérifiée en tant qu'adresse DE.

Pour plus d'informations sur le rôle lié à un service créé par Amazon Cognito, consultez Utilisation de rôles liés à un service pour Amazon Cognito .

L'exemple suivant de politique d'autorisation d'envoi accorde à Amazon Cognito la possibilité limitée d'utiliser une identité vérifiée Amazon SES. Amazon Cognito ne peut envoyer des e-mails que lorsqu'il le fait pour le compte du groupe d'utilisateurs dans la condition aws:SourceArn et le compte dans la condition aws:SourceAccount. Pour d'autres exemples, consultez Exemples de politiques d'autorisation d'envoi Amazon SES dans le Guide du développeur Amazon Simple Email Service.

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Sid": "stmnt1234567891234",
            "Effect": "Allow",
            "Principal": {
                "Service": [
                    "email.cognito-idp.amazonaws.com"
                ]
            },
            "Action": [
                "SES:SendEmail",
                "SES:SendRawEmail"
            ],
            "Resource": "<your SES identity ARN>",
            "Condition": {
                "StringEquals": {
                    "aws:SourceAccount": "<your account number>"
                },
                "ArnLike": {
                    "aws:SourceArn": "<your user pool ARN>"
                }
            }
        }
    ]
}

La console Amazon Cognito vous ajoute une politique semblable lorsque vous sélectionnez une identité Amazon SES dans le menu déroulant. Si vous utilisez la CLI ou l'API pour configurer le groupe d'utilisateurs, vous devez attacher une politique structurée comme celle de l'exemple précédent à votre identité Amazon SES.