EasyXAI 文档
连接器CNB

配置自带授权应用

向 CNB 申请授权应用,登记回调和权限,取得 Client ID 与 Client Secret 后在 EasyXAI 保存,再让成员授权账号。

CNB 授权应用目前需要运营管理员审核上架。 EasyXAI 的“添加应用”用于保存已经取得的凭证,不会替你在 CNB 创建应用或提交申请。

只想先连接自己的账号,可以直接使用个人访问令牌。已有可用授权应用的成员,直接看连接账号。

CNB 授权应用需要先申请并通过审核,取得两项凭证后才能在这里添加。还没有获批应用时,可到“连接账号”使用访问令牌。

  1. 请应用负责人向 CNB 申请

    查看 CNB 申请要求

    打开下方申请说明,准备应用名称、Logo、官网和用途,联系 CNB 运营管理员提交。这里没有可以直接生成凭证的自助创建按钮。

  2. 提交返回地址和所需权限

    向 EasyXAI 部署管理员索取完整回调地址,一并交给 CNB。

    这是成员同意授权后返回 EasyXAI 的地址。

    申请中写明需要访问哪些仓库、读取哪些内容;账号资料的只读权限必须包含。

    用途权限要求
    识别成员的 CNB 账号account-profile:r必选
    读取 Issue(议题)repo-issue:r按需
    读取 Issue 和 PR 的评论repo-notes:r按需
    读取 PR(合并请求)repo-pr:r按需
  3. 审核通过后,填写两项凭证

    向应用负责人获取获批应用的两项凭证,按下表填写。

    添加名称,权限范围留空,然后保存。

    ClientID
    填入 Client ID
    ClientSecret
    填入 Client Secret
  4. 让成员连接自己的账号

    保存后,成员打开“连接账号”,选择“一键授权”。

    在 CNB 页面核对应用名称和权限,点击“同意授权”,返回 EasyXAI 后确认连接状态。

1. 请应用负责人准备申请

打开 CNB 创建 OAuth 应用说明,由团队的应用负责人联系 CNB 运营管理员提交申请。官方说明没有提供自助创建应用的按钮,也没有公开统一的申请表链接;具体提交方式由 CNB 管理员沟通确认。

准备项如何填写
应用名称成员授权时看到的名称,不超过 50 字
应用 Logo不超过 1 MB 的图片
应用简介可选,用简短文字说明用途,不超过 350 字
应用官网团队实际网站或 EasyXAI 首页,最多 128 字符
回调地址向 EasyXAI 部署管理员索取当前环境的完整地址
授权范围写明应用需要执行的操作,只申请实际需要的权限
授权资源范围按用途选择当前账号所有资源、所有公开资源或指定资源

回调地址是成员在 CNB 同意授权后返回 EasyXAI 的地址。它可能与浏览器当前域名不同,请直接使用部署管理员提供的完整地址,不要自行拼接,也不要使用资源库页面地址。

地址格式为:

https://<当前环境的回调域名>/v1/asset/integration/oauth/callback

2. 申请所需权限和仓库范围

为了让 EasyXAI 识别成员的账号,申请中必须包含 account-profile 的只读权限(account-profile:r)。再按实际用途增加读取议题、评论或合并请求的权限,具体名称见上面的对照表。

需要私有仓库时,授权资源范围必须包含这些仓库,不能仅选择公开资源。需要写入内容时,由应用负责人说明用途并申请对应读写权限,不要默认申请全部权限。

权限与回调以 CNB 审核登记的应用配置为准。在 EasyXAI 的“权限范围”中填写更多名称,不会替你在 CNB 开通权限。需要变更时,请应用负责人联系 CNB 管理员确认。

3. 审核通过后,在 EasyXAI 添加应用

请应用负责人提供获批应用的 ClientID 和 ClientSecret。

  1. 由 EasyXAI 工作空间管理员打开应用中心 → CNB → 自带授权应用,点击添加应用。
  2. 填写便于辨认的名称,例如“团队 CNB 授权”。
  3. 将 CNB 的 ClientID 填入 Client ID,将同一个应用的 ClientSecret 填入 Client Secret。
  4. 权限范围留空,点击保存。编辑现有应用时,不更换密钥就让 Client Secret 留空。

个人访问令牌不能替代这两项凭证。还没有获批应用时,关闭表单,使用连接账号 → 使用访问令牌入口。

4. 成员连接自己的 CNB 账号

保存授权应用后,每位成员仍要授权自己的账号:

  1. 打开应用中心 → CNB → 连接账号,点击连接账号。
  2. 选择一键授权或前往授权;出现多个授权应用时,选择团队刚登记的应用。
  3. 在 CNB 页面登录,核对应用名称与请求的权限,点击同意授权。
  4. 返回 EasyXAI 后确认连接状态,再到应用能力选择账号并配置用途。

已有可用的平台授权应用时,成员可直接使用,不必先添加团队应用。“自带授权应用”列表为空,也不代表平台没有提供授权方式。

遇到问题时

现象下一步
不知道去哪里申请,或尚未审核通过请团队应用负责人联系 CNB 运营管理员;需要先使用时,改用个人访问令牌
CNB 提示“该链接无法访问”请应用负责人核对 Client ID 及登记的回调地址,不要反复修改为浏览器当前地址
提示客户端或密钥无效确认两项凭证来自同一个获批应用;不要填写个人令牌
保存后仍没有一键授权入口确认授权应用已启用,并请工作空间管理员检查应用配置
授权未完成,或提示没有长期授权请部署管理员检查当前 CNB 授权接入配置;不要用“已保存凭证”判断账号已经连通
账号连接正常,但看不到仓库或评论检查 CNB 审核的权限、资源范围以及当前成员的仓库访问权限

本文根据 2026 年 9 月 14 日读取的 CNB 官方申请说明和用户授权说明整理。未提交真实申请或凭证,完整授权仍需在实际环境验证。