Déclencheur Lambda après confirmation.

Amazon Cognito invoque ce déclencheur après qu'un utilisateur inscrit a confirmé son compte d'utilisateur. Dans votre fonction Lambda après confirmation, vous pouvez envoyer des messages personnalisés ou ajouter des demandes d'API personnalisées. Par exemple, vous pouvez interroger un système externe et renseigner des attributs supplémentaires pour l'utilisateur. Amazon Cognito invoque ce déclencheur uniquement pour les utilisateurs qui s'inscrivent dans votre groupe d'utilisateurs, et non pour les comptes d'utilisateur que vous créez avec vos informations d'identification d'administrateur.

La demande contient les attributs actuels pour l'utilisateur confirmé.

Flux Lambda après confirmation

Flux d'inscription de confirmation client

Flux d'inscription de confirmation serveur

Flux de confirmation pour l'oubli de mot de passe

Paramètres du déclencheur Lambda après confirmation

La demande qu'Amazon Cognito transmet à cette fonction Lambda est une combinaison des paramètres ci-dessous et des paramètres courants qu'Amazon Cognito ajoute à toutes les demandes.

JSON

{
    "request": {
            "userAttributes": {
                "string": "string",
                . . .
            },
            "clientMetadata": {
            	"string": "string",
            	. . .
            }
        },
    "response": {}
}

Paramètres de demande après confirmation

userAttributes

Une ou plusieurs paires clé-valeur représentant des attributs utilisateur.

clientMetadata

Une ou plusieurs paires clé-valeur que vous pouvez fournir en tant qu'entrée personnalisée pour la fonction Lambda que vous spécifiez pour le déclencheur Après confirmation. Vous pouvez transmettre ces données à votre fonction Lambda à l'aide du paramètre ClientMetadata dans les actions d'API suivantes : AdminConfirmSignUp, ConfirmForgotPassword, ConfirmSignUp et SignUp.

Paramètres de réponse après confirmation

Aucune information de retour supplémentaire n'est prévue dans la réponse.

Didacticiels relatifs à la confirmation de l'utilisateur

La fonction Lambda Après confirmation est déclenchée juste après qu'Amazon Cognito confirme un nouvel utilisateur. Consultez ces didacticiels relatifs à la confirmation d'un utilisateur pour JavaScript, Android et iOS.

Plateforme	Didacticiel
Kit SDK d'identité pour JavaScript	Confirmez des utilisateurs avec JavaScript
Kit SDK d'identité pour Android	Confirmez des utilisateurs avec Android
Kit SDK d'identité pour iOS	Confirmez des utilisateurs avec iOS

Exemple de stade après confirmation

Cet exemple de fonction Lambda envoie un e-mail de confirmation à votre utilisateur à l'aide d'Amazon SES. Pour plus d'informations, consultez le Manuel du développeur Amazon Simple Storage Service.

Node.js

// Import required AWS SDK clients and commands for Node.js. Note that this requires
// the `@aws-sdk/client-ses` module to be either bundled with this code or included
// as a Lambda layer.
import { SES, SendEmailCommand } from "@aws-sdk/client-ses";
const ses = new SES();

const handler = async (event) => {
  if (event.request.userAttributes.email) {
    await sendTheEmail(
      event.request.userAttributes.email,
      `Congratulations ${event.userName}, you have been confirmed.`
    );
  }
  return event;
};

const sendTheEmail = async (to, body) => {
  const eParams = {
    Destination: {
      ToAddresses: [to],
    },
    Message: {
      Body: {
        Text: {
          Data: body,
        },
      },
      Subject: {
        Data: "Cognito Identity Provider registration completed",
      },
    },
    // Replace source_email with your SES validated email address
    Source: "<source_email>",
  };
  try {
    await ses.send(new SendEmailCommand(eParams));
  } catch (err) {
    console.log(err);
  }
};

export { handler };

Amazon Cognito transmet les informations d'événement à votre fonction Lambda. Cette fonction renvoie alors le même objet d'événement à Amazon Cognito, avec d'éventuelles modifications dans la réponse. Dans la console Lambda, vous pouvez configurer un événement de test avec des données pertinentes pour votre déclencheur Lambda. Voici un événement de test pour cet exemple de code :

JSON

{
    "request": {
        "userAttributes": {
            "email": "[e-mail]",
            "email_verified": true
        }
    },
    "response": {}
}