Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Activador SMS Lambda de remitente personalizado

Al asignar un activador de SMS remitente personalizado a su grupo de usuarios, Amazon Cognito invoca una función Lambda en lugar de su comportamiento predeterminado cuando un evento de usuario requiere que envíe un mensaje. SMS Con un activador de remitente personalizado, su AWS Lambda función puede enviar SMS notificaciones a sus usuarios a través del método y el proveedor que elija. El código personalizado de tu función debe procesar y entregar todos los SMS mensajes de tu grupo de usuarios.

Este activador sirve para situaciones en las que es posible que desee tener un mayor control sobre la forma en que su grupo de usuarios envía SMS los mensajes. Su función Lambda puede personalizar la llamada a SNS API las operaciones de Amazon, por ejemplo, cuando quiere gestionar múltiples orígenes o cruces. IDs Regiones de AWS Tu función también podría redirigir los mensajes a otro medio de entrega o a un servicio de terceros.

Para usar este desencadenador, siga estos pasos:

Parámetros de SMS activación Lambda de remitente personalizados

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": {
        "type": "customSMSSenderRequestV1",
        "code": "string",
        "clientMetadata": {
            "string": "string",
             . . .
            },
        "userAttributes": {
            "string": "string",
            . . .
         }
}

Parámetros de solicitud de SMS remitente personalizados

Parámetros de respuesta SMS del remitente personalizados

Amazon Cognito no espera ninguna información de devolución adicional en la respuesta. La función puede utilizar API operaciones para consultar y modificar los recursos o registrar los metadatos de los eventos en un sistema externo.

Activación del disparador SMS Lambda del remitente personalizado

Puede configurar un activador de SMS envío personalizado que utilice una lógica personalizada para enviar SMS mensajes a su grupo de usuarios. El siguiente procedimiento asigna un SMS activador personalizado, un activador de correo electrónico personalizado o ambos a su grupo de usuarios. Tras añadir el activador de SMS remitente personalizado, Amazon Cognito siempre envía los atributos del usuario, incluidos el número de teléfono y el código de un solo uso, a la función Lambda, en lugar del comportamiento predeterminado que envía un mensaje SMS con Amazon Simple Notification Service.

Para eliminar un disparador Lambda de remitente personalizado con un update-user-pool AWS CLI, omita el CustomEmailSender parámetro CustomSMSSender o e incluya todos los demás activadores que desee usar con su grupo de usuarios. --lambda-config

Para eliminar un activador Lambda de remitente personalizado con una UpdateUserPool API solicitud, omita el CustomEmailSender parámetro CustomSMSSender o del cuerpo de la solicitud que contiene el resto de la configuración del grupo de usuarios.

Ejemplo de código

El siguiente ejemplo de Node.js procesa un evento de SMS mensaje en la función Lambda de SMS remitente personalizada. En este ejemplo se supone que la función tiene dos variables de entorno definidas.

const AWS = require('aws-sdk');
const b64 = require('base64-js');
const encryptionSdk = require('@aws-crypto/client-node');
//Configure the encryption SDK client with the KMS key from the environment variables.  
const { encrypt, decrypt } = encryptionSdk.buildClient(encryptionSdk.CommitmentPolicy.REQUIRE_ENCRYPT_ALLOW_DECRYPT);
const generatorKeyId = process.env.KEY_ALIAS;
const keyIds = [ process.env.KEY_ARN ];
const keyring = new encryptionSdk.KmsKeyringNode({ generatorKeyId, keyIds })
exports.handler = async (event) => {
	//Decrypt the secret code using encryption SDK.
	let plainTextCode;
	if(event.request.code){
		const { plaintext, messageHeader } = await decrypt(keyring, b64.toByteArray(event.request.code));
		plainTextCode = plaintext
	}
	//PlainTextCode now contains the decrypted secret.
	if(event.triggerSource == 'CustomSMSSender_SignUp'){
		//Send an SMS message to your user via a custom provider.
		//Include the temporary password in the message.
	}
	else if(event.triggerSource == 'CustomSMSSender_ResendCode'){
	}
	else if(event.triggerSource == 'CustomSMSSender_ForgotPassword'){
	}
	else if(event.triggerSource == 'CustomSMSSender_UpdateUserAttribute'){
	}
	else if(event.triggerSource == 'CustomSMSSender_VerifyUserAttribute'){
	}
	else if(event.triggerSource == 'CustomSMSSender_AdminCreateUser'){
	}
	else if(event.triggerSource == 'CustomSMSSender_AccountTakeOverNotification'){
	}
	return;
};

Evalúe las capacidades de los SMS mensajes con una función de remitente personalizada SMS

Una función Lambda de SMS remitente personalizado acepta los SMS mensajes que el grupo de usuarios enviaría y entrega el contenido en función de la lógica personalizada. Amazon Cognito envía el Parámetros de SMS activación Lambda de remitente personalizados a su función. Su función puede hacer lo que desee con esta información. Por ejemplo, puedes enviar el código a un tema de Amazon Simple Notification Service (AmazonSNS). Un suscriptor a un SNS tema de Amazon puede ser un SMS mensaje, un HTTPS punto final o una dirección de correo electrónico.

Para crear un entorno de prueba para la SMS mensajería de Amazon Cognito con una función SMS Lambda de remitente personalizada, consulte amazon-cognito-user-pool- development-and-testing-with - sms-redirected-to-email en la biblioteca aws-samples en. GitHub El repositorio contiene AWS CloudFormation plantillas que pueden crear un nuevo grupo de usuarios o funcionar con un grupo de usuarios del que ya disponga. Estas plantillas crean funciones de Lambda y un tema de AmazonSNS. La función Lambda que la plantilla asigna como activador de SMS remitente personalizado redirige tus SMS mensajes a los suscriptores del tema de Amazon. SNS

Al implementar esta solución en un grupo de usuarios, la función Lambda envía todos los mensajes que Amazon Cognito suele SMS enviar a través de mensajería a una dirección de correo electrónico central. Utilice esta solución para personalizar y previsualizar SMS los mensajes y para probar los eventos del grupo de usuarios que hacen que Amazon Cognito envíe un SMS mensaje. Tras completar las pruebas, revierta la CloudFormation pila o elimine la asignación de funciones de SMS remitente personalizadas de su grupo de usuarios.

Fuentes de SMS activación Lambda de remitentes personalizados

En la siguiente tabla, se muestra el evento de activación de las fuentes de SMS activación personalizadas en el código Lambda.