3.19. 安全扫描程序配置字段
| 字段 | 类型 | 描述 |
|---|---|---|
| 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 会返回 |
3.19.1. 使用 Clair v4 重新索引
当 Clair v4 索引清单时，结果应该是确定的。例如，同一清单应生成相同的索引报告。在更改扫描程序前，这是 true，因为使用不同的扫描程序会在报告中生成与特定清单相关的不同信息。因此，Clair v4 会公开索引引擎(/indexer/api/v1/index_state)的状态表示，以确定扫描程序配置是否已更改。
Red Hat Quay 通过在解析到 Quay 数据库时将其保存到索引报告来利用此索引状态。如果此状态自之前扫描后更改了，Red Hat Quay 会在定期索引过程中尝试重新索引该清单。
默认情况下，此参数被设置为 30 秒。如果他们希望索引过程更频繁地运行，用户可能会缩短时间，例如，如果他们不希望等待 30 秒才能在推送新标签后看到安全扫描结果。如果用户希望将请求模式更多地控制到 Clair，以及在 Red Hat Quay 数据库上执行的数据库操作模式，用户也可以更改该参数。
3.19.2. 安全扫描程序配置示例
以下 YAML 是启用安全扫描程序功能时推荐的配置。
安全扫描程序 YAML 配置
FEATURE_SECURITY_NOTIFICATIONS: true
FEATURE_SECURITY_SCANNER: true
FEATURE_SECURITY_SCANNER_NOTIFY_ON_NEW_INDEX: true
...
SECURITY_SCANNER_INDEXING_INTERVAL: 30
SECURITY_SCANNER_V4_MANIFEST_CLEANUP: true
SECURITY_SCANNER_V4_ENDPOINT: http://quay-server.example.com:8081
SECURITY_SCANNER_V4_PSK: MTU5YzA4Y2ZkNzJoMQ==
SERVER_HOSTNAME: quay-server.example.com
SECURITY_SCANNER_V4_INDEX_MAX_LAYER_SIZE: 8G 1
...
- 1
- 建议的最大值为
10G。
