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 di messaggi personalizzati

Se disponi di uno standard esterno per le e-mail e SMS i messaggi che desideri inviare agli utenti o se desideri applicare la tua logica in fase di esecuzione alla formattazione dei messaggi utente, aggiungi un trigger di messaggio personalizzato al tuo pool di utenti. Il messaggio personalizzato Lambda riceve il contenuto di tutte le e-mail e i SMS messaggi prima che il pool di utenti li invii. La funzione Lambda ha quindi l'opportunità di modificare il contenuto e l'oggetto del messaggio.

Amazon Cognito richiama questo trigger prima di inviare un messaggio di verifica via e-mail o telefono o un codice di autenticazione a più fattori (). MFA È possibile personalizzare il messaggio in modo dinamico con il trigger di messaggio personalizzato. Per modificare i messaggi personalizzati statici, vai alla scheda Message customizations (Personalizzazioni del messaggio) della console originale di Amazon Cognito.

La richiesta include codeParameter. Questa è una stringa che agisce da segnaposto per il codice che Amazon Cognito fornisce all'utente. Inserisci la stringa codeParameter nel corpo del messaggio, nella posizione in cui desideri che appaia il codice di verifica. Alla ricezione di questa risposta, Amazon Cognito sostituisce la stringa codeParameter con il codice di verifica effettivo.

Origini dei trigger Lambda di messaggi personalizzati

Parametri del trigger Lambda di messaggi 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": {
        "userAttributes": {
            "string": "string",
            . . .
        }
        "codeParameter": "####",
        "usernameParameter": "string",
        "clientMetadata": {
            "string": "string",
            . . .
        }
    },
    "response": {
        "smsMessage": "string",
        "emailMessage": "string",
        "emailSubject": "string"
    }
}

Parametri di richiesta di messaggi personalizzati

Parametri di risposta di messaggi personalizzati

Nella risposta, specifica il testo personalizzato da usare nei messaggi destinati agli utenti. Per i vincoli di stringa che Amazon Cognito applica a questi parametri, consulta. MessageTemplateType

Messaggio personalizzato per un esempio di registrazione

Questo esempio di funzione Lambda personalizza un'e-mail o un SMS messaggio quando il servizio richiede un'app per inviare un codice di verifica all'utente.

Amazon Cognito può richiamare un trigger Lambda durante più eventi: dopo la registrazione, per rinviare un codice di verifica, nel caso di una password dimenticata o per verificare un attributo utente. La risposta include messaggi sia per posta elettronica che SMS per posta elettronica. Il messaggio deve includere il parametro di codice "####". Questo parametro è il segnaposto per il codice di verifica che l'utente riceve.

La lunghezza massima di un messaggio di posta elettronica è di 20.000 UTF -8 caratteri,. Questa lunghezza include il codice di verifica. È possibile utilizzare i HTML tag in questi messaggi e-mail.

La lunghezza massima dei SMS messaggi è di 140 UTF -8 caratteri. Questa lunghezza include il codice di verifica.

Node.js

const handler = async (event) => {
  if (event.triggerSource === "CustomMessage_SignUp") {
    const message = `Thank you for signing up. Your confirmation code is ${event.request.codeParameter}.`;
    event.response.smsMessage = message;
    event.response.emailMessage = message;
    event.response.emailSubject = "Welcome to the service.";
  }
  return event;
};

export { handler };

Amazon Cognito trasferisce informazioni sugli eventi alla funzione Lambda. La funzione quindi restituisce a Amazon Cognito lo stesso oggetto evento con eventuali modifiche nella risposta. Nella console Lambda puoi configurare un evento di test con i dati pertinenti al trigger Lambda. Di seguito è riportato un evento di test per questo esempio di codice:

JSON

{
	"version": "1",
	"region": "us-west-2",
	"userPoolId": "us-west-2_EXAMPLE",
	"userName": "test-user",
	"callerContext": {
		"awsSdkVersion": "aws-sdk-unknown-unknown",
		"clientId": "1example23456789"
	},
	"triggerSource": "CustomMessage_SignUp",
	"request": {
		"userAttributes": {
			"sub": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
			"cognito:user_status": "CONFIRMED",
			"email_verified": "true",
			"phone_number_verified": "true",
			"phone_number": "+12065551212",
			"email": "test-user@example.com"
		},
		"codeParameter": "{####}",
		"linkParameter": "{##Click Here##}",
		"usernameParameter": "None"
	},
	"response": {
		"smsMessage": "None",
		"emailMessage": "None",
		"emailSubject": "None"
	}
}

Messaggio personalizzato per un esempio di amministratore che crea un utente

La richiesta che Amazon Cognito ha inviato a questo esempio di messaggio personalizzato (funzione Lambda) ha un triggerSource valore di, un nome utente CustomMessage_AdminCreateUser e una password temporanea. La funzione viene compilata ${event.request.codeParameter} a partire dalla password temporanea nella richiesta e ${event.request.usernameParameter} dal nome utente nella richiesta.

I messaggi personalizzati devono inserire i valori di codeParameter e usernameParameter dentro smsMessage e emailMessage nell'oggetto di risposta. In questo esempio, la funzione scrive lo stesso messaggio nei campi di risposta event.response.smsMessage eevent.response.emailMessage.

La lunghezza massima di un messaggio di posta elettronica è di 20.000 UTF -8 caratteri. Questa lunghezza include il codice di verifica. Puoi usare i HTML tag in queste e-mail. La lunghezza massima dei SMS messaggi è di 140 UTF -8 caratteri. Questa lunghezza include il codice di verifica.

La risposta include messaggi sia SMS per posta elettronica che per posta elettronica.

Node.js

const handler = async (event) => {
  if (event.triggerSource === "CustomMessage_AdminCreateUser") {
    const message = `Welcome to the service. Your user name is ${event.request.usernameParameter}. Your temporary password is ${event.request.codeParameter}`;
    event.response.smsMessage = message;
    event.response.emailMessage = message;
    event.response.emailSubject = "Welcome to the service";
  }
  return event;
};

export { handler };

Amazon Cognito trasferisce informazioni sugli eventi alla funzione Lambda. La funzione quindi restituisce a Amazon Cognito lo stesso oggetto evento con eventuali modifiche nella risposta. Nella console Lambda puoi configurare un evento di test con i dati pertinenti al trigger Lambda. Di seguito è riportato un evento di test per questo esempio di codice:

JSON

{
  "version": 1,
  "triggerSource": "CustomMessage_AdminCreateUser",
  "region": "<region>",
  "userPoolId": "<userPoolId>",
  "userName": "<userName>",
  "callerContext": {
      "awsSdk": "<calling aws sdk with version>",
      "clientId": "<apps client id>",
      ...
  },
  "request": {
      "userAttributes": {
          "phone_number_verified": false,
          "email_verified": true,
           ...
      },
      "codeParameter": "####",
      "usernameParameter": "username"
  },
  "response": {
      "smsMessage": "<custom message to be sent in the message with code parameter and username parameter>"
      "emailMessage": "<custom message to be sent in the message with code parameter and username parameter>"
      "emailSubject": "<custom email subject>"
  }
}