文档

连接器安全性

CoRoid连接器在您的设备上能做什么、不能做什么,它发起的请求类型,它的耐受能力,以及如何验证某个发行版与公开源码版本一致。

CoRoid连接器是一款程序,可让您设备上的编码智能体为CoRoid执行任务(详见您设备上的编码智能体)。它基于Apache-2.0许可证开源,完整源码位于github.com/COROID-AI/coroid-connector。本页面面向负责决定是否允许其在贵组织设备上运行的决策者。

数据流向说明

您的电脑

CoRoid 连接器

开源软件。它会在一个全新的空目录中启动智能体,任务结束后即停止。

您的编码智能体

您使用的智能体,以您的身份登录,其自身工具处于关闭状态。

  1. 1请求分配工作任务。 每个请求的处理时限为 25 秒;连接器会每 3 秒汇报一次智能体的反馈。
  2. 2调用该角色所对应的工具。 仅限本次任务使用的令牌,任务结束后即失效。
  3. 3向其内置模型发起询问。 这与不使用 CoRoid 时的情况相同。CoRoid 不会看到该登录信息。

CoRoid

编排器

它将角色的工作分配给发起任务人员的电脑(1)。

该智能体的工具集

在任务沙箱中运行,您的代码会保留在其中(2)。

该智能体的提供者

它会在您的登录状态下、根据您的套餐为您响应智能体的模型请求(3)。

没有任何程序能访问电脑内部:连接器不会打开端口、发送文件,也不会自行执行命令。

您的智能体登录信息以及智能体为本次任务保存的内容会留在电脑中。

所有连接都从电脑启动,再通过 HTTPS 传输。代码仓库会留在 CoRoid 的任务沙箱中;智能体仅能通过角色的工具对其进行操作。
  • 仅出站请求。该连接器不会开放任何端口,仅在您登录时短暂开放。 127.0.0.1它会通过HTTPS向CoRoid请求任务。每个请求最多保留25秒,之后会重新发起请求,这也是CoRoid确认设备已连接的方式。
  • 您的代码始终存储在CoRoid中。代码库绝不会被复制到设备上。角色对应的工具(读取文件、运行测试、修改代码)会在CoRoid的任务沙箱中运行。传输到设备的仅为角色指令及这些工具的返回结果,例如智能体读取的文件内容或测试运行输出。
  • 智能体的模型请求会发送至其提供商,使用您自己的登录凭证且在您的套餐范围内,就如同未使用CoRoid时一样。智能体发送给模型的内容包含角色工具的返回结果,因此相关处理受您与该提供商签订的协议约束。
  • 任务仅分配给发起者。只有当角色指派中指定了智能体、任务发起人在该组织中已连接可用设备,且组织策略允许使用该智能体时,才会在该设备上运行对应角色。无人发起的任务(如自动化任务)会在其模型上运行。

连接器的功能

  • 登录通过浏览器采用OAuth 2.1和PKCE机制,仅授予一个作用域(connector.turns)。访问令牌有效期为15分钟,刷新令牌有效期为30天,每次使用时都会更新。断开连接在您的设备中吊销上述两种令牌。
  • 保存这些令牌于macOS钥匙串或Linux桌面的Secret Service中,通过标准输入传递给相关工具,绝不会通过命令行传递。若上述两种方式均不可用,则令牌会存储在仅您可读取的文件中。 coroid-connector status会说明令牌的存储位置。
  • 告知CoRoid,首次请求时会发送设备名称、操作系统、自身版本以及各智能体的版本、状态和支持的模型信息。
  • 执行一轮任务:会在新的空目录中启动智能体,关闭智能体自带的工具,为其提供一组工具(本轮任务对应的角色工具),转发智能体的输出结果,拒绝任何非工具调用类的权限请求,随后终止智能体运行并删除该目录。

连接器不执行的操作

  • 读取或发送您的文件,或自行运行命令。它唯一会读取的非自身文件是Cursor的设置文件,用于获取决定是否允许其使用Cursor的两个参数(详见限制条款);相关内容不会离开设备。
  • 允许智能体使用其Shell、文件编辑、网页搜索功能,或其自带的MCP服务器和连接器。每个智能体启动时都会根据其适配的版本开启对应开关;其他版本的智能体会被列出但不会使用。
  • 开放可被他人访问的端口,或通过已建立的连接接收除CoRoid之外的指令。
  • 运行时下载任何内容。coroid-connector add会从发行版锁文件指定的包中安装一次智能体适配器(每个包均标注了版本和SHA-512校验值),且关闭安装脚本。

它发起的请求

请求目标请求时机请求用途
CoRoid的API(https://api.coroid.ai)登录与登出注册连接器、交换、更新及吊销其令牌(/oauth/…)
CoRoid的API运行时请求任务(/connector/v1/poll)并上报本轮任务结果(/connector/v1/turns/…/events)
npm仓库仅在coroid-connector add适配器会安装发行版锁文件指定的包

调用角色工具的是智能体而非连接器(地址为/connector/v1/turns/,使用本轮任务的令牌)及其自身的提供商。

它的耐受能力

如果那么
有人试图以您的名义连接设备审批操作在您的浏览器中完成,需以您的身份登录,且仅在发起该操作的设备上完成登录(地址为127.0.0.1,采用PKCE机制)。请仅批准您刚刚发起的连接器请求。
连接器的令牌被盗用其权限范围仅限于:获取该人员的相关工作数据并生成相关报告。访问令牌会在15分钟内失效,断开连接操作会同时吊销这两种令牌。
某次任务周期的令牌被重复使用该令牌仅适用于当前任务周期,任务结束后即失效。
该任务周期中,系统会向智能体请求其他内容智能体自身的工具处于禁用状态,连接器也会拒绝其他权限请求。该角色所拥有的工具与云模型中的工具一致,具备相同的质量检测、审核机制、流程关卡及步骤限制。
发布版本的内容与其源代码描述不符每个发布版本均由GitHub Actions基于公共仓库中的带标签提交构建而成,经过验证后发布至npm平台,并附带来源信息。Homebrew公式仅在验证通过后才接收新版本。您可以自行查看验证结果(如下所示)。

限制条件

  • 智能体以您的身份运行,享有您在设备上对应的用户权限。是否启用CoRoid的工具取决于每个智能体的自身设置,因此连接器仅在其已测试通过的版本上调用智能体。
  • 智能体在自身存储中保留的任务周期相关数据因智能体而异(详见 保存在您设备上的内容)。贵组织的策略决定了员工可使用的智能体类型(详见 贵组织允许使用的智能体)。
  • Cursor在默认设置下,会在执行网页抓取、网页搜索及浏览器操作前先发起询问。连接器会读取设备上的两项设置(审批模式以及是否允许自动接受网页搜索请求),若这些设置允许无需询问便运行上述工具,则连接器不会调用Cursor。
  • 该连接器尚未在Windows系统上经过测试。

查看发布版本

GitHub上的每个发布版本都包含已发布的软件包、连接器文件、CycloneDX物料清单以及SHA256SUMS。请将<version>替换为您要查看的发布版本。

npm软件包的注册表签名及来源信息:

mkdir check && cd check && npm init -y
npm install @coroid/connector@<version>
npm audit signatures

验证信息,其中注明了构建该文件的提交记录及工作流名称:

gh release download v<version> --repo COROID-AI/coroid-connector
gh attestation verify coroid-connector-<version>.tgz --repo COROID-AI/coroid-connector \
  --signer-workflow COROID-AI/coroid-connector/.github/workflows/release.yml

由带标签的源代码自行构建的文件:

git clone https://github.com/COROID-AI/coroid-connector && cd coroid-connector
git checkout v<version> && npm ci && npm run build
shasum -a 256 dist/coroid-connector.mjs   # the same as its line in SHA256SUMS

如需报告漏洞,请依据仓库的安全策略提交(GitHub的私有漏洞报告机制)。