在本文档中,您将了解如何启用 Container Scanning API、将映像推送到 Artifact Registry,以及查看在映像中发现的漏洞列表。
Artifact Analysis 可为 Artifact Registry 和 Container Registry(已废弃)中的容器映像提供漏洞信息。元数据存储为备注。Container Analysis 会为与映像相关联的备注的每个实例创建一个发生实例。如需了解详情,请参阅概览和价格文档。
启用此 API 还会在 Artifact Registry 中启用语言包扫描。请参阅支持的软件包类型。
准备工作
- Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Make sure that billing is enabled for your Google Cloud project.
-
Enable the Artifact Registry and Container Scanning APIs.
- Install the Google Cloud CLI.
-
To initialize the gcloud CLI, run the following command:
gcloud init
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Make sure that billing is enabled for your Google Cloud project.
-
Enable the Artifact Registry and Container Scanning APIs.
- Install the Google Cloud CLI.
-
To initialize the gcloud CLI, run the following command:
gcloud init
- 在 Artifact Registry 中创建一个 Docker 仓库,并将容器映像推送到该仓库。如果您不熟悉 Artifact Registry,请参阅 Docker 快速入门。
查看映像漏洞
Artifact Analysis 会在有新映像上传到 Artifact Registry 时扫描这些映像。此扫描可提取有关容器中系统软件包的信息。
您可以使用 Google Cloud 控制台、Google Cloud CLI 或 Container Analysis API 在注册库中查看映像的漏洞事件。如果某个映像存在漏洞,您就可以获取详细信息。
Artifact Analysis 只会更新过去 30 天内推送或拉取的映像的元数据。30 天后,元数据将不再更新,结果将过时。此外,Artifact Analysis 会归档过时超过 90 天的元数据,这些元数据将无法在 Google Cloud 控制台、gcloud 或通过 API 中获取。如需重新扫描包含过时或归档元数据的映像,请拉取该映像。 刷新元数据最多可能需要 24 小时。
在 Google Cloud 控制台中查看出现情况
如需查看映像中的漏洞,请执行以下操作:
获取代码库列表。
在代码库列表中,点击一个代码库。
在图片列表中,点击图片名称。
每个映像摘要的漏洞总数将显示在漏洞列中。
如需查看映像的漏洞列表,请点击漏洞列中的链接。
扫描结果部分会显示扫描的软件包类型、漏洞总数、可修复的漏洞、无法修复的漏洞以及有效的严重级别的摘要。
漏洞表会列出每个发现的漏洞的常见漏洞和披露 (CVE) 名称、实际严重级别、通用漏洞评分系统 (CVSS) 评分、修复程序(如果有)、包含漏洞的软件包的名称和软件包类型。
您可以过滤和排序这些文件,以按文件扩展名查看特定文件、目录或文件类型。
Google Cloud 控制台最多会在此表格中显示 1,200 个漏洞。如果您的映像有超过 1200 个漏洞,您必须使用 gcloud 或 API 才能查看完整列表。
如需详细了解特定 CVE,请点击 CVE 名称。
如需查看漏洞出现详情(例如版本号和受影响的位置),请点击包含漏洞名称的行中的查看或查看已修复。对于尚无修复程序的漏洞,链接文字为查看;对于已应用修复程序的漏洞,链接文字为查看已修复。
使用 gcloud 查看出现情况
如需查看映像的发生实例,请使用以下命令:
Artifact Registry
gcloud artifacts docker images list --show-occurrences \
LOCATION-docker.pkg.dev/PROJECT_ID/REPOSITORY/IMAGE_ID
其中:
- LOCATION 是代码库的单区域或多区域位置。
- PROJECT_ID 是您的 Google Cloud 项目 ID。
- REPOSITORY 是存储了映像的代码库的名称。
- IMAGE_ID 是代码库中的映像名称。您无法使用此命令指定映像标记。
默认情况下,该命令会返回最近的 10 张图片。如需显示不同数量的图片,请使用 --show-occurrences-from
标志。例如,以下命令会返回最近 25 张图片。
gcloud artifacts docker images list --show-occurrences-from=25 \
us-central1-docker.pkg.dev/my-project/my-repo/my-image
Container Registry
gcloud beta container images list-tags \
HOSTNAME/PROJECT_ID/IMAGE_ID
其中:
- HOSTNAME 是多区域主机名:
gcr.io
asia.gcr.io
eu.gcr.io
us.gcr.io
- PROJECT_ID 是包含相应映像的项目的 ID。
- IMAGE_ID 是您要查看其漏洞的映像的 ID。您无法使用此命令指定映像标记。
默认情况下,该命令会返回最近的 10 张图片。如需显示不同数量的图片,请使用 --show-occurrences-from
标志。例如,以下命令会返回最近 25 张图片。
gcloud beta container images list-tags --show-occurrences-from=25 \
gcr.io/my-project/my-image
如需查看某一映像标记或图层的漏洞,请使用以下命令:
Artifact Registry
gcloud artifacts docker images describe \
LOCATION-docker.pkg.dev/PROJECT_ID/REPOSITORY/IMAGE_ID:TAG \
--show-package-vulnerability
或
gcloud artifacts docker images describe \
LOCATION-docker.pkg.dev/PROJECT_ID/REPOSITORY/IMAGE_ID@sha256:HASH \
--show-package-vulnerability
其中:
Container Registry
gcloud beta container images describe HOSTNAME/PROJECT_ID/IMAGE_ID@sha256:HASH \
--show-package-vulnerability
其中:
- HOSTNAME 是多区域主机名:
gcr.io
asia.gcr.io
eu.gcr.io
us.gcr.io
- PROJECT_ID 是包含相应映像的项目的 ID。
- IMAGE_ID 是您要查看其漏洞的映像的 ID。
- HASH 是映像摘要。
如需过滤漏洞发生实例,请使用以下命令:
Artifact Registry
gcloud artifacts docker images list --show-occurrences \
LOCATION-docker.pkg.dev/PROJECT_ID/REPOSITORY/IMAGE_ID --occurrence-filter=FILTER_EXPRESSION
其中:
Container Registry
gcloud beta container images list-tags \
HOSTNAME/PROJECT_ID/IMAGE_ID --occurrence-filter=FILTER_EXPRESSION
其中:
- HOSTNAME 是多区域主机名:
gcr.io
asia.gcr.io
eu.gcr.io
us.gcr.io
- PROJECT_ID 是包含相应映像的项目的 ID。
- IMAGE_ID 是您要查看其漏洞发生实例的映像的 ID。
- FILTER_EXPRESSION 是一个示例过滤条件表达式,其格式请参阅过滤漏洞事件。
使用 API 或代码查看出现情况
如需查看映像的发生实例,请使用相应的代码段。这些代码段指定了 Container Registry 中映像的网址。如果您使用的是 Artifact Registry,请使用以下格式的网址指定映像:
LOCATION-docker.pkg.dev/PROJECT_ID/REPOSITORY/IMAGE_ID
API
使用 cURL
如需获取项目中发生实例的列表,请使用以下命令:
curl -X GET -H "Content-Type: application/json" -H \
"Authorization: Bearer $(gcloud auth print-access-token)" \
https://containeranalysis.googleapis.com/v1/projects/PROJECT_ID/occurrences
如需获取项目中漏洞的汇总,请使用以下命令:
curl -X GET -H "Content-Type: application/json" -H \
"Authorization: Bearer $(gcloud auth print-access-token)" \
https://containeranalysis.googleapis.com/v1/projects/PROJECT_ID/occurrences:vulnerabilitySummary
如需获取特定发生实例的详细信息,请执行以下操作:
curl -X GET -H "Content-Type: application/json" -H \
"Authorization: Bearer $(gcloud auth print-access-token)" \
https://containeranalysis.googleapis.com/v1/projects/PROJECT_ID/occurrences/OCCURRENCE_ID
Java
如需了解如何安装和使用工件分析的客户端库,请参阅 Artifact Analysis 客户端库。 如需了解详情,请参阅 Artifact Analysis Java API 参考文档。
如需向 Artifact Analysis 进行身份验证,请设置应用默认凭据。 如需了解详情,请参阅为本地开发环境设置身份验证。
Go
如需了解如何安装和使用工件分析的客户端库,请参阅 Artifact Analysis 客户端库。 如需了解详情,请参阅 Artifact Analysis Go API 参考文档。
如需向 Artifact Analysis 进行身份验证,请设置应用默认凭据。 如需了解详情,请参阅为本地开发环境设置身份验证。
Node.js
如需了解如何安装和使用工件分析的客户端库,请参阅 Artifact Analysis 客户端库。 如需了解详情,请参阅 Artifact Analysis Node.js API 参考文档。
如需向 Artifact Analysis 进行身份验证,请设置应用默认凭据。 如需了解详情,请参阅为本地开发环境设置身份验证。
Ruby
如需了解如何安装和使用工件分析的客户端库,请参阅 Artifact Analysis 客户端库。 如需了解详情,请参阅 Artifact Analysis Ruby API 参考文档。
如需向 Artifact Analysis 进行身份验证,请设置应用默认凭据。 如需了解详情,请参阅为本地开发环境设置身份验证。
Python
如需了解如何安装和使用工件分析的客户端库,请参阅 Artifact Analysis 客户端库。 如需了解详情,请参阅 Artifact Analysis Python API 参考文档。
如需向 Artifact Analysis 进行身份验证,请设置应用默认凭据。 如需了解详情,请参阅为本地开发环境设置身份验证。
在 Cloud Build 中查看出现情况
如果您使用的是 Cloud Build,还可以在 Google Cloud 控制台的安全分析侧边栏中查看映像漏洞。
安全性数据分析侧边栏提供了存储在 Artifact Registry 中的工件的构建安全信息的概览。如需详细了解侧边栏以及如何使用 Cloud Build 帮助保护软件供应链,请参阅查看构建安全数据分析。
过滤发生实例
您可以在 gcloud
命令和 Artifact Analysis API 中使用过滤条件字符串,以便在查看发生实例之前对其进行过滤。以下部分介绍了支持的搜索过滤条件。
查看扫描结果实例
当某个映像最初被推送到 Container Registry 时,该服务会创建一个扫描结果实例,其中包含有关容器映像初始扫描的信息。
如需检索映像的扫描结果实例,请使用以下过滤条件表达式:
kind="DISCOVERY" AND resourceUrl="RESOURCE_URL"
以下代码段展示了如何使用过滤条件表达式来查看映像的扫描结果实例。这些代码段指定了 Container Registry 中映像的网址。如果您使用的是 Artifact Registry,请使用以下格式的网址指定映像:
LOCATION-docker.pkg.dev/PROJECT_ID/REPOSITORY/IMAGE_ID
gcloud
如需查看映像的扫描结果实例,请使用以下命令:
在这种情况下,该表达式不会直接在命令中使用,而是以参数的形式传递相同的信息:
Artifact Registry:
gcloud artifacts docker images list --show-occurrences \
--occurrence-filter='kind="DISCOVERY"' --format=json \
LOCATION-docker.pkg.dev/PROJECT_ID/REPOSITORY/IMAGE_ID
Container Registry:
gcloud beta container images list-tags \
--occurrence-filter='kind="DISCOVERY"' --format=json HOSTNAME/PROJECT_ID/IMAGE_ID
API
如需检索发现事件,您的过滤条件表达式必须采用网址编码并嵌入 GET
请求中,具体如下所示:
GET https://containeranalysis.googleapis.com/v1/projects/PROJECT_ID/occurrences?filter=kind%3D%22DISCOVERY%22%20AND%20resourceUrl%3D%22ENCODED_RESOURCE_URL%22
如需了解详情,请参阅 projects.occurrences.get
API 端点。
Java
如需了解如何安装和使用工件分析的客户端库,请参阅 Artifact Analysis 客户端库。 如需了解详情,请参阅 Artifact Analysis Java API 参考文档。
如需向 Artifact Analysis 进行身份验证,请设置应用默认凭据。 如需了解详情,请参阅为本地开发环境设置身份验证。
Go
如需了解如何安装和使用工件分析的客户端库,请参阅 Artifact Analysis 客户端库。 如需了解详情,请参阅 Artifact Analysis Go API 参考文档。
如需向 Artifact Analysis 进行身份验证,请设置应用默认凭据。 如需了解详情,请参阅为本地开发环境设置身份验证。
Node.js
如需了解如何安装和使用工件分析的客户端库,请参阅 Artifact Analysis 客户端库。 如需了解详情,请参阅 Artifact Analysis Node.js API 参考文档。
如需向 Artifact Analysis 进行身份验证,请设置应用默认凭据。 如需了解详情,请参阅为本地开发环境设置身份验证。
Ruby
如需了解如何安装和使用工件分析的客户端库,请参阅 Artifact Analysis 客户端库。 如需了解详情,请参阅 Artifact Analysis Ruby API 参考文档。
如需向 Artifact Analysis 进行身份验证,请设置应用默认凭据。 如需了解详情,请参阅为本地开发环境设置身份验证。
Python
如需了解如何安装和使用工件分析的客户端库,请参阅 Artifact Analysis 客户端库。 如需了解详情,请参阅 Artifact Analysis Python API 参考文档。
如需向 Artifact Analysis 进行身份验证,请设置应用默认凭据。 如需了解详情,请参阅为本地开发环境设置身份验证。
查看漏洞发生实例
如需查看特定映像的漏洞发生实例,请使用过滤条件表达式创建查询:
kind="VULNERABILITY" AND resourceUrl="RESOURCE_URL"
以下代码段展示了如何检索映像的漏洞发生实例列表。这些代码段指定了 Container Registry 中映像的网址。如果您使用的是 Artifact Registry,请使用以下格式的网址指定映像:
LOCATION-docker.pkg.dev/PROJECT_ID/REPOSITORY/IMAGE_ID
gcloud
如需查看映像的漏洞发生实例,请使用以下命令:
在这种情况下,该表达式不会直接在命令中使用,而是以参数的形式传递相同的信息:
Artifact Registry
gcloud artifacts docker images list --show-occurrences \
--occurrence-filter='kind="VULNERABILITY"' --format=json \
LOCATION-docker.pkg.dev/PROJECT_ID/REPOSITORY/IMAGE_ID
Container Registry
gcloud beta container images list-tags \
--occurrence-filter='kind="VULNERABILITY"' --format=json HOSTNAME/PROJECT_ID/IMAGE_ID
API
资源网址必须采用网址编码并嵌入 GET 请求中,具体如下所示:
GET https://containeranalysis.googleapis.com/v1/projects/PROJECT_ID/occurrences?filter=kind%3D%22VULNERABILITY%22%20AND%20resourceUrl%3D%22ENCODED_RESOURCE_URL%22
如需了解详情,请参阅 projects.occurrences.get
API 端点。
Java
如需了解如何安装和使用工件分析的客户端库,请参阅 Artifact Analysis 客户端库。 如需了解详情,请参阅 Artifact Analysis Java API 参考文档。
如需向 Artifact Analysis 进行身份验证,请设置应用默认凭据。 如需了解详情,请参阅为本地开发环境设置身份验证。
Go
如需了解如何安装和使用工件分析的客户端库,请参阅 Artifact Analysis 客户端库。 如需了解详情,请参阅 Artifact Analysis Go API 参考文档。
如需向 Artifact Analysis 进行身份验证,请设置应用默认凭据。 如需了解详情,请参阅为本地开发环境设置身份验证。
Node.js
如需了解如何安装和使用工件分析的客户端库,请参阅 Artifact Analysis 客户端库。 如需了解详情,请参阅 Artifact Analysis Node.js API 参考文档。
如需向 Artifact Analysis 进行身份验证,请设置应用默认凭据。 如需了解详情,请参阅为本地开发环境设置身份验证。
Ruby
如需了解如何安装和使用工件分析的客户端库,请参阅 Artifact Analysis 客户端库。 如需了解详情,请参阅 Artifact Analysis Ruby API 参考文档。
如需向 Artifact Analysis 进行身份验证,请设置应用默认凭据。 如需了解详情,请参阅为本地开发环境设置身份验证。
Python
如需了解如何安装和使用工件分析的客户端库,请参阅 Artifact Analysis 客户端库。 如需了解详情,请参阅 Artifact Analysis Python API 参考文档。
如需向 Artifact Analysis 进行身份验证,请设置应用默认凭据。 如需了解详情,请参阅为本地开发环境设置身份验证。
查看特定类型的发生实例
在前面的两个示例中,过滤条件表达式之间的唯一区别是标识发生实例类型的 kind
值。使用此字段可将发生实例列表限制为特定类型,例如漏洞或部署。
如需检查特定映像的发生实例,请使用以下过滤条件表达式:
kind="NOTE_KIND" AND resourceUrl="RESOURCE_URL"
其中:
- NOTE_KIND 是备注的种类。
- 例如,使用
DISCOVERY
种类可列出扫描结果实例。 这些发生实例是在映像最初被推送到 Container Registry 时为其创建的。 - 如需列出漏洞发生实例,请使用
VULNERABILITY
种类。
- 例如,使用
-
RESOURCE_URL 是图片
https://HOSTNAME/PROJECT_ID/IMAGE_ID@sha256:HASH
的完整网址
用于在多个映像中检索特定种类发生实例的过滤条件表达式如下:
kind="NOTE_KIND" AND has_prefix(resourceUrl, "RESOURCE_URL_PREFIX")
其中:
- RESOURCE_URL_PREFIX 是某些映像的网址前缀
- 如需列出映像的所有版本,请使用以下网址前缀:
https://HOSTNAME/PROJECT_ID/IMAGE_ID@
- 如需列出项目中的所有映像,请使用以下网址前缀:
https://HOSTNAME/PROJECT_ID/
- 如需列出映像的所有版本,请使用以下网址前缀:
查看与特定备注相关联的图片
您可以检索与特定备注 ID 相关联的资源列表。例如,您可以列出具有特定 CVE 漏洞的映像。
如需列出项目中与特定备注相关联的所有映像,请使用以下过滤条件表达式:
noteProjectId="PROVIDER_PROJECT_ID" AND noteId="NOTE_ID"
如需检查特定备注的特定映像,请使用以下过滤条件表达式:
resourceUrl="RESOURCE_URL" AND noteProjectId="PROVIDER_PROJECT_ID" \ AND noteId="NOTE_ID"
其中:
- PROVIDER_PROJECT_ID 是提供商项目的 ID。例如,
goog-vulnz
提供默认的漏洞分析。 - NOTE_ID 是备注的 ID。安全相关备注的格式通常为
CVE-2019-12345
。 -
RESOURCE_URL 是图片
https://HOSTNAME/PROJECT_ID/IMAGE_ID@sha256:HASH
的完整网址
例如,如需检查经 Google 分析具有 CVE-2017-16231 发生实例的所有映像,请使用以下过滤条件表达式:
noteProjectId="goog-vulnz" AND noteId="CVE-2017-16231"
后续步骤
使用 Pub/Sub 通知接收有关漏洞和其他元数据的通知。
借助 Kritis Signer 和凭证,您可以在构建流水线中创建 Binary Authorization 证明。这些工具可以根据漏洞扫描结果创建 Binary Authorization 证明。如需了解详情,请参阅使用 Kritis Signer 创建证明或使用 Voucher 创建证明。