您可以在聊天助手上查看安全模块的发现结果并采取相应措施,或通过您自己的助手进行操作。CoRoid 作为MCP服务器:如Claude Code、Codex、Cursor或其他MCP客户端。这些工具遵循与门户相同的规则,因此给出的答案一致,拒绝的操作也相同。
读取
安全模块有独立的作用域,因此用于其他工作的连接无法看到相关发现结果。这些工具需要具备审核员角色且mcp.security.read。它们无需审批。这些工具遵循CoRoid安全模块自身的规则:您只能看到在门户中可访问的项目。若连接仅限于某些项目,则必须指定其中一个项目或该项目的某个发现结果。
| 工具 | 其返回内容 |
|---|---|
get_security_overview | 按项目分类:根据严重程度显示未修复的发现结果、超出修复期限的结果、无人确认的风险项、测试代码以及待您处理的数量。 |
list_security_findings | 按项目、类型、严重程度及状态显示发现结果,先按利用优先级排序,再按严重程度排列;needsYou仅显示那些需要您处理的结果 |
list_security_needs | 那些需要人工确认的决定会按紧急程度排序,每条决定都附带CoRoid给出的答复以及可点击查看的链接:该列表与「安全」→「决策」页面中的内容一致。 |
get_security_finding | 单个发现结果:其所在位置、是否已确认、到期时间以及修复工作内容。绝不会透露机密信息的值。 |
get_security_settings | 每个项目的防护设置均会应用相应检查规则:关闭、仅观察、强制实施或无法运行,并说明原因及该项目配置所选的内容。 |
list_security_runs | 安全模块的运行记录,按最新顺序显示:运行中、等待中、已完成、失败或被替换,并说明运行失败的原因。 |
get_attack_surface | 每个项目的入口点数量及待暴露的数量;针对单个项目,会列出各入口点的代码表现及人员决策结果、部署建议,以及pull request防护机制的检测结果。 |
get_threat_model | 每个项目的威胁模型版本及待审核内容;针对单个项目,会显示模型、待处理的提案及最新版本。 |
list_security_packages | 每个项目的最新依赖清单,包括安装的包数量及存在漏洞的包数量;针对单个项目,会分页显示其包信息,优先展示有漏洞的包。 |
每个发现结果均链接至CoRoid中的对应页面。
对发现结果进行操作
这些工具可对发现结果进行操作。它们需要mcp.security.write以及所有者或管理员权限,这与门户中的要求一致。
| 工具 | 其功能 | 审批 |
|---|---|---|
start_security_fix | 修复,与门户中的操作一致:修复有漏洞的依赖项、为代码类发现结果创建回归测试任务、处理泄露凭证的轮换清单。第二次执行“修复”操作会响应已提交的任务。 | 否 |
run_security_scan | 立即扫描单个项目:包括已启用的功能、依赖项、机密信息历史、攻击面、审计状态(是否启用)或留存的证据。 | 否 |
confirm_real_secret | 确认泄露的凭证属实。在有人证实已将其轮换前,该发现结果将保持开放状态。 | 否 |
revoke_security_exception | 终止例外情况:该发现结果将重新变为开放状态。 | 否 |
dismiss_security_finding | 标记某个发现结果为“并非问题”,并说明原因。 | 始终 |
add_security_exception | 接受某个发现结果带来的风险直至指定日期,并说明原因。 | 始终 |
attest_secret_rotated | 证实泄露的凭证已轮换或吊销,从而关闭该发现结果。CoRoid绝不会检测其所发现的凭证。 | 始终 |
对攻击面和威胁模型进行操作
这些操作同样需要mcp.security.write以及所有者或管理员权限。当门户中的某项控制既会加强也会削弱时,会对应两种工具:加强型工具会拒绝可能削弱安全的更改,因此此类更改始终需由人工审核。
| 工具 | 其功能 | 审批 |
|---|---|---|
raise_entry_point_exposure | 增加入口点的暴露程度、为其标注审计标记,或将其重新纳入作用范围。 | 否 |
lower_entry_point_exposure | 降低入口点的暴露程度、移除标注标记,或说明原因后将其排除在作用范围外。 | 始终 |
refresh_threat_model | 重新读取项目代码;其检测结果将作为提案等待处理。 | 否 |
add_threat_model_entries | 向威胁模型中添加条目 | 否 |
accept_threat_model_proposal | 接受重新读取代码后提出的提案。 | 否 |
update_threat_model_entries | 更改条目的标题或详情。 | 始终 |
remove_threat_model_entries | 从威胁模型中删除条目。 | 始终 |
dismiss_threat_model_proposal | 驳回重新读取代码后提出的提案。 | 始终 |
keep_security_proof | 将能复现发现结果的证据保存为回归测试。 | 否 |
更改保护规则
某个项目的保护规则设置,或是组织默认设置,都可以在以下两种工具中配置:tighten_security_protection会强化保护规则,拒绝任何削弱该规则的更改,而relax_security_protection则会弱化保护规则,或让项目重新遵循组织默认设置,且所有操作都会等待人工确认。当检测或强制执行级别下调、严重程度阈值升高、可开启的修复拉取请求数量减少、审计功能关闭或运行频率降低、机密扫描覆盖范围缩小、沙箱网络开放程度提升或允许更多主机访问,或是“未设置”的入口点不再被视为面向互联网时,均属于规则被削弱的情况。“自定义扫描命令”是在质量控制模块中设置的。
联系人及披露流程
项目的安全联系人拥有与所有者、管理员同等的披露权限:他们可以查看CoRoid为未披露漏洞私下保存的修复方案,决定发布或丢弃这些方案,起草GitHub安全公告,并向依赖项的维护者提交相关报告。通过MCP和聊天功能发起的这些操作仅面向所有者和管理员,且所有操作均需人工确认:联系人可以披露漏洞信息,一旦披露便无法撤回。
| 工具 | 功能说明 | 审批 |
|---|---|---|
list_security_contacts | 项目的安全联系人及其任职条件 | 否 |
get_security_disclosure | 漏洞的私下修复方案(含大小和状态,不含具体内容)、对应的GitHub公告以及发送给维护者的报告,均归披露权限持有者管理 | 否 |
add_security_contact | 将项目成员设为安全联系人 | 始终 |
remove_security_contact | 移除安全联系人 | 始终 |
publish_private_fix | 发布暂存的修复方案:漏洞将被披露,同时对应任务会生成其pull request | 始终 |
discard_private_fix | 丢弃暂存的修复方案 | 始终 |
draft_github_security_advisory | 在代码库中起草GitHub安全公告,该公告对依赖项维护者可见 | 始终 |
record_maintainer_report | 记录你向依赖项维护者报告漏洞的相关信息。CoRoid不会发送任何内容 | 始终 |
为何部分操作需要等待人工确认
标记为“无需处理”、视为可接受风险或轮换凭证的操作,都不会生成修复方案,因此不会出现在待处理列表中;暴露程度较低的入口点或较小的威胁模型也会减少审计覆盖的范围。辅助程序无法自行执行这些操作,因此无论连接设置如何,所有相关操作都会等待人工确认:
- 通过MCP客户端发起的请求,会等待所有者或管理员响应 设置 → 连接 → CoRoid MCP 服务器 → 审批,他们会收到通知。请求会在10分钟后失效。
- 在聊天功能中,辅助程序会在执行操作前先在聊天窗口中请求你确认。
审批内容会以通俗语言说明后续操作,内容源自CoRoid对该漏洞的记录:“标记‘Shop’中的访问控制失效为‘无需处理’”,随后附上引号内的原因说明。原因描述周边的文字来自CoRoid,而非辅助程序,且凭证值绝不会显示:CoRoid不会保存此类信息。src/routes/admin.ts:76(Shop)
无需处理”,引号内为具体原因。原因描述周边的文字来自CoRoid,而非辅助程序,且凭证值绝不会显示:CoRoid不会保存此类信息。