使用客戶自行管理的加密金鑰

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 保護的內容

您可以為每個 Google Cloud 專案和支援的 Cloud Scheduler 區域指定 Cloud KMS 金鑰。這組金鑰用於保護該專案和區域中的下列資料:

  • 具有 HTTP 或 HTTPS 端點目標的工作:HTTP 要求主體和客戶標頭。
  • 目標為 Pub/Sub 主題的工作:Pub/Sub 訊息酬載和屬性。

事前準備

在 Cloud Scheduler 中使用 CMEK 之前,請先完成下列必要步驟。

  1. 設定環境。

  2. 更新 gcloud 元件。

    gcloud components update

  3. 使用自己的帳戶登入。

    gcloud auth login

  4. 為儲存加密金鑰的專案啟用 Cloud KMS API:

    gcloud services enable cloudkms.googleapis.com \
        --project=KMS_PROJECT_ID

    將 KMS_PROJECT_ID 替換為儲存 Cloud KMS 金鑰的專案 ID。這個專案可以與 Cloud Scheduler 工作相同,也可以是獨立專案。

  5. 當金鑰啟用、停用或由 Cloud Scheduler 資源用於加密及解密資料時,Cloud KMS 會產生 Cloud 稽核記錄。

    請確認專案中的 Cloud KMS API 已啟用記錄功能,且您已決定要將哪些記錄專用權限和角色套用至您的用途。詳情請參閱「Cloud KMS 稽核記錄」。

必要的角色

如要取得為 Cloud Scheduler 設定 CMEK 所需的權限,請要求管理員授予您下列 IAM 角色:

如要進一步瞭解如何授予角色,請參閱「管理專案、資料夾和組織的存取權」。

這些預先定義的角色具備為 Cloud Scheduler 設定 CMEK 所需的權限。如要查看確切的必要權限,請展開「Required permissions」(必要權限) 部分:

所需權限

必須具備下列權限,才能為 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 KMS 金鑰環和金鑰

您可以建立新的金鑰環,也可以使用現有的金鑰環。在金鑰環中,您可以新增金鑰或使用現有金鑰。建議您為不同的應用程式、服務或環境使用不同的金鑰。

  1. 建立金鑰環。

  2. 建立金鑰。金鑰必須使用對稱加密演算法。

授予 Cloud Scheduler 服務代理金鑰存取權

您必須將 Cloud KMS CryptoKey 加密者/解密者 Identity and Access Management (IAM) 角色授予 Cloud Scheduler 服務代理,該代理才能存取 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. \
    --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 控制台的「Welcome」(歡迎) 頁面找到專案編號,也可以執行下列指令:

    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:專案 ID,用於存放您要使用的 Cloud KMS 金鑰。

注意事項:

  • 在 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.cryptoKeyEncrypterDecrypter IAM 角色。這會影響特定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 失敗,並顯示 FAILED_PRECONDITION 錯誤,訊息如下:Your project is currently not compatible with CMEK in Cloud Scheduler。如果專案中現有的 Cloud Scheduler 工作尚未遷移至支援 CMEK 的版本,就會發生這項錯誤。舉例來說,如果缺少服務代理權限,或舊版工作的 Pub/Sub 主題名稱無效,就無法遷移。

解決方法:

  1. 查看並修正專案中的權限或工作設定問題:
    • 確認 Cloud Scheduler 服務代理在專案中具備 Cloud Scheduler 服務代理 (roles/cloudscheduler.serviceAgent) 角色。這個角色包含專案中 Pub/Sub 主題的 pubsub.topics.publish 權限。如需操作說明,請參閱「授予 Cloud Scheduler 服務代理角色」。
    • 如果專案未授予 roles/cloudscheduler.serviceAgent,或該角色受到限制,請確認服務代理在各個目標主題中具備 Pub/Sub 發布者 (roles/pubsub.publisher) 角色。
    • 檢查是否有主題名稱無效的舊版 Pub/Sub 目標工作,並加以更新或刪除。主題名稱必須在與工作相同的專案中採用 projects/PROJECT_ID/topics/TOPIC_ID 格式。如需主題命名規則,請參閱「主題、訂閱項目、結構定義或快照的命名規範」。
  2. 解決任何權限或工作設定問題後,請在 Google Cloud 控制台提出支援要求,完成遷移作業,以便為專案啟用 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 會在內部重試解密作業,並採用指數輪詢機制,然後在 Cloud Logging 的 cloudscheduler.googleapis.com/cmek 下記錄 CmekRetryFailure 記錄項目。如果是無法重試的錯誤 (例如權限錯誤,或金鑰已停用或刪除),解密作業會立即失敗,不會叫用目標。

Cloud KMS 配額

在 Cloud Scheduler 中使用 CMEK 時,專案可能會耗用 Cloud KMS 加密要求配額。舉例來說,Cloud Scheduler 在執行工作、處理工作管理要求或更新 CMEK 設定時,可能會耗用這些配額。Cloud Scheduler 會重複使用快取的中介金鑰,每個專案和區域最多可使用五分鐘,因此頻繁執行工作不會消耗配額。 只有在使用外部 (Cloud EKM) 金鑰時,使用 CMEK 金鑰進行的加密和解密作業才會影響 Cloud KMS 配額。 詳情請參閱「Cloud KMS 配額」。

定價

除了 Cloud KMS 金鑰作業外,這項整合不會產生額外費用,相關費用會計入您的 Google Cloud 專案。

透過金鑰授權使用金鑰的基礎推送資源,可以執行其他 Cloud KMS 作業。如要預估直接執行 Cloud Scheduler 作業的 Cloud KMS 用量,請參考下列各專案和區域的密碼編譯作業費率:

  • 工作執行:Cloud Scheduler 會重複使用快取的中繼金鑰,每個專案和區域最多可使用五分鐘。如果專案每五分鐘執行不到一項工作,則每次執行會執行約一項 Cloud KMS 解密作業。執行頻率較高的專案,在整個區域內大約每五分鐘執行一次解密作業。
  • 工作管理作業:建立、更新、取得、列出、暫停或恢復受保護資料工作的要求,會使用獨立的快取中介金鑰,每個專案和區域最多可使用五分鐘。
  • CMEK 設定更新:使用 cmek-config 啟用或變更 CMEK 金鑰時,系統會執行額外的 Cloud KMS 金鑰作業,驗證金鑰並重新加密該區域中現有的受保護工作。停用 CMEK 後,現有受保護的工作會解密,並恢復為 Google 預設加密。

如要瞭解定價資訊,請參閱「Cloud KMS 定價」。