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.

SMSDéclencheur Lambda d'expéditeur personnalisé

Lorsque vous attribuez un déclencheur d'SMSexpéditeur personnalisé à votre groupe d'utilisateurs, Amazon Cognito invoque une fonction Lambda au lieu de son comportement par défaut lorsqu'un événement utilisateur nécessite l'envoi d'un message. SMS Grâce à un déclencheur d'expéditeur personnalisé, votre AWS Lambda fonction peut envoyer SMS des notifications à vos utilisateurs par le biais d'une méthode et d'un fournisseur de votre choix. Le code personnalisé de votre fonction doit traiter et transmettre tous les SMS messages de votre groupe d'utilisateurs.

Ce déclencheur répond aux scénarios dans lesquels vous souhaiterez peut-être avoir un meilleur contrôle sur la manière dont votre groupe d'utilisateurs envoie SMS des messages. Votre fonction Lambda peut personnaliser l'appel aux SNS API opérations Amazon, par exemple lorsque vous souhaitez gérer plusieurs origines ou croisements. IDs Régions AWS Votre fonction peut également rediriger les messages vers un autre support de diffusion ou un service tiers.

Pour configurer ce déclencheur, effectuez les opérations suivantes :

Paramètres de déclenchement Lambda de SMS l'expéditeur personnalisés

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

Paramètres de demande d'SMSexpéditeur personnalisés

Paramètres de réponse personnalisés de SMS l'expéditeur

Amazon Cognito n'attend aucune information de retour supplémentaire dans la réponse. Votre fonction peut utiliser API des opérations pour interroger et modifier vos ressources, ou enregistrer les métadonnées des événements sur un système externe.

Activation du SMS déclencheur Lambda de l'expéditeur personnalisé

Vous pouvez configurer un déclencheur d'SMSexpéditeur personnalisé qui utilise une logique personnalisée pour envoyer SMS des messages à votre groupe d'utilisateurs. La procédure suivante affecte un SMS déclencheur personnalisé, un déclencheur d'e-mail personnalisé, ou les deux, à votre groupe d'utilisateurs. Une fois que vous avez ajouté votre déclencheur d'SMSexpéditeur personnalisé, Amazon Cognito envoie toujours les attributs utilisateur, y compris le numéro de téléphone, et le code à usage unique à votre fonction Lambda au lieu du comportement par défaut qui envoie un message SMS avec Amazon Simple Notification Service.

Pour supprimer un déclencheur Lambda d'expéditeur personnalisé avec un update-user-pool AWS CLI, omettez le CustomEmailSender paramètre CustomSMSSender or et incluez tous les autres déclencheurs que vous souhaitez utiliser avec votre groupe d'utilisateurs. --lambda-config

Pour supprimer un déclencheur Lambda d'expéditeur personnalisé avec une UpdateUserPool API demande, omettez le CustomEmailSender paramètre CustomSMSSender or dans le corps de la demande qui contient le reste de la configuration de votre groupe d'utilisateurs.

Exemple de code

L'exemple Node.js suivant traite un événement de SMS message dans votre fonction Lambda d'SMSexpéditeur personnalisée. Cet exemple suppose que votre fonction possède deux variables d'environnement définies.

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;
};

Évaluez les capacités des SMS messages à l'aide d'une fonction d'SMSexpéditeur personnalisée

Une fonction Lambda d'SMSexpéditeur personnalisée accepte les SMS messages que votre groupe d'utilisateurs enverrait, et la fonction fournit le contenu en fonction de votre logique personnalisée. Amazon Cognito envoie les Paramètres de déclenchement Lambda de SMS l'expéditeur personnalisés à votre fonction. Votre fonction peut traiter ces informations comme vous le souhaitez. Par exemple, vous pouvez envoyer le code à une rubrique Amazon Simple Notification Service (AmazonSNS). Un abonné à une SNS rubrique Amazon peut être un SMS message, un HTTPS point de terminaison ou une adresse e-mail.

Pour créer un environnement de test pour la SMS messagerie Amazon Cognito avec une fonction SMS Lambda d'expéditeur personnalisée, consultez amazon-cognito-user-pool- development-and-testing-with - sms-redirected-to-email dans la bibliothèque aws-samples sur. GitHub Le référentiel contient des AWS CloudFormation modèles qui peuvent créer un nouveau groupe d'utilisateurs ou fonctionner avec un groupe d'utilisateurs que vous possédez déjà. Ces modèles créent des fonctions Lambda et une rubrique AmazonSNS. La fonction Lambda que le modèle attribue comme déclencheur d'SMSexpéditeur personnalisé redirige vos SMS messages vers les abonnés de la rubrique Amazon. SNS

Lorsque vous déployez cette solution auprès d'un groupe d'utilisateurs, tous les messages qu'Amazon Cognito envoie habituellement par SMS messagerie sont envoyés par la fonction Lambda à une adresse e-mail centrale. Utilisez cette solution pour personnaliser et prévisualiser les SMS messages, ainsi que pour tester les événements du groupe d'utilisateurs à l'origine de l'envoi d'un SMS message par Amazon Cognito. Une fois les tests terminés, annulez la CloudFormation pile ou supprimez l'attribution personnalisée de la fonction d'SMSexpéditeur de votre groupe d'utilisateurs.

Sources de déclenchement Lambda personnalisées pour les SMS expéditeurs

Le tableau suivant montre l'événement déclencheur pour les sources de SMS déclenchement personnalisées dans votre code Lambda.