您可以通过连接扫描器或上传报告,将扫描器的发现导入 Daybreak Defense Factory。Daybreak 可以对照您的代码评估这些发现,并与您的团队共享符合条件的结果。
打开设置 → 集成,或在发现中选择导入。可用选项取决于您的工作空间。评估需要访问扫描器提供的证据和代码仓库中的相应提交。要共享结果,还需要一个您有权发布发现的环境。
从已连接的扫描器导入
- 选择扫描器旁的连接。如果连接已过期,选择重新连接。要使用现有连接,选择导入。
- 选择来源和要导入的发现。如果 Snyk 或 Endor 提供导入代码仓库的全部发现选项,请选择一个已连接的 GitHub 代码仓库,即可纳入所选组织或命名空间中所有匹配的项目。否则,请先选择项目,再选择发现。在 Wiz 中,也可以使用受支持的已保存视图。
- 核对发现数量、代码仓库和提交。所选发现中无法评估的也计入总数,因此总数可能多于最终共享的发现数量。
- 核对目标位置。确认共享目标位置,即表示您授权 Daybreak 评估这些发现,并将符合发布条件且评为可报告的结果发布到该位置。任何有权访问该位置的人都可以查看已发布的评估及其来源证据。如果只有一个符合条件的环境,Daybreak 会自动选中它。如果有多个,请选择其中一个。如果选择私下评估或私下保存,结果将保持私密。
- 核对数量和目标位置无误后,再确认导入。如果本次核对已过期或来源发生变化,请重新核对。导入开始后,您可以关闭设置,在我最近的导入中查看进度。
选择来源
| 扫描器 | 连接方式 | 可选择的内容 |
|---|---|---|
| Wiz | 登录您的 Wiz 账户并批准连接。 | 可以选择项目中的软件包漏洞,也可以使用已保存的漏洞发现视图。该视图须已筛选,范围限定为单个容器仓库和容器镜像。筛选此页仅搜索当前页。您可以跨页选择发现。 |
| Snyk Open Source | 使用对组织、项目和问题具有 REST 读取权限的 Snyk US-01 API 令牌。 | 选择监控您代码仓库的组织。不同的清单可能分别显示为独立的受监控项目。如果您没有 REST 访问权限,请改用 Issues Detail CSV 文件。 |
| Endor Labs | 输入您的美国区域命名空间、API key 和 API secret。请使用设有到期时间的只读密钥,将权限范围限定在该命名空间,并禁用对子命名空间的访问。 | 从项目的主上下文中选择发现,或在支持按代码仓库导入时使用该选项。 |
如果 Daybreak 能够验证扫描器报告的修订版本,就会使用该版本。如果 Snyk 未提供提交,核对时可能会显示该代码仓库的备用选项。如果某条 Wiz 发现需要检出代码,请选择 GitHub 代码仓库,并输入当前连接有权读取的提交的完整 SHA(40 个字符)。Daybreak 将评估该提交中的代码,这些代码可能与构建容器镜像时使用的代码不同。导入时会保留扫描器的原始证据。
在限额内从已连接的扫描器导入
| 扫描器 | 单次读取来源的限额 | 达到限额时的处理方式 |
|---|---|---|
| Wiz | 每个筛选后的项目或已保存视图最多包含 5,000 条匹配记录,最多 100 页,每页 50 条,总量不超过 32 MiB。 | 按严重程度、有无可用修复或 CVE 缩小筛选范围,然后重新预览。 |
| Snyk Open Source | 每个受监控项目最多包含 10,000 个软件包问题,最多 100 页,每页 100 个。编码后的原始页面与转换后的报告合计不得超过 8 MiB。 | 选择较小的项目,或上传筛选后的导出文件。即使在预览后只选择部分问题,仍需读取整个项目。 |
| Endor Labs | 每次项目预览最多包含 5,000 条发现,每页最多 100 条,读取总量不超过 32 MiB。 | 选择较小的项目,或上传筛选后的导出文件。如果完整证据超出限额,请减少单独选择的发现数量。 |
每份获取的报告与其证据合计不得超过 32 MiB。按代码仓库导入时,必须先读完所有匹配的项目,才能确认该代码仓库的发现总数。
每次最多可选择 10,000 条扫描记录。每次核对最多可评估 10,000 行目标已经验证的记录。这些行及其对应修订版本的列表也不得超过 512 KiB,因此,即使选择的记录少于 10,000 条,也可能需要分批导入。对于 Wiz,检出限额按已指定检出版本的发现数计算,多条发现使用同一提交时也会分别计数。每次核对最多可为 16 条或 100 条发现指定检出版本,具体取决于工作空间提供的选择器。请按界面显示的限额分批选择。一次确认最多可授权 100 个目标环境,每个代码仓库连接对应一个环境。
上传扫描器报告
选择扫描器旁的上传文件。设置页面会检测文件格式,并显示工作空间支持哪些导出格式。
| 扫描器 | 在设置中上传的文件 |
|---|---|
| Wiz | 可以上传 Detailed JSON 格式的完整软件包漏洞报告,也可以上传 JSON Lines 文件,每行包含一条 Wiz 原生发现。要导出代码仓库报告,请在 Wiz 的漏洞发现中筛选报告,选择另存为 → 报告,然后选择代码仓库分支、JSON 和详细。按提示输入导出报告的 Wiz 租户 ID。 |
| Snyk Open Source | 来自单个组织的 Issues Detail CSV 文件。请在预览中核对组织。 |
| Endor Labs | 使用 endorctl 从要导入的命名空间导出的原生 Finding JSON。请保留发现的原始 UUID。如果导出结果有多页,请导出所有页面。 |
上传文件本身及其展开后的内容均不得超过 32 MiB,此限制也适用于 gzip 压缩文件。对于 Snyk CSV 和 Wiz JSON Lines,设置页面每个文件最多可识别 10,000 行数据。如果文件更大,请先拆分再上传。单条 JSON 发现超过 1 MiB 时可能会被拒绝。对于 Snyk CSV,表头不得超过 32,768 个字符,每个字段不得超过 131,072 个字符,每个逻辑行不得超过 1,048,576 个字符。
选择是否评估或共享
保存文件时,系统会上传文件供您核对。开始导入前,请核对已验证的代码仓库和提交,查看哪些行仍需指定检出版本,以及哪些输入已被拒绝。
- 如果只想保留证据供以后使用,请在页面提供评估选项时选择保存但不评估,未提供评估选项时选择私下保存。
- 要评估符合条件的行并将所有结果保密,请选择导入并私下评估。对于仍缺少目标的行,可以稍后再选择目标。如果已有目标的行超过 10,000 行,请拆分报告,或保存报告但不进行评估。
- 要共享符合条件的结果,请勾选默认未选中的同时发布可报告的发现。核对工作空间和目标位置。如果一个代码仓库有多个符合条件的环境,请选择其中一个,或选择保持私密。选择导入并发布可报告的发现以确认。
只有当评估结果为“可报告”、扫描器提供了严重程度且您已授权目标位置时,Daybreak 才会自动共享。原始报告始终保持私密。在活动中选择停止自动共享,即可停止后续从此次导入自动发布结果。
从 CLI 导入
您可以使用 codex-security publish findings 导入已保存的扫描器导出文件。使用 --to local --dry-run 可在本地预览。要预览云端导入,请使用已连接的代码仓库,并加上 --to cloud --dry-run --format json。云端预览会连接 Daybreak,并要求使用保存在文件中的 ChatGPT 登录凭据。
先检查预览,再移除 --dry-run 并确认。privateImport 条目会将发现保存到您的私人收件箱。requests 中的条目会将发现发布到各条目列出的代码仓库环境。请查看回执,检查是否有排除项、失败项或尚未处理的行。本地和云端导入示例见 CLI 参考,CLI 支持的格式和命令见扫描器导入指南。
如果使用 AWS Continuum,请先收集代码问题或单条发现,再使用 CLI 预览已保存的报告。Codex Security 可以根据来自被测目标的验证证据,评估攻击者能否触及受影响的代码。
如果使用 CrowdStrike Falcon Cloud Security 扫描基础设施即代码,请将已保存的 JSON 报告导入本地工作台。
重新打开导入记录
在执行导入的工作空间中,从设置 → 集成或发现 → 导入打开我最近的导入。您也可以在扫描中找到私密导入对应的行,重新打开该导入记录。摘要会列出每一行的处理情况,包括已拒绝的输入及拒绝原因。打开已接受的行,即可查看其扫描器 ID、已保存的证据,以及已有的评估或已发布的发现。断开与扫描器的连接后,Daybreak 将停止通过该连接读取新数据。您仍可重新打开已保存的导入记录。
对私密发现选择评估,即可对照所选提交核查其证据。请查看可报告、已暂缓、已抑制或不适用状态旁的原因。例如,如果 Daybreak 无法读取某个提交,对应的发现可能会处于“已暂缓”状态。要共享私下评估为“可报告”的结果,请选择已获授权的目标环境,再选择发布到共享发现。如果扫描器未提供系统可识别的严重程度,请在发布前选择一个严重程度。
识别重复导入
如果确认过程被中断,请重新打开原始回执,或在页面提供检查原始导入选项时选择该选项。重试原始请求即可恢复该次导入,并沿用您已作出的选择。
开始新的导入时,Daybreak 会将每一行与已有证据进行比较。
- 如果扫描器 ID 和证据均未改变,导入的行可能指向已有的私密观察记录。对于 Endor,须使用同一连接和项目。对于 Wiz,须使用同一连接,并选择同一项目或同一已保存的仓库视图。通过已连接的 Snyk 再次导入时,每个问题都会生成一条新的私密观察记录。再次请求评估时,即使某行没有变化,也可能会重新评估。
- 为同一组织上传完全相同的 Snyk CSV 文件时,Daybreak 会复用此前已接受的行。例如,再次上传相同的 5 个问题时,页面可能会显示 5 个未更改、0 个新增。如果证据发生变化,则会创建新版本。先前的评估仍对应当时核查的证据和提交。
- 如果同一份报告中有两条记录使用相同的扫描器发现 ID,Daybreak 会标记这两条记录,其他有效行仍可导入。请保留一条正确记录,然后导入更正后的报告。即使引用同一 CVE,不同的 ID 也可能对应不同的受影响软件包或代码仓库。
发布后,Daybreak 会检查同一代码仓库和环境中是否已有匹配的共享发现。如果匹配,Daybreak 会将已发布的证据添加到现有问题中。如果是不同的问题,则可能会创建新的发现。因此,同一条共享发现中可能会出现两条扫描器观察记录。重试同一次发布不会重复添加证据。在共享发现中打开观察记录即可查看其来源。请参阅审查发现和修复方案。