Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

自定义SMS发件人 Lambda 触发器

当您为用户池分配自定义发SMS件人触发器时，当用户事件要求其发送消息时，Amazon Cognito 会调用 Lambda 函数，而不是其默认行为。SMS使用自定义发件人触发器，您的 Amazon Lambda 函数可以通过您选择的方法和提供商向用户发送SMS通知。您的函数的自定义代码必须处理和传送用户池中的所有SMS消息。

此触发器适用于您可能希望更好地控制用户池发送SMS消息的方式。您的 Lambda 函数可以自定义对 Amazon SNS API 操作的调用，例如，当您想要管理多个起源或IDs交叉时。 Amazon Web Services 区域您的函数还可能将消息重定向到其他传送媒体或第三方服务。

要设置此触发器，请执行以下步骤：

自定义SMS发件人 Lambda 触发器参数

Amazon Cognito 传递给此 Lambda 函数的请求是以下参数和 Amazon Cognito 添加到所有请求中的常用参数的组合。

JSON

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

自定义SMS发件人请求参数

自定义SMS发件人响应参数

Amazon Cognito 不需要响应中任何额外的返回信息。您的函数可以使用API操作来查询和修改您的资源，或者将事件元数据记录到外部系统。

激活自定义SMS发送器 Lambda 触发器

您可以设置自定义发SMS件人触发器，该触发器使用自定义逻辑向您的用户池发送SMS消息。以下过程将自定义SMS触发器、自定义电子邮件触发器或两者分配给您的用户池。添加自定义发SMS件人触发器后，Amazon Cognito 始终将用户属性（包括电话号码和一次性代码）发送到您的 Lambda 函数，而不是SMS使用亚马逊简单通知服务发送消息的默认行为。

要删除带有的自定义发件人 Lambda 触发器 update-user-pool Amazon CLI，请省略CustomSMSSender或CustomEmailSender参数--lambda-config，并包含您要与用户池一起使用的所有其他触发器。

要删除带有UpdateUserPoolAPI请求的自定义发送者 Lambda 触发器，请省略包含用户池其余配置的请求正文中的CustomSMSSender或CustomEmailSender参数。

代码示例

以下 Node.js 示例在您的自定义SMS发送器 Lambda 函数中处理SMS消息事件。此示例假设您的函数定义了两个环境变量。

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

使用自定义SMS发件人函数评估SMS消息功能

自定义SMS发送者 Lambda 函数接受您的用户池将要发送的SMS消息，该函数根据您的自定义逻辑传递内容。Amazon Cognito 将 自定义SMS发件人 Lambda 触发器参数 发送到您的函数。您的函数可以用这些信息做您想做的事。例如，您可以将代码发送到亚马逊简单通知服务 (AmazonSNS) 主题。Amazon SNS 主题订阅者可以是SMS消息、HTTPS终端节点或电子邮件地址。

要使用自定义发件人 SMS Lambda 函数为 Amazon Cognito SMS 消息传递创建测试环境，请参阅上的 aws-samp amazon-cognito-user-poolles development-and-testing-with 库sms-redirected-to-email中的--。 GitHub存储库包含可以创建新用户池或使用已有的用户池的 Amazon CloudFormation 模板。这些模板创建 Lambda 函数和亚马逊SNS主题。模板指定为自定义发SMS件人触发器的 Lambda 函数会将您的SMS消息重定向到亚马逊主题的订阅者。SNS

当您将此解决方案部署到用户池时，Amazon Cognito 通常通过SMS消息发送的所有消息，Lambda 函数会改为发送到中央电子邮件地址。使用此解决方案自定义和预览SMS消息，并测试导致 Amazon Cognito 发送SMS消息的用户池事件。完成测试后，回滚 CloudFormation 堆栈，或者从用户池中移除自定义SMS发送器函数分配。

自定义SMS发件人 Lambda 触发源

下表显示了 Lambda 代码中自定义SMS触发源的触发事件。