Desencadenador de Lambda de posconfirmación.

Amazon Cognito invoca este desencadenador después de que un usuario registrado confirme su cuenta de usuario. En la función de Lambda posterior a la confirmación, puede enviar mensajes personalizados o agregar solicitudes de API personalizadas. Por ejemplo, puede consultar un sistema externo y rellenar atributos adicionales para el usuario. Amazon Cognito invoca este desencadenador solo para los usuarios que se registran en el grupo de usuarios, no para las cuentas de usuario que crea con las credenciales de administrador.

La solicitud contiene los atributos actuales del usuario confirmado.

Flujos de Lambda de posconfirmación

Flujo de confirmación de inscripción del cliente

Flujo de confirmación de inscripción del servidor.

Flujo de confirmación de contraseña olvidada

Parámetros del desencadenador de Lambda de posconfirmación

La solicitud que Amazon Cognito envía a esta función de Lambda es una combinación de los parámetros que se indican a continuación y los parámetros comunes que Amazon Cognito agrega a todas las solicitudes.

JSON

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

Parámetros de solicitud posterior a la confirmación

userAttributes

Uno o varios pares de clave-valor que representan atributos de usuario.

clientMetadata

Uno o varios pares de clave-valor que puede proporcionar como datos de entrada personalizados a la función de Lambda que especifique para el desencadenador de posconfirmación. Puede transferir estos datos a la función de Lambda mediante el parámetro ClientMetadata de las siguientes acciones de la API: AdminConfirmSignUp, ConfirmForgotPassword, ConfirmSignUp y SignUp.

Parámetros de la respuesta posterior a la confirmación

No se espera que la respuesta contenga información adicional.

Tutoriales de confirmación del usuario

La función de Lambda de posconfirmación se desencadena de inmediato en el momento posterior a que Amazon Cognito confirme un nuevo usuario. Consulte estos tutoriales de confirmación de usuario en JavaScript, Android e iOS.

Plataforma	Tutorial
SDK de identidad para JavaScript	Confirmación de usuarios con JavaScript
SDK de identidad para Android	Confirmación de usuarios con Android
SDK de identidad para iOS	Confirmación de usuarios con iOS

Ejemplo de invocación posterior a la confirmación

Mediante este función de Lambda de ejemplo, se envía un mensaje de correo electrónico de confirmación al usuario con Amazon SES. Para obtener más información, consulte la Guía para desarrolladores de Amazon Simple Email 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 transfiere la información del evento a la función de Lambda. A continuación, la función devuelve el mismo objeto de evento a Amazon Cognito con los cambios en la respuesta. En la consola de Lambda puede configurar un evento de prueba con los datos relevantes para el desencadenador de Lambda. El siguiente es un evento de prueba para este código de ejemplo:

JSON

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