腾讯云 AI 代码助手支持配置 SSO(单点登录)飞书认证源,以实现使用飞书账号进行统一身份认证。通过本文档,您将了解到配置飞书认证源的具体步骤,包括在飞书和腾讯云 AI 代码助手平台上所需进行的配置。
操作步骤
步骤一:创建企业自建应用


填写表单并完成应用创建。


步骤二:配置自建应用权限
为了同步飞书成员信息、通过飞书登录,需要为自建应用配置以下权限:
注意:
请保证权限配置完整,如权限缺失,会导致服务无法正常使用。
权限分类 | 权限名称 | 备注 |
通讯录 | 获取用户基本信息 contact:user.base:readonly | 必要权限,未授权会影响正常使用。 |
| 获取用户 user ID contact:user.employee_id:readonly | 必要权限,未授权会影响正常使用。 |
| 获取用户邮箱信息 contact:user.email:readonly | 建议授权,未授权会无法同步用户邮箱信息。 |
| 获取用户手机号 contact:user.phone:readonly | 建议授权,未授权会无法同步用户手机号信息。 |
权限开通流程见下图,在飞书开放平台中,进入权限管理,在 API 权限中,搜索权限信息并开通。


步骤三:配置自建应用可用范围
飞书企业自建应用存在可用范围限制,仅有可用范围内的成员,可通过应用完成单点登录(SSO),配置方式如下:
在飞书开放平台中,选择版本管理与发布菜单,单击创建版本。


在版本详情中,编辑可用范围字段。


若希望飞书企业中所有成员均可使用腾讯云 AI 代码助手,则选择全部成员即可,若仅允许部分成员使用,则可选择部分成员,并添加对应的部门或成员。


步骤四:配置认证源信息
注意:
认证源集成需选择企业专属认证账号,当前仅新建企业支持该类账号模式,选择后无法更改,请谨慎操作。


1. 进入 腾讯云 AI 代码助手管理端,选择企业设置 > 登录认证,单击添加认证源。


2. 选择飞书并添加。


3. 进入认证源配置流程,将飞书自建应用的 App ID 和 App Secret 填入输入框,并复制回调地址,填写至飞书自建应用的“安全设置-重定向 URL”处。


飞书自建应用 App ID、App Secret 获取位置如图:


飞书自建应用重定向 URL 填写位置如图:


4. 配置完成后,单击下一步,进行关联规则配置,暂不支持配置字段匹配逻辑,可配置以下内容:
说明:
每次登录成功时,更新用户信息:建议开启,每次用户登录时,系统将自动从认证源获取用户信息更新到 AI 代码助手当中。
未匹配成功时,则执行以下逻辑:建议开启“新建用户”,若拒绝登录,则首次通过飞书尝试单点登录 AI 代码助手的用户将无法成功登录。


5. 完成配置后,单击保存即可。
步骤五:启用认证源登录
在认证源列表中,将飞书打开即可,若不需要其它认证源则将其关闭,仅保留飞书认证源。

