配置自带授权应用
向 CNB 申请授权应用,登记回调和权限,取得 Client ID 与 Client Secret 后在 EasyXAI 保存,再让成员授权账号。
CNB 授权应用目前需要运营管理员审核上架。 EasyXAI 的“添加应用”用于保存已经取得的凭证,不会替你在 CNB 创建应用或提交申请。
只想先连接自己的账号,可以直接使用个人访问令牌。已有可用授权应用的成员,直接看连接账号。
CNB 授权应用需要先申请并通过审核,取得两项凭证后才能在这里添加。还没有获批应用时,可到“连接账号”使用访问令牌。
请应用负责人向 CNB 申请
查看 CNB 申请要求打开下方申请说明,准备应用名称、Logo、官网和用途,联系 CNB 运营管理员提交。这里没有可以直接生成凭证的自助创建按钮。
提交返回地址和所需权限
向 EasyXAI 部署管理员索取完整回调地址,一并交给 CNB。
这是成员同意授权后返回 EasyXAI 的地址。
申请中写明需要访问哪些仓库、读取哪些内容;账号资料的只读权限必须包含。
用途 权限 要求 识别成员的 CNB 账号 account-profile:r必选 读取 Issue(议题) repo-issue:r按需 读取 Issue 和 PR 的评论 repo-notes:r按需 读取 PR(合并请求) repo-pr:r按需 审核通过后,填写两项凭证
向应用负责人获取获批应用的两项凭证,按下表填写。
添加名称,权限范围留空,然后保存。
- ClientID
- 填入 Client ID
- ClientSecret
- 填入 Client Secret
让成员连接自己的账号
保存后,成员打开“连接账号”,选择“一键授权”。
在 CNB 页面核对应用名称和权限,点击“同意授权”,返回 EasyXAI 后确认连接状态。
1. 请应用负责人准备申请
打开 CNB 创建 OAuth 应用说明,由团队的应用负责人联系 CNB 运营管理员提交申请。官方说明没有提供自助创建应用的按钮,也没有公开统一的申请表链接;具体提交方式由 CNB 管理员沟通确认。
| 准备项 | 如何填写 |
|---|---|
| 应用名称 | 成员授权时看到的名称,不超过 50 字 |
| 应用 Logo | 不超过 1 MB 的图片 |
| 应用简介 | 可选,用简短文字说明用途,不超过 350 字 |
| 应用官网 | 团队实际网站或 EasyXAI 首页,最多 128 字符 |
| 回调地址 | 向 EasyXAI 部署管理员索取当前环境的完整地址 |
| 授权范围 | 写明应用需要执行的操作,只申请实际需要的权限 |
| 授权资源范围 | 按用途选择当前账号所有资源、所有公开资源或指定资源 |
回调地址是成员在 CNB 同意授权后返回 EasyXAI 的地址。它可能与浏览器当前域名不同,请直接使用部署管理员提供的完整地址,不要自行拼接,也不要使用资源库页面地址。
地址格式为:
https://<当前环境的回调域名>/v1/asset/integration/oauth/callback2. 申请所需权限和仓库范围
为了让 EasyXAI 识别成员的账号,申请中必须包含 account-profile 的只读权限(account-profile:r)。再按实际用途增加读取议题、评论或合并请求的权限,具体名称见上面的对照表。
需要私有仓库时,授权资源范围必须包含这些仓库,不能仅选择公开资源。需要写入内容时,由应用负责人说明用途并申请对应读写权限,不要默认申请全部权限。
权限与回调以 CNB 审核登记的应用配置为准。在 EasyXAI 的“权限范围”中填写更多名称,不会替你在 CNB 开通权限。需要变更时,请应用负责人联系 CNB 管理员确认。
3. 审核通过后,在 EasyXAI 添加应用
请应用负责人提供获批应用的 ClientID 和 ClientSecret。
- 由 EasyXAI 工作空间管理员打开应用中心 → CNB → 自带授权应用,点击添加应用。
- 填写便于辨认的名称,例如“团队 CNB 授权”。
- 将 CNB 的 ClientID 填入 Client ID,将同一个应用的 ClientSecret 填入 Client Secret。
- 权限范围留空,点击保存。编辑现有应用时,不更换密钥就让 Client Secret 留空。
个人访问令牌不能替代这两项凭证。还没有获批应用时,关闭表单,使用连接账号 → 使用访问令牌入口。
4. 成员连接自己的 CNB 账号
保存授权应用后,每位成员仍要授权自己的账号:
- 打开应用中心 → CNB → 连接账号,点击连接账号。
- 选择一键授权或前往授权;出现多个授权应用时,选择团队刚登记的应用。
- 在 CNB 页面登录,核对应用名称与请求的权限,点击同意授权。
- 返回 EasyXAI 后确认连接状态,再到应用能力选择账号并配置用途。
已有可用的平台授权应用时,成员可直接使用,不必先添加团队应用。“自带授权应用”列表为空,也不代表平台没有提供授权方式。
遇到问题时
| 现象 | 下一步 |
|---|---|
| 不知道去哪里申请,或尚未审核通过 | 请团队应用负责人联系 CNB 运营管理员;需要先使用时,改用个人访问令牌 |
| CNB 提示“该链接无法访问” | 请应用负责人核对 Client ID 及登记的回调地址,不要反复修改为浏览器当前地址 |
| 提示客户端或密钥无效 | 确认两项凭证来自同一个获批应用;不要填写个人令牌 |
| 保存后仍没有一键授权入口 | 确认授权应用已启用,并请工作空间管理员检查应用配置 |
| 授权未完成,或提示没有长期授权 | 请部署管理员检查当前 CNB 授权接入配置;不要用“已保存凭证”判断账号已经连通 |
| 账号连接正常,但看不到仓库或评论 | 检查 CNB 审核的权限、资源范围以及当前成员的仓库访问权限 |
本文根据 2026 年 9 月 14 日读取的 CNB 官方申请说明和用户授权说明整理。未提交真实申请或凭证,完整授权仍需在实际环境验证。