文档中心

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

用户身份管理

消息服务配置

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 登录或验证码校验

基于邮箱的注册流程

密码重置与账号恢复流程

管理配置模型

消息能力采用两层配置模型：

先配置供应商级能力。

再将供应商配置绑定到具体 identity UserPool。

最后为该 identity UserPool 设置发件信息与模板。

对于邮件服务，管理员先创建或更新外部供应商，再将其挂载到 identity UserPool 的邮件服务配置中。

对于短信服务，管理员直接在 identity UserPool 维度配置开关、发送标识与模板 ID。

控制台引导

对于真实控制台中的变更，消息相关的认证设置并不在广义的池首页，而是在目标 UserPool 的身份验证标签页中。管理员会在这里选择验证码登录所使用的短信服务，并统一管理认证体验。

视觉检查点	为什么对消息服务有帮助
身份验证标签页	说明认证消息能力是在目标 UserPool 内管理，而不是租户级全局开关。
短信验证码登录区域	展示短信验证码登录在真实控制台中的启用与查看位置。
短信服务选择器	直观展示当前 UserPool 认证消息所依赖的短信服务提供方式。
同页保存入口	强化“通道行为、自助注册姿态与认证扩展能力在同一池级工作区管理”的认知。

管理 API

当前产品 admin surface 表明，消息服务分为三类管理面：外部供应商管理、邮件服务绑定，以及 identity UserPool 维度的短信配置。

管理目标	对应 Action	通常最关键的请求字段
创建或更新外部邮件供应商	UpsertExternalProvider、GetExternalProvider、DeleteExternalProvider	UserPoolUid、ProviderUid、ProviderType、ProviderConfig、ProviderCredentials
将邮件投递绑定到 identity UserPool	UpsertEmailService、GetEmailService、DeleteEmailService	UserPoolUid、Enabled，以及引用供应商、发件信息和多语言模板的邮件服务载荷
配置 identity UserPool 的短信投递	UpdateSmsService、GetSmsService	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

用户

客户端

自定义域名

产品概览

最近更新时间：2026.08.24 15:13:49

这个页面对您有帮助吗？

有用

无用