Using Codex

导出与跟踪发现项

把安全发现项导出到团队可追踪系统,避免只停留在一次性扫描。

使用完整的 Codex Security扫描作为两种不同切换的来源:

导出创建可移植的 JSON、CSV 或 SARIF 文件。

跟踪结果将选定的结果准备为 Linear、GitHub 或 Jira 问题或一份私人草稿 GitHub Security Advisory,检查重复项,并在编写之前等待你的批准。

这些工作流程不会更改密封的扫描包。

导出可移植 artifact

打开已完成的结果workspace,选择导出,然后选择格式:

格式用途
JSON为 tools 和 scripts 保留 sealed structured findings。
CSV在 spreadsheet 中 review findings 和当前本地 triage 状态。
SARIF发送到支持 SARIF interchange format 的 tools。

选择导出结果并使用返回的artifact路径。当另一个工具需要完整的扫描上下文而不是仅结果投影时,请将原始 scan-manifest.json、findings.json 和coverage.json 放在一起。

Export findings dialog 使用 JSON, CSV, 和 SARIF format options
Export completed findings as JSON, CSV, 或 SARIF for downstream 检查 和 tooling.

将完成的结果导出为 JSON、CSV 或 SARIF,以供下游审查和工具使用。

跟踪选定 findings

$codex-security:track-findings 工作流程接受一项经过validation的结果或来自一次密封扫描的明确选择的批次(最多 25 个结果)以进行问题跟踪。 GitHub Security Advisory草案仅接受一项发现项。一次运行使用一个提供商和一个目的地。

对于 Linear,发送类似这样的 prompt:

Use $codex-security:track-findings to prepare finding [finding ID] from [completed scan directory] for the Linear team [team] and project [project, if any]. 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 issues,发送:

Use $codex-security:track-findings to prepare finding [finding ID] from [completed scan directory] for GitHub repository [owner/repository]. Check open and closed issues for duplicates and show me the exact issue title, body, metadata, repository visibility, and authenticated transport. Do not create or update 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 approve that payload.

Jira 跟踪需要 Codex 中的本机 Atlassian Rovo 应用程序。重用问题需要读取权限;创建或更新需要读取和写入访问权限。

对于 private draft GitHub Security Advisory,发送:

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, affected paths, package metadata, and duplicate state. Show me the exact advisory payload, authenticated GitHub CLI identity, and disclosure warnings. Do not create anything until I approve that payload.

草案建议需要从密封的 git_revision 扫描、经过validation的公共规范源repository和管理员访问中得出一项结果。该工作流程不会批量、更新、发布或关闭建议。当来源不满足这些要求时,使用经批准的私人发行目的地。

审查拟写入内容

确认发现的 ID 和指纹来自预期的密封扫描。

确认提供商、确切的 Linear 团队、GitHub repository、Jira 项目或咨询repository以及实时目标可见性。

查看重复结果:创建、重用、更新或阻止。

阅读完整的建议标题、正文、源位置和提供者元数据。删除目的地不应公开的漏洞利用细节或内部证据。

仅批准确切的有效负载。更改的目的地、可见性、结果集或正文需要新的预览。

敏感发现应发送至私人目的地。在内部或公共 GitHub repository中创建问题需要明确的可见性警告并批准完整内容。将咨询描述草案视为最终公开,并在批准之前删除凭证、私人证据和不必要的利用细节。

验证已跟踪项目

批准后,法典会重新validation密封的来源、目的地、访问和重复状态。它连续处理一批,并在第一个不确定结果处停止。只有在 Codex 读回确切的问题并validation其绑定标识符和内容后,创建、更新或重用才算完成。

将返回的规范问题或咨询 URL 与你的triage记录一起保留。当所有者接受该项目进行修复时,继续修复并validation结果。

站内延伸阅读