如需查看完整的文档索引,请参阅 llms.txt。在文档页面的 URL 末尾加上 .md 即可查看该页面的 Markdown 版本。
主导航
主题

将扫描器的发现导入 Daybreak

连接 Wiz、Snyk Open Source 或 Endor Labs,上传扫描器报告,并选择要共享哪些已评估的发现。

您可以通过连接扫描器或上传报告,将扫描器的发现导入 Daybreak Defense Factory。Daybreak 可以对照您的代码评估这些发现,并与您的团队共享符合条件的结果。

打开设置 → 集成,或在发现中选择导入。可用选项取决于您的工作空间。评估需要访问扫描器提供的证据和代码仓库中的相应提交。要共享结果,还需要一个您有权发布发现的环境。

从已连接的扫描器导入

  1. 选择扫描器旁的连接。如果连接已过期,选择重新连接。要使用现有连接,选择导入。
  2. 选择来源和要导入的发现。如果 Snyk 或 Endor 提供导入代码仓库的全部发现选项,请选择一个已连接的 GitHub 代码仓库,即可纳入所选组织或命名空间中所有匹配的项目。否则,请先选择项目,再选择发现。在 Wiz 中,也可以使用受支持的已保存视图。
  3. 核对发现数量、代码仓库和提交。所选发现中无法评估的也计入总数,因此总数可能多于最终共享的发现数量。
  4. 核对目标位置。确认共享目标位置,即表示您授权 Daybreak 评估这些发现,并将符合发布条件且评为可报告的结果发布到该位置。任何有权访问该位置的人都可以查看已发布的评估及其来源证据。如果只有一个符合条件的环境,Daybreak 会自动选中它。如果有多个,请选择其中一个。如果选择私下评估或私下保存,结果将保持私密。
  5. 核对数量和目标位置无误后,再确认导入。如果本次核对已过期或来源发生变化,请重新核对。导入开始后,您可以关闭设置,在我最近的导入中查看进度。

选择来源

扫描器 连接方式 可选择的内容
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 会将已发布的证据添加到现有问题中。如果是不同的问题,则可能会创建新的发现。因此,同一条共享发现中可能会出现两条扫描器观察记录。重试同一次发布不会重复添加证据。在共享发现中打开观察记录即可查看其来源。请参阅审查发现和修复方案。