导出并跟踪安全发现
如需完整文档索引,请参阅 llms.txt。文档页面的 Markdown 版本可通过在页面后追加
.md来获取 URL。
使用已完成的 Codex 安全扫描来执行以下任一交接:
- 导出 会创建一个可移植的 JSON、 CSV或 SARIF 文件。
- 跟踪发现项 会将选定的发现项准备为 Linear、 GitHub或 Jira 议题,或一个私有草稿 GitHub 安全公告。 Codex 会检查 重复项,并在写入前等待你的批准。
这两个工作流都不会更改已密封的扫描包。
Available artifact links and export formats depend on your Codex surface and installed plugin version. Check the plugin changelog before you use a format in automation.
导出可移植工件
Section titled “导出可移植工件”在桌面应用中,从 安全 > 扫描打开一个已完成的扫描。使用其
可用的工件链接来检查 report.md、 findings.json、
scan-manifest.json、 coverage.json或 SARIF 报告(如果存在)。
要创建另一种受支持的格式,请让 Codex 从 已完成的扫描中导出发现项,且不修改其密封包:
Export the findings from [completed scan directory] as [JSON, CSV, or SARIF]. Do not modify the sealed scan bundle or upload its contents.选择适合目标位置的格式:
| 格式 | 用途 |
|---|---|
| JSON | 保留已封存的结构化发现,供工具和脚本使用。 |
| CSV | 在电子表格中查看发现和当前的本地分诊状态。 |
| SARIF | 将发现发送到支持 SARIF 交换格式的工具。 |
交互内容: CodexScreenshot 的动态演示请参阅页面顶部的官方原文链接。
选择 Markdown 报告 以在你配置的外部 report.md 编辑器中打开
。编辑器取决于你的系统设置;下面的示例显示了
生成的报告内容。
交互内容: CodexScreenshot 的动态演示请参阅页面顶部的官方原文链接。
使用返回的工件路径。如果其他工具需要完整的扫描
上下文,请将原始 scan-manifest.json、 findings.json和
coverage.json 保存在一起。导出不会将发现项上传到代码扫描
服务。
跟踪选定的发现
Section titled “跟踪选定的发现”运行 $codex-security:track-findings 时,请使用一个已验证发现项,或来自同一密封扫描的
最多 25 个发现项的显式选择批次。每次
运行使用一个提供方和一个目标位置。私有草稿 GitHub 安全
公告只接受一个发现项。
要准备 Linear 议题,请发送:
Use $codex-security:track-findings to prepare finding [finding ID] from[completed scan directory] for the Linear team [team] and project [project, ifany]. Check for duplicates and show me the exact issue title, body, metadata,and destination. Do not create or update anything until I approve that payload.要准备 GitHub 议题,请发送:
Use $codex-security:track-findings to prepare finding [finding ID] from[completed scan directory] for GitHub repository [owner/repository]. Check openand closed issues for duplicates and show me the exact issue title, body,metadata, repository visibility, and authenticated transport. Do not create orupdate anything until I approve that payload.要准备 Jira 议题,请发送:
Use $codex-security:track-findings to prepare finding [finding ID] from[completed scan directory] for Jira project [project key] as [issue type].Check for duplicates and show me the exact issue summary, description,metadata, and destination. Do not create or update anything until I approvethat payload.Jira 跟踪要求在 Codex中使用 Atlassian Rovo 插件。复用一个议题 需要读取权限;创建或更新议题需要读取和写入权限。
要准备一个私有草稿 GitHub 安全公告,请发送:
Use $codex-security:track-findings to prepare finding [finding ID] from[completed scan directory] as a private draft GitHub Security Advisory in[owner/repository]. Verify the sealed source revision, repository, affectedpaths, package metadata, and duplicate state. Show me the exact advisorypayload, authenticated GitHub CLI identity, and disclosure warnings. Do notcreate anything until I approve that payload.草稿公告需要来自密封 git_revision 扫描的一个发现项、
已验证的公共规范源代码仓库,以及管理员访问权限。该
工作流不会批量处理、更新、发布或关闭公告。当源不满足这些要求时,请使用已批准的
私有议题目标位置。
审查拟写入的内容
Section titled “审查拟写入的内容”- 确认发现项 ID 和指纹来自预期的密封扫描。
- 确认提供方、确切的 Linear 团队、 GitHub 仓库、Jira 项目或 公告仓库,以及实时目标位置的可见性。
- 查看重复项结果:
create、reuse、update或blocked。 - 阅读完整的拟议标题、正文、源位置和提供方 元数据。移除目标位置 不应公开的利用细节或内部证据。
- 只批准该确切载荷。目标位置、可见性、发现项 集合或正文发生变化时,需要新的预览。
敏感发现项应发送到私有目标位置。在 内部或公共 GitHub 仓库中创建议题需要明确的可见性警告 并批准完整内容。应将草稿公告描述视为 最终会公开,并在批准前移除凭据、私有证据和不必要的 利用细节。
在 Codex 对话中审查并批准外部操作。批准 不会在安全工作台中创建单独的议题或公告屏幕。
验证已跟踪的项目
Section titled “验证已跟踪的项目”在你批准拟议写入后, Codex 会重新检查密封源、 目标位置、访问权限和重复项状态。对于批次,它会逐个处理发现项 ,并在遇到第一个不确定结果时停止。创建、更新或 复用只有在 Codex 读回确切议题并验证其 绑定标识符和内容后才算完成。
将返回的规范议题或公告 URL 与你的分流记录保存在一起。 当负责人接受该项进行修复时,继续执行 修复并验证发现项 。