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

自定义 SMS 发件人 Lambda 触发器

Amazon Cognito 调用自定义 SMS 发件人触发器，以便第三方提供商可以从您的 Amazon Lambda 函数代码向您的用户发送 SMS 通知。Amazon Cognito 将 SMS 消息事件作为请求发送到 Lambda 函数。然后，您的函数的自定义代码必须处理和传递消息。

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

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

这些是 Amazon Cognito 随同常见参数中的事件信息一起传递给此 Lambda 函数的参数。

JSON

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

自定义 SMS 发件人请求参数

自定义 SMS 发件人响应参数

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

激活自定义 SMS 发件人 Lambda 触发器

要设置使用自定义逻辑为您的用户池发送 SMS 消息的自定义 SMS 发件人触发器，请按如下方式激活触发器。

步骤 1：创建 Lambda 函数

为自定义 SMS 发件人触发器创建 Lambda 函数。Amazon Cognito 使用 Amazon Encryption SDK 加密密钥（临时密码或授权代码）。

步骤 2：在 Amazon KMS 中创建加密密钥

在 Amazon KMS 中创建加密密钥。此密钥加密 Amazon Cognito 生成的临时密码和授权代码。然后，您可以在自定义发件人 Lambda 函数中解密这些密钥，以明文形式将其发送给用户。

步骤 3：授予 Amazon Cognito 服务主体 cognito-idp.amazonaws.com 访问权限，以调用 Lambda 函数

使用以下命令授予对 Lambda 函数的访问权限：

        aws lambda add-permission --function-name lambda_arn --statement-id "CognitoLambdaInvokeAccess" --action lambda:InvokeFunction --principal cognito-idp.amazonaws.com
    

步骤 4：编辑代码以使用自定义发件人

Amazon Cognito 使用 Amazon Encryption SDK 加密密钥（临时密码和授权代码），然后 Amazon Cognito 会将密钥发送给自定义发件人 Lambda 函数。请先对这些密钥进行解密，然后再通过选择的自定义提供商将其发送给用户。要将 Amazon Encryption SDK 与您的 Lambda 函数结合使用，您需要将该 SDK 与函数打包在一起。有关信息，请参阅安装 Amazon Encryption SDK for JavaScript。要更新 Lambda 包，请完成以下步骤：

步骤 5：更新用户池，添加自定义发件人 Lambda 触发器

在 UpdateUserPool API 操作中使用 CustomSMSSender 参数更新用户群体。UpdateUserPool 需要用户群体的所有参数以及您希望更改的参数。如果您没有提供所有相关参数，Amazon Cognito 会将任何缺失参数的值设置为其原定设置。有关更多信息，请参阅更新用户群体配置。

    #Send this parameter in an 'aws cognito-idp update-user-pool' CLI command, along with any existing user pool configurations.
              
      --lambda-config "CustomSMSSender={LambdaVersion=V1_0,LambdaArn= lambda-arn },KMSKeyID= key-id"
               
 

要使用 Amazon CLI 删除自定义 SMS 发送人 Lambda 触发器，请从 CustomSMSSender 中省略 --lambda-config 参数，并包括要与用户群体结合使用的所有其他触发器。要使用 UpdateUserPool API 请求删除自定义 SMS 发送人 Lambda 触发器，请从包含其余用户群体配置的请求正文中删除 CustomSMSSender。有关更多信息，请参阅使用 Amazon Cognito API 或 Amazon CLI 更新用户群体。

代码示例

以下 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_ID ];
            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 has the decrypted secret.
            
            if(event.triggerSource == 'CustomSMSSender_SignUp'){
            
           #Send sms to end-user using custom or 3rd party provider.
           #Include temporary password in the email.
            
            }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 触发器参数 发送到您的函数。您的函数可以用这些信息做您想做的事。例如，您可以将代码发送到 Amazon Simple Notification Service (Amazon SNS) 主题。Amazon SNS 主题订阅者可以是 SMS 消息、HTTPS 终端节点或电子邮件地址。

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

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

自定义 SMS 发件人 Lambda 触发器源

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