是否可通过Lambda触发器调用SES发送Cognito用户池验证码并使用自定义邮件模板?
可行性结论
完全可以实现该需求,核心方案是启用Cognito用户池的**自定义电子邮件发件人(Custom Email Sender)**触发器,绑定你的Lambda函数,Cognito需要发送验证码时会主动触发Lambda,你在函数内调用SES的模板发送接口即可使用你提前上传的自定义邮件模板发信。
前置配置要求
- 已经在对应AWS区域的SES服务中完成自定义邮件模板创建,记录好模板名称
- 已完成SES发件邮箱/域名验证,若SES仍处于沙箱环境,需提前验证所有收件邮箱地址;若需发往任意地址,需先提交工单将SES移出沙箱
- 提前创建KMS对称密钥,用于Cognito加密传输给Lambda的验证码参数
- Cognito用户池触发器配置中,启用「自定义电子邮件发件人」,绑定你的Lambda函数,同时选择上一步创建的KMS密钥
Lambda函数示例(Node.js 16.x及以上运行时)
const { SESv2Client, SendEmailCommand } = require("@aws-sdk/client-sesv2"); const { KmsKeyringNode, decrypt } = require("@aws-crypto/client-node"); // 初始化SES客户端 const sesClient = new SESv2Client({ region: process.env.AWS_REGION }); // 替换为你在Cognito触发器中配置的KMS密钥ARN const KMS_KEY_ARN = "arn:aws:kms:us-east-1:你的账号ID:key/你的密钥ID"; // 替换为你SES中已上传的自定义模板名称 const SES_TEMPLATE_NAME = "你的自定义SES模板名"; // 替换为你验证过的SES发件邮箱 const SENDER_EMAIL = "no-reply@你的域名.com"; const keyring = new KmsKeyringNode({ keyIds: [KMS_KEY_ARN] }); // 解密Cognito传过来的加密验证码 const decryptCode = async (encryptedCode) => { const { plaintext } = await decrypt(keyring, Buffer.from(encryptedCode, "base64")); return plaintext.toString("utf8"); }; exports.handler = async (event) => { try { // 解密验证码 const verificationCode = await decryptCode(event.request.code); // 提取用户信息,可根据你的模板占位参数调整需要传递的字段 const userAttributes = event.request.userAttributes; // 调用SES发送模板邮件 const sendEmailCommand = new SendEmailCommand({ FromEmailAddress: SENDER_EMAIL, Destination: { ToAddresses: [userAttributes.email] }, Content: { Template: { TemplateName: SES_TEMPLATE_NAME, // 这里的参数要和你SES模板里的占位符完全对应,比如你的模板里有{{code}}、{{username}}就传对应值 TemplateData: JSON.stringify({ code: verificationCode, username: userAttributes.email || userAttributes.name || "用户" }) } } }); await sesClient.send(sendEmailCommand); return event; } catch (error) { console.error("邮件发送失败:", error); throw error; } };
权限配置说明
你需要给Lambda的执行角色添加如下权限策略,替换对应占位参数即可:
{ "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Action": "ses:SendTemplatedEmail", "Resource": "*" }, { "Effect": "Allow", "Action": "kms:Decrypt", "Resource": "替换为你的KMS密钥ARN" } ] }
注意事项
- 代码依赖的
@aws-crypto/client-node包没有集成在Lambda默认的Node.js运行时中,你需要将依赖和代码一起打包上传,或者配置为Lambda层使用 - 如果你不需要完全接管Cognito的所有邮件发送逻辑,只是想替换验证码邮件的内容,也可以使用Cognito的「自定义消息」触发器,直接修改返回的邮件内容,不需要自己调用SES
- SES模板的占位参数名称要和Lambda中TemplateData字段传递的key完全一致,否则会出现参数渲染失败
- 测试时如果发现邮件没收到,可以先查看Lambda的CloudWatch日志排查报错,常见错误为权限不足、SES模板不存在、发件邮箱未验证
内容的提问来源于stack exchange,提问作者CREAZER
相关产品推荐
相关产品推荐

