默认情况下,Cloud Scheduler 会对静态客户内容进行加密。Cloud Scheduler 会为您处理加密,您无需执行任何其他操作。此选项称为“Google 默认加密”。
如果您想要控制加密密钥,则可以将 Cloud KMS 中客户管理的加密密钥 (CMEK) 与集成 CMEK 的服务(包括 Cloud Scheduler)搭配使用。使用 Cloud KMS 密钥时,您可以控制其保护级别、位置、轮替时间表、使用和访问权限以及加密边界。此外,您还可使用 Cloud KMS 查看审核日志并控制密钥生命周期。这样您就可以在 Cloud KMS 中控制和管理用于保护数据的对称密钥加密密钥 (KEK),而不是由 Google 拥有和管理这些密钥。
使用 CMEK 设置资源后,访问 Cloud Scheduler 资源的体验与使用 Google 默认加密功能类似。如需详细了解加密选项,请参阅客户管理的加密密钥 (CMEK)。
受 CMEK 保护的内容
您可以为每个项目和每个受支持的 Cloud Scheduler 区域指定一个 Cloud KMS 密钥。 Google Cloud 此密钥用于保护该项目和区域中的以下数据:
- 具有 HTTP 或 HTTPS 端点目标的作业:HTTP 请求正文和客户标头。
- 具有 Pub/Sub 主题目标的作业:Pub/Sub 消息载荷和属性。
准备工作
在 Cloud Scheduler 中使用 CMEK 之前,请完成以下前提条件步骤。
更新
gcloud组件。gcloud components update
使用您的账号登录。
gcloud auth login
为存储加密密钥的项目启用 Cloud KMS API:
gcloud services enable cloudkms.googleapis.com \ --project=KMS_PROJECT_ID
将
KMS_PROJECT_ID替换为存储 Cloud KMS 密钥的项目 ID。此项目可以与 Cloud Scheduler 作业位于同一项目中,也可以位于单独的项目中。当 Cloud Scheduler 资源启用密钥、停用密钥或使用密钥来加密和解密数据时,Cloud KMS 会生成 Cloud Audit Logs。
确保针对您的项目中的 Cloud KMS API 启用日志记录,并且您已确定哪些日志记录专用权限和角色适用于您的用例。如需了解详情,请参阅 Cloud KMS 审计日志。
所需的角色
如需获得为 Cloud Scheduler 配置 CMEK 所需的权限,请让您的管理员为您授予以下 IAM 角色:
-
向服务代理授予对密钥的访问权限:对包含 Cloud KMS 密钥的密钥、密钥环或项目的 Cloud KMS Admin (
roles/cloudkms.admin) 角色 -
启用或停用 CMEK:Cloud Scheduler 项目的 Cloud Scheduler Admin (
roles/cloudscheduler.admin) -
查看 CMEK 配置或操作状态:
- Cloud Scheduler 项目的 Cloud Scheduler Viewer (
roles/cloudscheduler.viewer) - Cloud Scheduler 项目的 Cloud Scheduler Admin (
roles/cloudscheduler.admin)
- Cloud Scheduler 项目的 Cloud Scheduler Viewer (
如需详细了解如何授予角色,请参阅管理对项目、文件夹和组织的访问权限。
这些预定义角色包含为 Cloud Scheduler 配置 CMEK 所需的权限。如需查看所需的确切权限,请展开所需权限部分:
所需权限
为 Cloud Scheduler 配置 CMEK 需要以下权限:
-
向服务代理授予对密钥的访问权限:
cloudkms.cryptoKeys.setIamPolicy(针对包含 Cloud KMS 密钥的密钥、密钥环或项目) -
启用或停用 CMEK:
cloudscheduler.cmekConfig.update在 Cloud Scheduler 项目中 -
查看 CMEK 配置或操作状态:
-
对 Cloud Scheduler 项目的
cloudscheduler.cmekConfig.get权限 -
对 Cloud Scheduler 项目的
cloudscheduler.operations.get权限
-
对 Cloud Scheduler 项目的
创建 Cloud KMS 密钥环和密钥
您可以创建新的密钥环,也可以使用现有的密钥环。在密钥环中,您可以添加新密钥或使用现有密钥。我们建议为不同的应用、服务或环境使用不同的密钥。
向 Cloud Scheduler 服务代理授予对密钥的访问权限
您必须向 Cloud Scheduler 服务代理授予 Cloud KMS CryptoKey Encrypter/Decrypter Identity and Access Management (IAM) 角色,以便其可以访问 Cloud KMS 密钥。如果您最近在项目中启用了 Cloud Scheduler API,但尚未创建任何作业,则可能需要先通过运行 gcloud beta services identity create --service=cloudscheduler.googleapis.com --project=PROJECT_ID 创建服务代理。
gcloud kms keys add-iam-policy-binding KEY_NAME \ --keyring=KEY_RING \ --location=LOCATION \ --project=KMS_PROJECT_ID \ --member=serviceAccount:service-PROJECT_NUMBER@gcp-sa-cloudscheduler.iam.gserviceaccount.com \ --role=roles/cloudkms.cryptoKeyEncrypterDecrypter
替换以下内容:
KEY_NAME:密钥的名称,例如my-key。KEY_RING:密钥环的名称,例如my-keyring。LOCATION:密钥的位置,例如us-central1。KMS_PROJECT_ID:Cloud KMS 密钥所在项目的 ID。PROJECT_NUMBER:您的 Cloud Scheduler Google Cloud 项目的项目编号。您可以在 Google Cloud 控制台的欢迎页面上,或通过运行以下命令来查找项目编号:export PROJECT=$(gcloud info --format='value(config.project)') gcloud projects describe ${PROJECT} --format="value(projectNumber)"
只要服务代理具有 roles/cloudkms.cryptoKeyEncrypterDecrypter 角色,您项目中的作业就可以使用 CMEK 密钥对其数据进行加密和解密。如果您撤消此角色,或者停用或销毁 CMEK 密钥,则无法访问该数据。请参阅本文档中的移除 Cloud KMS。
为 Cloud Scheduler 区域启用 CMEK
使用 gcloud scheduler cmek-config update 命令指定要在 Cloud Scheduler 区域中用于数据加密的 Cloud KMS 密钥:
gcloud scheduler cmek-config update \ --location=LOCATION \ --kms-key-name=KEY_NAME \ --kms-keyring=KEY_RING \ --kms-project=KMS_PROJECT_ID
替换以下内容:
LOCATION:受支持的 Cloud Scheduler 区域。KEY_NAME:密钥的名称,例如my-key。KEY_RING:密钥环的名称,例如my-keyring。KMS_PROJECT_ID:您要使用的 Cloud KMS 密钥所在的项目的 ID。
请注意以下几点:
- 在 Cloud Scheduler 中启用、更改或停用 CMEK 密钥会异步运行,并返回长时间运行的操作 (
projects/PROJECT_ID/locations/LOCATION/operations/OPERATION_ID)。您可以通过运行gcloud scheduler operations describe命令来检查更新是否已完成。 - Cloud Scheduler 会使用已启用的密钥对受保护项目和区域中的新作业和更新后的作业进行加密。之前使用旧密钥加密的现有作业会使用新密钥重新加密。
- 现有未受保护的作业会被加密。
- 在 Cloud KMS 中轮替密钥不会自动重新加密现有作业,也不会将该区域中的新作业切换到新的主密钥版本。如需了解详情,请参阅 CMEK 密钥轮替。
- 如果您为某个区域停用 CMEK,则现有作业将使用 Google 默认加密进行加密,后续作业将在不使用 CMEK 加密的情况下创建。在本文档中,请参阅为 Cloud Scheduler 区域停用 CMEK。
验证 Cloud KMS 配置
使用 gcloud scheduler cmek-config describe 命令检索 Cloud Scheduler 区域的 CMEK 配置,验证是否已启用 CMEK:
gcloud scheduler cmek-config describe \ --location=LOCATION
输出类似于以下内容:
kmsKeyName: projects/KMS_PROJECT_ID/locations/LOCATION/keyRings/KEY_RING/cryptoKeys/KEY_NAME name: projects/PROJECT_ID/locations/LOCATION/cmekConfig
kmsKeyName 值是用于保护该区域中作业的 Cloud KMS 密钥的资源 ID。
为 Cloud Scheduler 区域停用 CMEK
您可以为 Cloud Scheduler 区域停用 CMEK,这样在该区域中创建的所有作业都不会使用 CMEK 加密。
gcloud scheduler cmek-config update \ --location=LOCATION \ --clear-kms-key
这会停用特定区域的 CMEK,并且后续创建的任何作业都不会使用 CMEK 加密。现有作业使用 Google 默认加密进行加密。
移除 Cloud KMS
如果您想撤消对作业的数据访问权限,可以通过以下任一方式移除 Cloud KMS:
停用或销毁客户管理的加密密钥的相应密钥版本。您可以检查密钥版本是否正在使用中。 停用 CMEK 密钥版本会暂停对受该密钥版本保护的所有数据的访问,直到重新启用该密钥。销毁密钥版本会永久阻止访问,并可能导致数据丢失且不可恢复。这两项操作都只会影响与特定密钥版本关联的作业。
您无法查看受已停用或已销毁密钥版本保护的资源。任何正在运行的作业执行都会失败,并显示相应的错误消息。
撤销 Cloud Scheduler 服务代理的
roles/cloudkms.cryptoKeyEncrypterDecrypterIAM 角色。这会影响特定Google Cloud 项目和区域中支持使用 CMEK 进行加密的所有作业。您无法创建新的 CMEK 集成作业,也无法查看或列出 CMEK 加密作业(但您仍然可以删除它们)。任何正在运行的作业执行都会失败,并显示相应的出错提示。
虽然这些操作均不能保证即时撤销访问权限,但 IAM 更改通常会更快生效。如需了解详情,请参阅 Cloud KMS 资源一致性和访问权限更改传播。
CMEK 组织政策限制条件简介
Cloud Scheduler 支持以下组织政策限制条件,这些限制条件可帮助您在整个组织范围内强制执行 CMEK 使用:
constraints/gcp.restrictNonCmekServices:使用此限制条件要求使用 CMEK 保护组织、文件夹或项目中的所有新 Cloud Scheduler 资源。如果此组织政策处于有效状态,则除非您先启用 Cloud KMS 密钥,否则无法创建或更新资源。您也无法为 Cloud Scheduler 区域停用 CMEK。
constraints/gcp.restrictCmekCryptoKeyProjects:使用此限制条件可确保受 CMEK 保护的 Cloud Scheduler 资源使用已获批准的项目中的密钥。例如,您可以指定类似于以下内容的规则:“对于
projects/my-company-data-project中的所有 Cloud Scheduler 资源,此项目中使用的 Cloud KMS 密钥必须来自projects/my-company-central-keys或projects/team-specific-keys”。
请注意以下几点:
应用 CMEK 组织政策后,您仍然可以访问使用 Google 默认加密的现有作业;但是,除非您先为 Cloud Scheduler 区域配置可接受的 Cloud KMS 密钥,否则无法更新这些作业。
以 App Engine 应用为目标的作业不受 CMEK 组织政策的约束。例如,如果您设置了
constraints/gcp.restrictNonCmekServices限制条件,则仍然可以创建或更新以 App Engine 应用为目标的作业。
如需详细了解如何配置组织政策,请参阅 CMEK 组织政策。
问题排查
将 Cloud KMS 与 Cloud Scheduler 搭配使用时,您可能会遇到错误。下表介绍了不同的问题以及如何解决这些问题。
| 问题 | 说明 |
|---|---|
权限 cloudkms.cryptoKeyVersions.useToEncrypt 被拒 |
提供的 Cloud KMS 密钥不存在,或者权限未正确配置。 解决方案: |
| 密钥版本未启用 |
提供的 Cloud KMS 密钥版本已停用。 解决方案:重新启用 Cloud KMS 密钥版本。 |
| 密钥环区域与要保护的资源不匹配 |
提供的 Cloud KMS 密钥环区域与受保护的 Cloud Scheduler 区域不同。 解决方案:使用与 Cloud Scheduler 区域位于同一区域的 Cloud KMS 密钥环。密钥环可以位于其他项目中。如需了解详情,请参阅 Cloud KMS 位置和 Cloud Scheduler 位置。 |
| 项目与 Cloud Scheduler 中的 CMEK 不兼容 |
启用 CMEK 失败,并显示 解决方案:
|
审核日志记录
当 Cloud Scheduler 资源启用密钥、停用密钥或使用密钥来加密和解密消息时,Cloud KMS 会生成审计日志。如需了解详情,请参阅 Cloud KMS 审核日志记录。
Cloud EKM 错误
如需解决通过 Cloud External Key Manager (Cloud EKM) 使用外部管理的密钥时可能遇到的问题,请参阅 Cloud EKM 错误参考。
不可用的密钥状态
如果由于某种原因 Cloud KMS 不可用,Cloud Scheduler 可能无法从 Cloud KMS 中检索密钥的状态。
如果 Cloud KMS 在作业预定运行时不可用,Cloud Scheduler 将无法解密作业数据或调用作业的目标。对于暂时性 Cloud KMS 错误(例如 UNAVAILABLE、RESOURCE_EXHAUSTED 或无法访问的 Cloud EKM 密钥),Cloud Scheduler 会在内部使用指数退避算法重试解密,并在 cloudscheduler.googleapis.com/cmek 下的 Cloud Logging 中记录 CmekRetryFailure 日志条目。对于不可重试的错误(例如权限错误或密钥已停用或销毁),解密会立即失败,而不会调用目标。
Cloud KMS 配额
在 Cloud Scheduler 中使用 CMEK 时,您的项目可能会消耗 Cloud KMS 加密请求配额。 例如,Cloud Scheduler 在运行作业、处理作业管理请求或更新 CMEK 配置时可能会消耗这些配额。Cloud Scheduler 会在每个项目和区域中重复使用缓存的中间密钥,最长可达 5 分钟,因此频繁运行作业不会消耗配额。 仅当您使用硬件 (Cloud HSM) 或外部 (Cloud EKM) 密钥时,使用 CMEK 密钥执行的加密和解密操作才会影响 Cloud KMS 配额。 如需了解详情,请参阅 Cloud KMS 配额。价格
除了 Cloud KMS 密钥操作费用(会计入您的 Google Cloud 项目)以外,这种集成不会产生额外的费用。
通过密钥授权使用您的密钥的底层传送资源可以执行其他 Cloud KMS 操作。为了帮助估算直接 Cloud Scheduler 操作的 Cloud KMS 使用量,请预计每个项目和区域的以下加密操作速率:
- 作业执行:Cloud Scheduler 会在每个项目和区域中重复使用缓存的中间密钥,最长可达 5 分钟。如果项目每五分钟执行的作业少于一个,则每次执行大约会执行一次 Cloud KMS 解密操作。执行频率较高的项目在整个区域内大约每五分钟执行一次解密操作。
- 作业管理操作:对于每个项目和区域,使用受保护数据创建、更新、获取、列出、暂停或恢复作业的请求会使用单独的缓存中间密钥,最长可使用 5 分钟。
- CMEK 配置更新:使用
cmek-config启用或更改 CMEK 密钥会执行额外的 Cloud KMS 密钥操作,以验证密钥并重新加密该区域中现有的受保护作业。停用 CMEK 会将现有受保护的作业解密回 Google 默认加密。
如需了解价格信息,请参阅 Cloud KMS 价格。