搜索

8.11. roxctl scanner

download PDF

与 StackRox Scanner 和 Scanner V4 服务相关的命令。

重要

扫描程序 V4 只是一个技术预览功能。技术预览功能不受红帽产品服务等级协议(SLA)支持,且功能可能并不完整。红帽不推荐在生产环境中使用它们。这些技术预览功能可以使用户提早试用新的功能,并有机会在开发阶段提供反馈意见。

有关红帽技术预览功能支持范围的更多信息,请参阅技术预览功能支持范围

使用方法

$ roxctl scanner [command] [flags]

表 8.69. 可用命令
命令描述

download-db

下载 StackRox Scanner 和 Scanner V4 的离线漏洞数据库。

generate

生成所需的 YAML 配置文件来部署 StackRox Scanner 和 Scanner V4。

upload-db

上传 StackRox Scanner 和 Scanner V4 的漏洞数据库。

8.11.1. roxctl scanner 命令选项从父命令继承

roxctl scanner 命令支持从父 roxctl 命令继承的以下选项:

选项描述

--ca string

为安全连接指定自定义 CA 证书文件路径。或者,您可以使用 ROX_CA_CERT_FILE 环境变量指定文件路径。

--direct-grpc

设置 --direct-grpc 以改进连接性能。或者,通过将 ROX_DIRECT_GRPC_CLIENT 环境变量设置为 true,您可以启用直接 gRPC。默认值为 false

-e, --endpoint string

将服务的端点设置为 contact。或者,您可以使用 ROX_ENDPOINT 环境变量设置端点。默认值为 localhost:8443

--force-http1

强制将 HTTP/1 用于所有连接。或者,通过将 ROX_CLIENT_FORCE_HTTP1 环境变量设置为 true,您可以强制使用 HTTP/1。默认值为 false

--insecure

启用不安全的连接选项。或者,通过将 ROX_INSECURE_CLIENT 环境变量设置为 true,您可以启用不安全的连接选项。默认值为 false

--insecure-skip-tls-verify

跳过 TLS 证书验证。或者,通过将 ROX_INSECURE_CLIENT_SKIP_TLS_VERIFY 环境变量设置为 true,您可以跳过 TLS 证书验证。默认值为 false

--no-color

禁用颜色输出。或者,通过将 ROX_NO_COLOR 环境变量设置为 true,您可以禁用颜色输出。默认值为 false

-p, --password string

指定基本身份验证的密码。或者,您可以使用 ROX_ADMIN_PASSWORD 环境变量设置密码。

--plaintext

使用未加密的连接。或者,通过将 ROX_PLAINTEXT 环境变量设置为 true,您可以启用未加密的连接。默认值为 false

-s, --server-name string

设置用于 SNI 的 TLS 服务器名称。或者,您可以使用 ROX_SERVER_NAME 环境变量设置服务器名称。

--token-file string

使用指定文件中提供的 API 令牌进行身份验证。另外,您可以使用 ROX_API_TOKEN 环境变量设置令牌。

注意

这些选项适用于 roxctl scanner 命令的所有子命令。

8.11.2. roxctl scanner generate

生成所需的 YAML 配置文件来部署 Scanner。

使用方法

$ roxctl scanner generate [flags]

表 8.70. 选项
选项描述

--cluster-type 集群类型

指定您要在其上运行 Scanner 的集群类型。集群类型包括 k8sopenshift。默认值为 k8s

--enable-pod-security-policies

创建 PodSecurityPolicy 资源。默认值为 true

--istio-support string

生成支持指定 Istio 版本的部署文件。有效版本包括 1.0, 1.1,1.2,1.3,1.4,1.5,1.6, 和 1.7

--output-dir string

指定 Scanner 捆绑包的输出目录。留空以使用默认值。

--retry-timeout duration

设置 API 请求被重试的超时时间。值为零表示整个请求持续时间都在不重试的情况下等待。默认值为 20s

--scanner-image string

指定您要使用的 Scanner 镜像。留空,以使用服务器默认值。

-t,--timeout 持续时间

为代表请求最长持续时间的 API 请求设置超时。默认值为 1m0s

8.11.3. roxctl scanner upload-db

为 Scanner 上传漏洞数据库。

使用方法

$ roxctl scanner upload-db [flags]

表 8.71. 选项
选项描述

--scanner-db-file string

指定包含转储的 Scanner 定义 DB 的文件。

-t,--timeout 持续时间

为代表请求最长持续时间的 API 请求设置超时。默认值为 10m0s

8.11.4. roxctl scanner download-db

下载 StackRox Scanner 或 Scanner V4 的离线漏洞数据库。

重要

扫描程序 V4 只是一个技术预览功能。技术预览功能不受红帽产品服务等级协议(SLA)支持,且功能可能并不完整。红帽不推荐在生产环境中使用它们。这些技术预览功能可以使用户提早试用新的功能,并有机会在开发阶段提供反馈意见。

有关红帽技术预览功能支持范围的更多信息,请参阅技术预览功能支持范围

此命令下载特定于版本的离线漏洞捆绑包。系统联系 Central 以确定未指定版本。如果通信失败,则下载默认为 roxctl 中嵌入的版本。

默认情况下,它将尝试下载确定的版本和更具体的变体的数据库。例如,如果指定了 4.4.1-extra 版本,则会对以下版本变体尝试下载:

  • 4.4.1-extra
  • 4.4.1
  • 4.4

使用方法

$ roxctl scanner download-db [flags]

表 8.72. 选项
选项描述

--force

强制覆盖输出文件(如果已存在)。默认值为 false

--scanner-db-file string

输出文件,将漏洞数据库保存到。默认值为下载的远程文件的名称和路径。

--skip-central

在检测版本时不要联系 Central。默认值为 false

--skip-variants

不要尝试处理确定版本的变体。默认值为 false

-t,--timeout 持续时间

为代表请求最长持续时间的 API 请求设置超时。默认值为 10m0s

--version string

下载漏洞数据库的特定版本或版本变体。默认情况下会自动检测到版本。

Red Hat logoGithubRedditYoutubeTwitter

学习

尝试、购买和销售

社区

关于红帽文档

通过我们的产品和服务,以及可以信赖的内容,帮助红帽用户创新并实现他们的目标。

让开源更具包容性

红帽致力于替换我们的代码、文档和 Web 属性中存在问题的语言。欲了解更多详情,请参阅红帽博客.

關於紅帽

我们提供强化的解决方案,使企业能够更轻松地跨平台和环境(从核心数据中心到网络边缘)工作。

© 2024 Red Hat, Inc.