Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Trigger Lambda personalizzato SMS del mittente

Quando assegni un trigger SMS mittente personalizzato al tuo pool di utenti, Amazon Cognito richiama una funzione Lambda anziché il suo comportamento predefinito quando un evento utente richiede l'invio di un messaggio. SMS Con un trigger mittente personalizzato, la tua AWS Lambda funzione può inviare SMS notifiche ai tuoi utenti tramite un metodo e un provider di tua scelta. Il codice personalizzato della tua funzione deve elaborare e recapitare tutti i SMS messaggi dal tuo pool di utenti.

Questo trigger è utile per scenari in cui potresti voler avere un maggiore controllo sul modo in cui il tuo pool di utenti invia SMS i messaggi. La tua funzione Lambda può personalizzare la chiamata SNS API alle operazioni Amazon, ad esempio quando desideri gestire più origini o IDs incroci. Regioni AWS La tua funzione potrebbe anche reindirizzare i messaggi verso un altro mezzo di consegna o un servizio di terze parti.

Per usare questo trigger, esegui questi passaggi:

Parametri di attivazione Lambda del SMS mittente personalizzati

La richiesta passata da Amazon Cognito a questa funzione Lambda è una combinazione dei parametri seguenti e dei parametri comuni aggiunti da Amazon Cognito a tutte le richieste.

JSON

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

Parametri personalizzati della richiesta SMS del mittente

Parametri di SMS risposta personalizzati del mittente

Amazon Cognito non prevede di restituire ulteriori informazioni nella risposta. La funzione può utilizzare API operazioni per interrogare e modificare le risorse o registrare i metadati degli eventi su un sistema esterno.

Attivazione del trigger SMS Lambda personalizzato del mittente

Puoi impostare un trigger SMS mittente personalizzato che utilizza una logica personalizzata per inviare SMS messaggi per il tuo pool di utenti. La procedura seguente assegna un SMS trigger personalizzato, un trigger e-mail personalizzato o entrambi al pool di utenti. Dopo aver aggiunto il trigger SMS mittente personalizzato, Amazon Cognito invia sempre gli attributi utente, incluso il numero di telefono, e il codice monouso alla funzione Lambda anziché il comportamento predefinito che prevede l'invio di un SMS messaggio con Amazon Simple Notification Service.

Per rimuovere un trigger Lambda del mittente personalizzato con update-user-pool AWS CLI un, ometti CustomSMSSender il parametro CustomEmailSender o e --lambda-config includi tutti gli altri trigger che desideri utilizzare con il tuo pool di utenti.

Per rimuovere un trigger Lambda del mittente personalizzato con UpdateUserPool API una richiesta, ometti CustomSMSSender il parametro CustomEmailSender o dal corpo della richiesta che contiene il resto della configurazione del pool di utenti.

esempio di codice

Il seguente esempio di Node.js elabora un evento di SMS messaggio nella funzione Lambda SMS del mittente personalizzata. Per questo esempio si presuppone che la funzione abbia due variabili d'ambiente definite.

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

Valuta le funzionalità dei SMS messaggi con una funzione mittente personalizzata SMS

Una funzione Lambda del SMS mittente personalizzata accetta SMS i messaggi inviati dal pool di utenti e fornisce il contenuto in base alla logica personalizzata. Amazon Cognito invia i Parametri di attivazione Lambda del SMS mittente personalizzati alla tua funzione. La funzione può fare ciò che vuoi con queste informazioni. Ad esempio, puoi inviare il codice a un argomento di Amazon Simple Notification Service (AmazonSNS). Un abbonato ad Amazon SNS Topic può essere un SMS messaggio, un HTTPS endpoint o un indirizzo e-mail.

Per creare un ambiente di test per la SMS messaggistica di Amazon Cognito con una funzione Lambda del SMS mittente personalizzata, amazon-cognito-user-poolconsulta development-and-testing-with - sms-redirected-to-email - nella libreria aws-samples su. GitHub Il repository contiene AWS CloudFormation modelli che possono creare un nuovo pool di utenti o utilizzare un pool di utenti che già possiedi. Questi modelli creano funzioni Lambda e un argomento AmazonSNS. La funzione Lambda che il modello assegna come trigger SMS mittente personalizzato reindirizza i SMS messaggi agli abbonati all'argomento Amazon. SNS

Quando distribuisci questa soluzione a un pool di utenti, tutti i messaggi che Amazon Cognito di solito invia SMS tramite messaggistica, la funzione Lambda invia invece a un indirizzo e-mail centrale. Utilizza questa soluzione per personalizzare e visualizzare in anteprima SMS i messaggi e per testare gli eventi del pool di utenti che causano l'invio di un SMS messaggio da parte di Amazon Cognito. Dopo aver completato i test, ripristina lo CloudFormation stack o rimuovi l'assegnazione personalizzata della funzione SMS mittente dal tuo pool di utenti.

Sorgenti di attivazione Lambda personalizzate per SMS mittenti

La tabella seguente mostra l'evento di attivazione per le sorgenti di SMS trigger personalizzate nel codice Lambda.