AI 助手
TRAE 智能问答助手
你好,我是 TRAE 文档问答助手 🎉 你在阅读当前文档的过程中,无论对文档概念的解释,还是文档内容方面的疑问,都可以随时向我提问,我会全力为你解答
推荐问题
TRAE IDE 里最热门的 Skill 是哪些?
如何创建自定义智能体?
如何配置 Rules?
文档反馈
TRAE 企业版介绍
产品动态
计费说明
订阅管理
组织管理
用量管理
AI 配置
自动化
成员个人设置
问题排查
帮助与支持
相关协议

配置 SAML 2.0 登录

复制页面

TRAE 企业版支持基于 SAML 2.0 协议的单点登录(SSO)。企业管理员完成 SSO 配置后,企业成员可以在 TRAE 登录页面输入企业邮箱,跳转至企业身份提供方(Identity Provider,IdP)进行身份验证。验证通过后,即可登录 TRAE 企业版。

适用客户端

  • TRAE
  • TRAE Plugin
  • TRAE CLI
  • TraeWork 桌面版和网页版
  • TRAE 移动端

SSO 登录流程概览

用户
豆包飞书的账号服务
企业的身份认证服务

访问 TRAE 登录页面, 选择「企业 SSO 登录」

展示邮箱输入页面
输入企业邮箱
TRAE 企业版控制台
请求 SSO 登录
匹配企业 SSO 配置
返回企业 SSO 登录地址
跳转到企业 SSO 登录页面
完成企业身份认证
认证成功,跳转回 TRAE
携带授权凭证返回
提交授权凭证
验证凭证并获取用户信息
返回用户身份信息
确认用户身份,建立登录会话
登录成功
进入 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。

配置 SAML 2.0 登录

前置条件

开始配置前,请确认已完成以下准备:

  • 企业已使用支持 SAML 2.0 的身份提供方(Identity Provider,IdP),例如 Okta、Microsoft Entra ID 或 OneLogin,并拥有相应的 IdP 管理权限。
  • 已在 IdP 中创建用于本次对接的 SAML 2.0 应用,并获取该应用的 SAML 单点登录地址、IdP Issuer 和签名公钥证书。具体获取位置和字段名称以 IdP 的配置页面或接入文档为准。
  • 已准备可用于验证的企业成员账号,并在 IdP 中授予该账号访问 SAML 应用的权限。用于登录的企业邮箱应与该成员在 TRAE 中使用的邮箱一致。

操作步骤

  1. 登录 TRAE 企业版控制台。
  2. 前往 企业配置 > 通用设置。
  3. 在 SSO 登录 部分,点击 前往企业管理后台 按钮。
    你将前往豆包飞书管理后台的 SSO 账号登录配置页面。
    Image
  4. 在 认证方式 区域,选择 SAML 认证,填写以下基础参数:

    提示

    以下参数应来自同一个 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 证书。
  5. 展开 高级设置,根据 IdP 的配置要求设置请求签名和响应签名方式。
    • 请求签名:对 TRAE 向 IdP 发送的 SAML 认证请求进行签名,供 IdP 验证请求的来源和完整性。
      如果 IdP 要求对认证请求进行签名,请勾选 请求签名,然后点击下方证书区域的 复制,将 TRAE 提供的公钥证书配置到 IdP 中用于验证请求签名的位置。具体导入方式以 IdP 的操作说明为准。
    • 响应签名和断言签名:用于指定 TRAE 验证 IdP 返回的 SAML 认证结果时所要求的签名类型。请根据 IdP 的签名配置选择至少一项。
      • 响应签名:IdP 对 SAML 响应(Response)进行签名。启用后,TRAE 会验证响应签名。
      • 断言签名:IdP 对 SAML 断言(Assertion)进行签名。启用后,TRAE 会验证断言签名。
        如果 IdP 同时对 SAML 响应和断言进行签名,可以同时勾选这两个选项。请确保 TRAE 的签名验证设置与 IdP 的签名配置一致。
  6. 点击 验证并保存,完成配置验证。
    验证通过后,确认 SAML 认证 旁显示 验证通过。
  7. 打开页面顶部的 启用/停用 SSO 开关。

设置 SSO 登录的生效范围

你可以设置 SSO 登录的生效范围。

  1. 在 登录设置 > 生效范围 处,点击 编辑 按钮。
  2. 配置以下参数:
    参数 描述
    选中成员 纳入生效范围的成员。成员在此范围内且未被列为例外成员时,必须使用 IdP 账号登录。
    例外成员 不受上述强制登录要求限制的成员。即使同时出现在 “选中成员” 中,仍按例外成员处理。
    Image