Identity 提供面向认证与账号生命周期流程的消息能力，并按每个 identity UserPool 独立管理。当前产品范围包括短信服务和邮件服务，两者都以 identity UserPool 为配置边界。 ## 能力 |**主题** |**说明** | |---|---| |配置边界 |消息能力按 identity UserPool 配置，而不是按租户全局统一配置。 | |通道范围 |当前产品支持短信和邮件两类消息通道，用于认证与找回流程。 | |管理重点 |管理员通常需要先完成供应商、发送标识和本地化模板配置，再启用终端用户流程。 | ## 消息服务覆盖什么消息服务是 identity 中承载 OTP、验证码和账号恢复体验的投递层。当前可从以下几个方面理解： * identity UserPool 边界，每个 identity UserPool 都有自己的消息配置 * 通道分工，短信和邮件分别服务不同的用户旅程、供应商能力和运维约束 * 模板驱动，内容、语言和占位符决定每个认证步骤向用户展示的方式 ## 短信服务短信服务面向基于手机号的认证与账号恢复场景。当前产品能力包括： * 按 identity UserPool 配置短信服务 * 分别开启中国大陆和海外发送能力 * 为登录、注册和重置密码分别配置模板 * 区分中国大陆与海外模板 ID * 通过短信账号、签名内容和海外 Sender ID 配置发送标识常见使用场景包括： * 短信无密码登录或验证码校验 * 基于手机号的注册确认 * 通过一次性验证码完成密码重置 ## 邮件服务邮件服务面向通过外部供应商发送 OTP 类邮件的场景。当前产品能力包括： * 按 identity UserPool 配置一套邮件服务 * 将邮件服务绑定到外部供应商记录 * 配置发件邮箱地址 * 配置包含主题、正文和语言的本地化邮件模板 * 以 en 和 zh 两种语言渲染模板当前供应商支持范围： * 外部邮件供应商当前支持 SMTP 邮件模板行为： * 邮件正文支持 {{OTP}} 占位符 * 邮件正文还支持可选的 {{ACTION}} 占位符 * {{ACTION}} 会根据模板语言进行渲染常见使用场景包括： * 邮件 OTP 登录或验证码校验 * 基于邮箱的注册流程 * 密码重置与账号恢复流程 ## 管理配置模型消息能力采用两层配置模型： 1. 先配置供应商级能力。 2. 再将供应商配置绑定到具体 identity UserPool。 3. 最后为该 identity UserPool 设置发件信息与模板。对于邮件服务，管理员先创建或更新外部供应商，再将其挂载到 identity UserPool 的邮件服务配置中。对于短信服务，管理员直接在 identity UserPool 维度配置开关、发送标识与模板 ID。 ### 控制台引导对于真实控制台中的变更，消息相关的认证设置并不在广义的池首页，而是在目标 UserPool 的身份验证标签页中。管理员会在这里选择验证码登录所使用的短信服务，并统一管理认证体验。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_227b1827f8b029c507db49a8de7f0614.png) |**视觉检查点** |**为什么对消息服务有帮助** | |---|---| |身份验证标签页 |说明认证消息能力是在目标 UserPool 内管理，而不是租户级全局开关。 | |短信验证码登录区域 |展示短信验证码登录在真实控制台中的启用与查看位置。 | |短信服务选择器 |直观展示当前 UserPool 认证消息所依赖的短信服务提供方式。 | |同页保存入口 |强化“通道行为、自助注册姿态与认证扩展能力在同一池级工作区管理”的认知。 | ## 管理 API 当前产品 admin surface 表明，消息服务分为三类管理面：外部供应商管理、邮件服务绑定，以及 identity UserPool 维度的短信配置。 |**管理目标** |**对应 Action** |**通常最关键的请求字段** | |---|---|---| |创建或更新外部邮件供应商 |[UpsertExternalProvider](https://api.volcengine.com/api-explorer/?action=UpsertExternalProvider&groupName=用户身份管理&serviceCode=id&tab=2&version=2025-10-30)、[GetExternalProvider](https://api.volcengine.com/api-explorer/?action=GetExternalProvider&groupName=用户身份管理&serviceCode=id&tab=2&version=2025-10-30)、[DeleteExternalProvider](https://api.volcengine.com/api-explorer/?action=DeleteExternalProvider&groupName=用户身份管理&serviceCode=id&tab=2&version=2025-10-30) |UserPoolUid、ProviderUid、ProviderType、ProviderConfig、ProviderCredentials | |将邮件投递绑定到 identity UserPool |[UpsertEmailService](https://api.volcengine.com/api-explorer/?action=UpsertEmailService&groupName=用户身份管理&serviceCode=id&tab=2&version=2025-10-30)、[GetEmailService](https://api.volcengine.com/api-explorer/?action=GetEmailService&groupName=用户身份管理&serviceCode=id&tab=2&version=2025-10-30)、[DeleteEmailService](https://api.volcengine.com/api-explorer/?action=DeleteEmailService&groupName=用户身份管理&serviceCode=id&tab=2&version=2025-10-30) |UserPoolUid、Enabled，以及引用供应商、发件信息和多语言模板的邮件服务载荷 | |配置 identity UserPool 的短信投递 |[UpdateSmsService](https://api.volcengine.com/api-explorer/?action=UpdateSmsService&groupName=用户身份管理&serviceCode=id&tab=2&version=2025-10-30)、[GetSmsService](https://api.volcengine.com/api-explorer/?action=GetSmsService&groupName=用户身份管理&serviceCode=id&tab=2&version=2025-10-30) |UserPoolUid、Enabled、SmsAccountId、SignatureContent、国内外开关字段、发送标识，以及各认证流程对应的模板 ID | ## 关键 API 参数这些字段之所以重要，是因为消息投递结果会随着供应商信任关系、通道开关状态以及分场景模板选择而变化。 |**字段或字段块** |**作用说明** | |---|---| |ProviderType、ProviderConfig 和 ProviderCredentials |定义 identity 信任哪个外部邮件供应商以及如何连接它。当前已暴露的供应商类型为 SMTP。 | |ProviderUid |让管理员可以更新或复用已有的外部供应商记录，而不是每次重新创建。 | |邮件或短信服务配置中的 Enabled |控制对应通道是否在目标 identity UserPool 上真正启用。 | |SmsAccountId、SignatureContent 和 SenderId |决定短信投递所使用的品牌发送标识与路由上下文。 | |CnUsageEnabled 和 RowUsageEnabled |将短信投递拆分为中国大陆与海外两类发布姿态。 | |TemplateId、LoginRowTemplateId、SignUpCnTemplateId、PasswordResetRowTemplateId 等流程模板字段 |将消息内容绑定到具体用户旅程，而不是用一套通用消息覆盖所有认证事件。 | |邮件发件地址与本地化模板内容 |决定 identity UserPool 维度下 OTP 和账号生命周期邮件的实际用户体验。 | ### 当前范围 * 短信服务配置以 identity UserPool 为边界 * 邮件服务配置以 identity UserPool 为边界，外部供应商记录独立管理 * 邮件投递当前支持基于 SMTP 的外部供应商 * 邮件模板更适合 OTP 类通知，而不是通用营销邮件 * 短信模板围绕登录、注册和重置密码等认证流程组织 ## 下一步 * identity UserPool * 用户 * 客户端 * 自定义域名 * 产品概览

智能体身份和权限管理平台