文档反馈
云身份（Cloud Identity）是火山引擎提供的身份管理服务，可用于连接企业现有身份系统与火山引擎云上身份。为 TRAE 企业版配置云身份后，企业成员可以通过云身份完成 SSO 单点登录；管理员也可以将云身份中心设置为 TRAE 企业成员的数据源，实现成员与角色的集中管理。
适用客户端
云身份登录适用于以下客户端：
- TRAE IDE
- TRAE Work 桌面版和网页版
- TRAE 插件
- TRAE CLI
前置条件
确保你已在火山引擎完成以下操作：
- 已完成火山引擎企业认证。
- 已开通火山引擎企业组织服务。
配置并启用云身份登录
第一步：在云身份中心创建 TRAE 应用
在云身份中心创建 TRAE 应用，用于建立云身份中心与 TRAE 企业版控制台之间的连接。
- 登录火山引擎控制台。
- 进入云身份中心。
- 创建 TRAE 应用，并在应用配置中填写以下回调地址：
https://console.enterprise.trae.cn/oauth/cloud-identity/callback - 保存应用后，获取 ApplicationTRN 和 Client Secret。后续在 TRAE 企业版控制台配置云身份登录时，需要使用这两项信息。
第二步：在云身份中心准备用户和用户组
将企业成员导入云身份中心，并按照 TRAE 企业版中的角色划分用户组。
- 在云身份中心，点击左侧导航栏中的 用户管理 > 用户，然后将企业成员添加为用户。详情参考《用户基本管理》。
提示
对于 TRAE 企业版的云身份登录功能，邮箱也为必填信息。
- 点击左侧导航栏中的 用户管理 > 用户组，然后创建用于映射 TRAE 企业版角色的用户组。详情参考《用户组管理》。
提示
TRAE 企业版包含 “成员” 和 “管理员” 两类角色，且管理员权限高于成员权限。建议至少创建两个用户组，并在用户组名称中体现角色差异，例如 “trae_admin” 和 “trae_user”。
- 将所创建的用户添加到用户组。
在 TRAE 企业版控制台配置并启用云身份登录后，TRAE 会按组授予用户 “成员” 或 “管理员” 权限。
第三步：在 TRAE 企业版控制台配置云身份登录
- 登录 TRAE 企业版控制台。
- 前往 企业配置 > 通用设置。
- 在 SSO 登录 > 火山引擎云身份登录 部分，点击 ··· > 配置。
界面上弹出火山引擎云身份中心登录配置窗口。
- 完成云身份登录配置：
- 在 填写凭据 部分，填写在云身份中心创建的 TRAE 应用的凭据信息：
- ApplicationTRN：TRAE 应用的唯一资源标识符。在云身份中心创建 TRAE 应用后可获取。
- Client Secret：客户端密钥。若需要将云身份中心作为 TRAE 企业成员的数据源，则必须填写该密钥。若不使用该功能，则无需填写。
- 在 配置权限 部分，配置云身份中心用户组与 TRAE 企业版角色的对应关系：
- 管理员对应用户组：该用户组中的成员在你的 TRAE 企业中拥有管理员权限。
- 成员对应用户组：该用户组中的成员在你的 TRAE 企业中拥有成员权限。
如果一个角色需要对应多个用户组，使用英文逗号分隔用户组名称。若同一用户同时属于管理员用户组和成员用户组，系统将授予该用户管理员权限。
- 在 测试验证 部分：
- 点击 保存，保存当前云身份登录配置。
- 点击 保存并打开云身份中心，前往云身份中心的用户组管理页面，然后验证该账号是否可以通过云身份完成 SSO 登录。
- 在 填写凭据 部分，填写在云身份中心创建的 TRAE 应用的凭据信息：
将云身份中心作为 TRAE 用户数据源
你可以将云身份中心设置为 TRAE 企业成员的数据源。开启后，云身份中心中的用户新增、删除以及用户组调整（对应 TRAE 企业中的角色调整），会同步到 TRAE 企业版控制台的 “人员管理” 中。
重要提示
开启前，请注意以下规则：
- TRAE 企业版控制台每小时从火山引擎云身份中心同步一次数据。
- TRAE 企业版控制台仅同步云身份登录配置中已填写的管理员用户组和成员用户组内的用户。
- 开启数据同步后，管理员无法在 TRAE 企业版控制台中新增、删除成员，或修改成员角色。成员与角色变更均需在云身份中心完成，并等待同步生效。
前置条件
- 已为企业配置并启用火山引擎云身份登录。
- 已在云身份登录配置中填写 Client Secret。
- 已完成云身份中心用户组与 TRAE 企业版角色的映射。
操作步骤
- 登录 TRAE 企业版控制台。
- 前往 企业配置 > 通用设置。
- 在 SSO 登录 部分，打开 将云身份中心作为 TRAE 用户数据源 开关。
- 在确认弹窗中，点击 确认开启 按钮。