10.11. 扫描程序和元数据
本节介绍了与 Red Hat Quay 中安全扫描、元数据和工件关系相关的配置字段。
这些设置可通过允许 Red Hat Quay 来提高可见性和安全性:
- 与漏洞扫描程序集成,以评估已知 CVE 的容器镜像。
- 通过存储在 registry 中的模型卡呈现 AI/ML 模型元数据。
- 使用 Referrers API 来公开容器工件之间的关系,并与 OCI 工件规格保持一致。
这些功能一起有助于改进软件供应链透明性、实施安全策略并支持新兴元数据驱动的工作流。
10.11.1. Clair 安全扫描程序配置字段 复制链接链接已复制到粘贴板!
Red Hat Quay 可以使用 Clair 安全扫描程序来检测容器镜像中的漏洞。这些配置字段控制扫描程序是如何启用的、它会索引新内容、使用端点的频率以及通知的处理方式。
字段 | 类型 | 描述 |
---|---|---|
FEATURE_SECURITY_SCANNER | 布尔值 |
启用或禁用安全扫描程序 |
FEATURE_SECURITY_NOTIFICATIONS | 布尔值 |
如果启用了安全扫描程序,请打开或关闭安全通知 |
SECURITY_SCANNER_V4_REINDEX_THRESHOLD | 字符串 |
此参数用于决定在重新索引之前具有之前失败或自上索引以来已更改状态的最短时间(以秒为单位)。数据通过 manifestsecuritystatus 表中的 |
SECURITY_SCANNER_V4_ENDPOINT | 字符串 |
V4 安全扫描程序的端点 |
SECURITY_SCANNER_V4_PSK | 字符串 | Clair 所生成的预共享密钥(PSK) |
SECURITY_SCANNER_ENDPOINT | 字符串 |
V2 安全扫描程序的端点 |
SECURITY_SCANNER_INDEXING_INTERVAL | 整数 |
这个参数用于决定安全扫描程序索引间隔间隔的秒数。当索引被触发时,Red Hat Quay 将查询其数据库以获取由 Clair 索引的清单。这包括尚未索引的清单,以及之前失败的索引清单。 |
FEATURE_SECURITY_SCANNER_NOTIFY_ON_NEW_INDEX | 布尔值 |
是否允许发送有关新推送的漏洞的通知。 |
SECURITY_SCANNER_V4_MANIFEST_CLEANUP | 布尔值 |
Red Hat Quay 垃圾回收程序会删除没有由其他标签或清单引用的清单。 |
NOTIFICATION_MIN_SEVERITY_ON_NEW_INDEX | 字符串 |
为检测到的漏洞上的新通知设置最小安全级别。避免在首次索引后创建大量通知。如果没有定义,则默认为 |
SECURITY_SCANNER_V4_INDEX_MAX_LAYER_SIZE | 字符串 |
索引允许的最大层大小。如果层大小超过配置的大小,Red Hat Quay UI 会返回 |
安全扫描程序 YAML 配置
- 1
- 建议的最大值为
10G
。
10.11.1.1. 使用 Clair v4 重新索引 复制链接链接已复制到粘贴板!
当 Clair v4 索引清单时,结果应该是确定的。例如,同一清单应该生成相同的索引报告。这在扫描程序被改变前为 true,因为使用不同的扫描程序会生成与报告中返回的特定清单相关的信息。因此,Clair v4 会公开索引引擎(/indexer/api/v1/index_state
)的状态表示,以确定扫描程序配置是否已改变。
在解析到 Quay 数据库时,Red Hat Quay 将这个索引状态保存到索引报告中。如果因为清单之前扫描以来此状态已更改,Red Hat Quay 会在定期索引过程中尝试重新索引该清单。
默认情况下,此参数设为 30 秒。如果用户希望更频繁地运行索引过程,用户可能会缩短。例如,如果他们不希望在推送新标签后等待 30 秒时间查看 UI 的安全扫描结果。如果用户希望对请求模式进行更多控制,以及要在 Red Hat Quay 数据库上执行的数据库操作的模式,用户也可以更改参数。
10.11.2. 模型卡渲染配置字段 复制链接链接已复制到粘贴板!
Red Hat Quay 支持呈现模型卡(机器学习工作流中使用的元数据文档形式),以提高与 OCI 兼容镜像中与模型相关的内容的可见性和管理。
字段 | 类型 | 描述 |
---|---|---|
FEATURE_UI_MODELCARD | 布尔值 |
在 UI 中启用 Model Card image 选项卡。默认值为 |
UI_MODELCARD_ARTIFACT_TYPE | 字符串 | 定义模型卡工件类型。 |
UI_MODELCARD_ANNOTATION | 对象 | 此可选字段定义存储在 OCI 镜像中的模型卡的层注解。 |
UI_MODELCARD_LAYER_ANNOTATION | 对象 | 此可选字段定义存储在 OCI 镜像中的模型卡的层注解。 |
模型卡示例 YAML
10.11.3. 开放容器计划引用器 API 配置字段 复制链接链接已复制到粘贴板!
开放容器项目(OCI)引用器 API 有助于检索和管理引用者有助于改进容器镜像管理。
其他信息
字段 | 类型 | 描述 |
---|---|---|
FEATURE_REFERRERS_API | 布尔值 | 启用 OCI 1.1 的引用 API。 |
OCI 引用启用示例 YAML
# ... FEATURE_REFERRERS_API: True # ...
# ...
FEATURE_REFERRERS_API: True
# ...