安全模块可检测出大量问题:比如一个存在漏洞的软件包被六条公告提及,或者机密扫描器在五十个文档文件中匹配到相同的示例密码。您无需逐个处理这些发现结果,安全模块会将它们归类为决策。决策:每一个已确定的发现结果对应一条决策,CoRoid早已给出每条决策的答案。您可以核查这些答案,修改错误的答案,然后批量应用。
决策是安全模块下的一个标签页,位于概览和项目之间,其显示的数量代表紧急决策的个数。
构成一条决策的因素
- 一个软件包:跨所有项目的同一软件包:“hono → 4.13.16 涉及2个项目”即为一条决策,无论该升级能修复多少条公告提及的问题。
- 测试代码或工具相关的文件夹:路径为
e2e/或编码工具的.opencode/,无论发现结果的类型及扫描器给出的严重程度如何。 - 此类决策的常见示例:文档中特意写明的凭证、翻译目录中的词汇、种子数据、
.example文件。 - 某个服务中的规则:“apps/api-admin 中的访问控制失效”。未经独立验证的声明会构成单独的决策,与已确认的发现结果区分开。
- 项目代码中的机密规则。
正在修复中的发现结果不计入决策范畴。它会在各类别中列出(“CoRoid 还需处理2个此类问题”),仅当修复失败时才会重新出现。被例外规则排除的发现结果也不计入决策。
三类决策
- 紧急:已在任何地方被利用,或属于您部署环境中的严重问题、已超过修复截止日期。需优先处理。
- 应处理:属于您部署环境中的问题,但未超过修复截止日期,可延迟几天处理。
- 清理:测试代码、工具、示例及低优先级问题,无论严重程度如何,多为无关紧要的内容,可批量处理。
每类决策会显示剩余决策数量、预计处理时长,以及当日已处理的决策占比。
CoRoid给出的答案
每条决策都附有CoRoid给出的答案,标注为确定或很可能,并附有一行说明理由。打开决策详情即可查看完整理由、对应的发现结果以及每条答案的具体作用。
若只有人工才能判断,比如代码中的凭证是否真实有效,则该决策没有现成答案,会显示为需要您处理。在您做出选择前,系统会跳过该决策。
基于代码判断
涉及凭证或代码发现结果的决策详情页会以所在位置开头:显示每个出现位置,附带扫描时对应的提交中的周边代码行,标记出有问题的行;若为GitHub仓库,还会显示在GitHub中打开,即可直接打开该提交中的对应行。无需编辑器或检出代码即可做出判断。
凭证本身不会离开CoRoid存储的您的仓库副本。所显示行中看似凭证的所有值都会被隐藏,安全模块仅会告知您其长度和外观特征:
- 常见的默认词汇,即本地环境常用的类型(
changeme、postgres); - 随机生成的字符,通常作为真实的密钥或密码;
- 可读文本,比如口令。
多数情况下可见的信息包括:该值被赋给的变量、连接字符串中的主机名、该行是否为注释,以及诸如${DB_PASSWORD}这类不携带实际值的引用。
若扫描后发现凭证的文件已被删除,系统会予以提示。删除文件并不会将凭证从仓库历史中移除:任何能读取仓库的人仍可在早期提交中找到它。若为真实凭证,请及时轮换。
| 答案 | 具体作用 |
|---|---|
| 启动修复 | 会为每个项目中的决策对应发现结果生成一项任务。修复完成后会生成对应的pull request。 |
| 先核查再修复真实问题 | 针对声明类问题采用相同流程:先核查每条声明,修复真实问题,其余则添加备注说明。 |
| 打开升级任务 | 会将升级任务作为修复工作,每个项目对应一个pull request。 |
| 忽略该文件夹 | 该文件夹下的发现结果将不再计入当前及后续扫描结果,此操作可撤销。 |
| 这不是秘密 | 关闭这些发现结果,机密扫描功能会根据您的回答更新学习。 |
| 这不是问题…… | 将其标记为误报并关闭,您的理由会记录在历史记录中。 |
| 接受该设置,有效期为90天 | 将其隐藏90天,或直到其严重程度升级为止。 |
| 是的,请轮换它 | 提交轮换检查清单。当您确认旧值已无法使用时,该发现结果即被关闭。 |
| 是的,已经轮换完成 | 根据您的确认关闭它们。 |
| 转交给管理员处理…… | 将其移至其他所有者或管理员的列表,并附上您的备注。 |
| 今日跳过 | 它会在明天出现在原位置。 |
当您更改回答时,安全模块会为同类决策提供相同的答案: “还有1个类似决策……答案相同”。
应用一批答案
应用会应用该批次中所有已准备好的答案。系统会提示已开始的工作内容(会在Factory中显示),并提供撤销。今日已回答列出您的回答。对于允许的操作,您可以撤回这些回答:例外情况、裁决、跳过和移交操作。已开始的工作会在Factory中停止,而非此处。
紧急任务完成后,安全模块会告知剩余决策的数量以及超过修复日期的决策数量,随后提供今日停止或继续 进行。
键盘同样可用:↑和↓可在决策之间切换,Enter可打开某个决策,1到9可选择答案,⌘ Enter可应用。
在Factory中
Factory的需要您处理在决策紧急时会保留一行机密信息:“5个紧急决策 · 约需2分钟 · 总计32个”。开始会打开 决策列表。无法等待的决策会有单独的一行:已被利用的软件包、已确认的关键性发现,或是人员确认属于实际部署内容的凭证。
当没有紧急决策时,该行会从“需要您处理”中移除,并显示下次会话时可处理的决策数量。
由谁回答
所有者和管理员负责回答决策。成员可查看这些决策及其相关证据。
CoRoid的MCP和聊天工具会列出相同的决策(list_security_needs)。请参阅通过MCP和聊天查看安全信息。