Keycloak通过execute-actions-email端点实现单次邮件完成邮箱验证及账号配置

可选方案1：平台支持复合动作时的最优实现 #

• 调用execute-actions-email端点时，仍保留UPDATE_PROFILE、UPDATE_PASSWORD、VERIFY_EMAIL三个操作入参
• 前往身份服务的邮件配置后台，关闭「验证邮件单独发送」的默认规则，自定义统一的动作通知模板，将三个操作的有效凭证合并到同一个跳转链接中
• 用户点击链接完成密码设置、资料更新提交时，后端会自动校验所有操作权限，同步完成邮箱验证标记，无需额外操作
• 全程只会触发1次邮件发送，不会生成多封邮件

可选方案2：通用兜底实现（适配所有平台） #

• 调用execute-actions-email端点时，仅传入UPDATE_PROFILE、UPDATE_PASSWORD两个操作，此时仅会发送1封账号配置邮件
• 在用户完成密码设置、资料更新的提交回调逻辑中，手动调用用户属性更新接口，将该用户的emailVerified属性直接设置为true

该方案的逻辑合理性：用户可以收到创建账号后发送的配置邮件并完成操作，本身已经证明邮箱地址真实有效，无需再走单独的邮箱验证流程，你已经移除了UPDATE_PROFILE模板中的邮箱字段，也不会出现用户修改邮箱后验证状态不匹配的问题。

验证步骤 #

• 测试账号创建流程，确认用户仅收到1封配置引导邮件
• 完成邮件内的操作后，查看用户属性，确认emailVerified状态为true

内容的提问来源于stack exchange，提问作者mahmoud ghalayini