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

自定义 SMS 发件人 Lambda 触发器

Amazon Cognito 在 Lambda 函数代码中调用 CustomSMSSender 触发器，使第三方提供商可以向您的用户发送 SMS 通知。要使用此触发器，请执行以下步骤：

启用 CustomSMSSender Lambda 触发器

您可以使用 Lambda 函数启用 CustomSMSSender 触发器。

步骤 1：创建 Lambda 函数

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

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

更新用户池，添加 CustomSMSSender 触发器。

代码示例

    #Send the parameter to update-user-pool along with any existing user pool configurations.
              
      --lambda-config "CustomSMSSender={LambdaVersion=V1_0,LambdaArn= lambda-arn },KMSKeyID= key-id"
               
 

以下 Node.js 示例演示了如何使用 CustomSMSSender Lambda 函数。

            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 发件人 Lambda 触发器源

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