Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Lambda-Trigger mit benutzerdefiniertem SMS Absender

Wenn Sie Ihrem Benutzerpool einen benutzerdefinierten SMS Absender-Trigger zuweisen, ruft Amazon Cognito statt seines Standardverhaltens eine Lambda-Funktion auf, wenn ein Benutzerereignis das Senden einer Nachricht erfordert. SMS Mit einem benutzerdefinierten Absender-Trigger kann Ihre AWS Lambda Funktion SMS Benachrichtigungen über eine von Ihnen gewählte Methode und einen Anbieter an Ihre Benutzer senden. Der benutzerdefinierte Code Ihrer Funktion muss alle SMS Nachrichten aus Ihrem Benutzerpool verarbeiten und übermitteln.

Dieser Trigger eignet sich für Szenarien, in denen Sie möglicherweise mehr Kontrolle darüber haben möchten, wie Ihr Benutzerpool SMS Nachrichten sendet. Ihre Lambda-Funktion kann den Aufruf von SNS API Amazon-Vorgängen anpassen, z. B. wenn Sie mehrere Originationen IDs oder Kreuzungen verwalten möchten. AWS-Regionen Ihre Funktion kann auch Nachrichten an ein anderes Übermittlungsmedium oder einen Drittanbieter-Service weiterleiten.

Führen Sie zur Einrichtung dieses Auslösers die folgenden Schritte aus:

Benutzerdefinierte Lambda-Triggerparameter für SMS Absender

Die Anforderung, die Amazon Cognito an diese Lambda-Funktion übergibt, ist eine Kombination der folgenden Parameter und der allgemeinen Parameter, die Amazon Cognito allen Anfragen hinzufügt.

JSON

{
    "request": {
        "type": "customSMSSenderRequestV1",
        "code": "string",
        "clientMetadata": {
            "string": "string",
             . . .
            },
        "userAttributes": {
            "string": "string",
            . . .
         }
}

Benutzerdefinierte SMS Absenderanforderungsparameter

Benutzerdefinierte SMS Antwortparameter des Absenders

Amazon Cognito erwartet keine zusätzlichen Rückgabeinformationen in der Antwort. Ihre Funktion kann API Operationen verwenden, um Ihre Ressourcen abzufragen und zu ändern oder Ereignismetadaten in einem externen System aufzuzeichnen.

Lambda-Trigger mit benutzerdefiniertem SMS Absender aktivieren

Sie können einen benutzerdefinierten SMS Absender-Trigger einrichten, der benutzerdefinierte Logik verwendet, um SMS Nachrichten für Ihren Benutzerpool zu senden. Mit dem folgenden Verfahren wird Ihrem Benutzerpool ein benutzerdefinierter SMS Trigger, ein benutzerdefinierter E-Mail-Trigger oder beides zugewiesen. Nachdem Sie Ihren benutzerdefinierten SMS Absender-Trigger hinzugefügt haben, sendet Amazon Cognito immer Benutzerattribute, einschließlich der Telefonnummer und des Einmalcodes, an Ihre Lambda-Funktion, anstatt das Standardverhalten, das eine SMS Nachricht mit Amazon Simple Notification Service sendet.

Um einen benutzerdefinierten Lambda-Sender-Trigger mit einem zu entfernen update-user-pool AWS CLI, lassen Sie den CustomEmailSender Parameter CustomSMSSender oder von weg --lambda-config und schließen Sie alle anderen Trigger ein, die Sie mit Ihrem Benutzerpool verwenden möchten.

Um einen benutzerdefinierten Lambda-Sender-Trigger mit einer UpdateUserPool API Anfrage zu entfernen, lassen Sie den CustomEmailSender Parameter CustomSMSSender oder aus dem Anforderungstext weg, der den Rest Ihrer Benutzerpoolkonfiguration enthält.

Codebeispiel

Das folgende Beispiel für Node.js verarbeitet ein SMS Nachrichtenereignis in Ihrer benutzerdefinierten SMS Lambda-Absenderfunktion. In diesem Beispiel wird davon ausgegangen, dass Ihre Funktion zwei Umgebungsvariablen definiert hat.

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

Evaluieren Sie die SMS Nachrichtenfunktionen mit einer benutzerdefinierten Absenderfunktion SMS

Eine benutzerdefinierte SMS Lambda-Absenderfunktion akzeptiert die SMS Nachrichten, die Ihr Benutzerpool senden würde, und die Funktion liefert den Inhalt auf der Grundlage Ihrer benutzerdefinierten Logik. Amazon Cognito sendet die Benutzerdefinierte Lambda-Triggerparameter für SMS Absender an Ihre Funktion. Ihre Funktion kann diese Informationen nach Ihren Wünschen verarbeiten. Sie können den Code beispielsweise an ein Amazon Simple Notification Service (AmazonSNS) -Thema senden. Ein SNS Amazon-Thema-Abonnent kann eine SMS Nachricht, ein HTTPS Endpunkt oder eine E-Mail-Adresse sein.

Informationen zum Erstellen einer Testumgebung für Amazon Cognito SMS Messaging mit einer benutzerdefinierten SMS Lambda-Absenderfunktion finden Sie unter amazon-cognito-user-pool- development-and-testing-with - sms-redirected-to-email in der aws-samples-Bibliothek unter. GitHub Das Repository enthält AWS CloudFormation Vorlagen, mit denen Sie einen neuen Benutzerpool erstellen oder mit einem Benutzerpool arbeiten können, den Sie bereits haben. Diese Vorlagen erstellen Lambda-Funktionen und ein SNS Amazon-Thema. Die Lambda-Funktion, die die Vorlage als benutzerdefinierter SMS Absender-Trigger zuweist, leitet Ihre SMS Nachrichten an die Abonnenten zum SNS Amazon-Thema weiter.

Wenn Sie diese Lösung in einem Benutzerpool bereitstellen, sendet die Lambda-Funktion stattdessen alle Nachrichten, die Amazon Cognito normalerweise per SMS Messaging sendet, an eine zentrale E-Mail-Adresse. Verwenden Sie diese Lösung, um SMS Nachrichten anzupassen und in der Vorschau anzuzeigen und um die Benutzerpool-Ereignisse zu testen, die Amazon Cognito veranlassen, eine SMS Nachricht zu senden. Nachdem Sie Ihre Tests abgeschlossen haben, setzen Sie den CloudFormation Stack zurück oder entfernen Sie die benutzerdefinierte SMS Absenderfunktionszuweisung aus Ihrem Benutzerpool.

Lambda-Triggerquellen für benutzerdefinierte SMS Absender

Die folgende Tabelle zeigt das auslösende Ereignis für benutzerdefinierte SMS Triggerquellen in Ihrem Lambda-Code.