As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Acionador SMS Lambda personalizado do remetente

Quando você atribui um gatilho de SMS remetente personalizado ao seu grupo de usuários, o Amazon Cognito invoca uma função Lambda em vez de seu comportamento padrão quando um evento do usuário exige que ele envie uma mensagem. SMS Com um gatilho de remetente personalizado, sua AWS Lambda função pode enviar SMS notificações aos seus usuários por meio de um método e provedor de sua escolha. O código personalizado da sua função deve processar e entregar todas as SMS mensagens do seu grupo de usuários.

Esse gatilho serve para cenários em que talvez você queira ter maior controle sobre como seu grupo de usuários envia SMS mensagens. Sua função Lambda pode personalizar a chamada para as SNS API operações da Amazon, por exemplo, quando você deseja gerenciar várias originações ou cruzamentos. IDs Regiões da AWS Sua função também pode redirecionar mensagens para outro meio de entrega ou serviço de terceiros.

Para configurar esse acionador, execute as seguintes etapas:

Parâmetros de SMS gatilho Lambda personalizados do remetente

A solicitação que o Amazon Cognito transmite para essa função do Lambda é uma combinação dos parâmetros abaixo e dos parâmetros comuns que o Amazon Cognito adiciona a todas as solicitações.

JSON

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

Parâmetros personalizados SMS de solicitação do remetente

Parâmetros personalizados SMS de resposta do remetente

O Amazon Cognito não espera nenhuma outra informação de retorno na resposta. Sua função pode usar API operações para consultar e modificar seus recursos ou registrar metadados de eventos em um sistema externo.

Ativando o gatilho SMS Lambda personalizado do remetente

Você pode configurar um gatilho de SMS remetente personalizado que usa lógica personalizada para enviar SMS mensagens para seu grupo de usuários. O procedimento a seguir atribui um SMS gatilho personalizado, um gatilho de e-mail personalizado ou ambos ao seu grupo de usuários. Depois de adicionar seu gatilho de SMS remetente personalizado, o Amazon Cognito sempre envia atributos do usuário, incluindo o número de telefone e o código único para sua função Lambda, em vez do comportamento padrão que envia uma SMS mensagem com o Amazon Simple Notification Service.

Para remover um gatilho Lambda personalizado do remetente com update-user-pool AWS CLI um, omita CustomSMSSender o parâmetro CustomEmailSender --lambda-config or e inclua todos os outros gatilhos que você deseja usar com seu grupo de usuários.

Para remover um gatilho Lambda personalizado do remetente com UpdateUserPool API uma solicitação, omita CustomSMSSender o parâmetro CustomEmailSender or do corpo da solicitação que contém o restante da configuração do seu grupo de usuários.

Exemplo de código

O exemplo de Node.js a seguir processa um evento de SMS mensagem na função Lambda personalizada do SMS remetente. Esse exemplo pressupõe que a função tenha duas variáveis de ambiente 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;
};

Avalie os recursos de SMS mensagens com uma função de SMS remetente personalizada

Uma função Lambda de SMS remetente personalizada aceita SMS as mensagens que seu grupo de usuários enviaria, e a função entrega o conteúdo com base em sua lógica personalizada. O Amazon Cognito envia o Parâmetros de SMS gatilho Lambda personalizados do remetente para sua função. Sua função pode fazer o que você quiser com essas informações. Por exemplo, você pode enviar o código para um tópico do Amazon Simple Notification Service (AmazonSNS). Um assinante do Amazon SNS Topic pode ser uma SMS mensagem, um HTTPS endpoint ou um endereço de e-mail.

Para criar um ambiente de teste para SMS mensagens do Amazon Cognito com uma função Lambda personalizada do SMS remetente, amazon-cognito-user-poolconsulte development-and-testing-with - sms-redirected-to-email - na biblioteca aws-samples em. GitHub O repositório contém AWS CloudFormation modelos que podem criar um novo grupo de usuários ou trabalhar com um grupo de usuários que você já tem. Esses modelos criam funções Lambda e um tópico da AmazonSNS. A função Lambda, que o modelo atribui como um gatilho de SMS remetente personalizado, redireciona suas SMS mensagens para os assinantes do tópico da Amazon. SNS

Quando você implanta essa solução em um grupo de usuários, todas as mensagens que o Amazon Cognito geralmente envia por meio de SMS mensagens, a função Lambda envia para um endereço de e-mail central. Use essa solução para personalizar e visualizar SMS mensagens e testar os eventos do grupo de usuários que fazem com que o Amazon Cognito envie uma SMS mensagem. Depois de concluir seus testes, reverta a CloudFormation pilha ou remova a atribuição personalizada da função de SMS remetente do seu grupo de usuários.

Fontes personalizadas de SMS gatilho Lambda do remetente

A tabela a seguir mostra o evento de acionamento para fontes de SMS gatilho personalizadas em seu código Lambda.