配置 SAML 2.0 登录
复制页面
TRAE 企业版支持基于 SAML 2.0 协议的单点登录(SSO)。企业管理员完成 SSO 配置后,企业成员可以在 TRAE 登录页面输入企业邮箱,跳转至企业身份提供方(Identity Provider,IdP)进行身份验证。验证通过后,即可登录 TRAE 企业版。
参与方说明如下:
| 角色 | 描述 |
|---|---|
| 用户 | 希望登录 TRAE 的企业成员。 |
| 豆包飞书管理后台 | 企业配置管理平台,用于让企业管理员管理 SSO 登录相关的配置。 |
| TRAE 的账号服务 | TRAE 后端服务,负责 SSO 配置匹配、身份验证和会话管理。 |
| 企业的身份认证服务 | 企业自有的身份认证服务(IdP),如 Okta、Azure AD、Google Workspace 等。 |
流程说明如下:
| 序号 | 步骤 | 描述 |
|---|---|---|
| 1 | 发起 SSO 登录 | 企业成员访问 TRAE 登录页面,选择 “企业 SSO 登录” 方式。 |
| 2 | 输入企业邮箱 | 成员输入企业邮箱地址,系统根据邮箱域名找到对应的 SSO 配置。 |
| 3 | 跳转企业认证 | TRAE 将该成员的浏览器重定向至企业的 IdP 页面(如 Okta、Azure AD 等)。 |
| 4 | 完成身份验证 | 该成员在企业的 IdP 页面中完成身份验证(支持账号密码、MFA 等方式)。 |
| 5 | 返回 TRAE | 认证成功后,浏览器自动跳转回 TRAE。 |
| 6 | 登录完成 | TRAE 的账号服务验证该成员的身份信息,建立登录会话,然后将该用户登入 TRAE。 |
开始配置前,请确认已完成以下准备:

提示
以下参数应来自同一个 IdP 应用。不同 IdP 的字段名称可能有所不同,请根据参数含义对应填写。
| 参数 | 描述 | 填写要求 |
|---|---|---|
| SAML 2.0 协议端点 | IdP 接收 SAML 登录请求的地址。成员发起 SSO 登录时,TRAE 会将认证请求发送至该地址,引导成员在 IdP 完成身份验证。 | 填写 IdP 提供的 SSO URL。请完整复制地址,包括协议、域名和路径。 |
| 身份提供商发布者(IdP Issuer) | dP 的身份标识,用于校验收到的 SAML 消息是否由预期的身份提供方签发。 | 填写 IdP 提供的 Issuer 或 Entity ID。请确保与 IdP 中的值完全一致,包括大小写、协议和末尾斜杠。 |
| SAML 证书 | IdP 的签名公钥证书。TRAE 使用证书中的公钥验证 IdP 返回的 SAML 响应或断言签名,以确认认证信息的来源和完整性。 | 填写与 IdP 当前签名私钥配套的公钥证书,并确保证书仍在有效期内。请勿填写私钥、应用密钥或网站 HTTPS 证书。 |
你可以设置 SSO 登录的生效范围。
| 参数 | 描述 |
|---|---|
| 选中成员 | 纳入生效范围的成员。成员在此范围内且未被列为例外成员时,必须使用 IdP 账号登录。 |
| 例外成员 | 不受上述强制登录要求限制的成员。即使同时出现在 “选中成员” 中,仍按例外成员处理。 |
