本頁面說明 Spanner 的客戶自行管理加密金鑰 (CMEK)。如要進一步瞭解 CMEK 的一般資訊,包括啟用時機和原因,請參閱 Cloud Key Management Service 說明文件。
根據預設,Spanner 會加密靜態儲存的客戶內容。Spanner 會為您處理加密作業,您不必採取其他動作。這個選項稱為「Google 預設加密機制」。
如要控管加密金鑰,您可以在 Cloud KMS 中使用客戶自行管理的加密金鑰 (CMEK),並搭配整合 CMEK 的服務 (包括 Spanner)。使用 Cloud KMS 金鑰,即可控管金鑰的保護等級、位置、輪替時間表、使用權限和存取權,以及加密範圍。 使用 Cloud KMS 也能查看稽核記錄及控管金鑰生命週期。 您可以在 Cloud KMS 中控管及管理用於保護資料的對稱金鑰加密金鑰 (KEK),而非由 Google 擁有及管理。
使用 CMEK 設定資源後,存取 Spanner 資源的體驗與使用 Google 預設加密機制類似。如要進一步瞭解加密選項,請參閱「客戶自行管理的加密金鑰 (CMEK)」。
如要瞭解如何使用手動建立的 CMEK 保護 Spanner 資源,請參閱「使用 CMEK 保護資料庫」。
功能與特色
- 資料存取控管:管理員可以輪替、管理存取權,以及停用或刪除用於保護 Spanner 靜態資料的金鑰。
- 可稽核性:如果您在專案中啟用 Cloud KMS API 的稽核記錄,系統會記錄金鑰的所有動作 (包括 Spanner 執行的動作),並可在 Cloud Logging 中查看。Cloud EKM 金鑰支援金鑰存取依據,這項功能會在所有金鑰要求中加入依據欄位。如果使用特定外部金鑰管理合作夥伴,您可以根據理由自動核准或拒絕這些要求。
- 效能:使用 CMEK 不會影響 Spanner 效能或服務水準協議。
- 支援多個區域金鑰:您可以建立多個區域 (單一區域) Cloud KMS 金鑰,保護 Spanner 自訂、雙區域或多區域執行個體設定中的資料庫。
定價
Spanner 對啟用 CMEK 的資料庫計費方式與其他資料庫相同。啟用 CMEK 不會產生額外的 Spanner 費用。詳情請參閱「Spanner 定價」。
Cloud KMS 會向您收取金鑰費用,以及該金鑰的任何加密編譯作業費用 (每當 Spanner 使用金鑰進行加密/解密時)。根據 Spanner 產生的預期密碼編譯作業數量,我們預計這些費用會很低。詳情請參閱 Cloud KMS 定價。
CMEK 保護的內容
在啟用 CMEK 的資料庫中,Spanner 會使用 Cloud KMS 金鑰保護靜態資料。包括儲存在磁碟或快閃記憶體中的資料庫資料。
部分例外狀況如下。下列類型的資料會受到 Google 預設靜態資料加密保護,而非 CMEK 金鑰:
- 標示範圍邊界的資料列索引鍵子集
- 偵錯資料,包括核心 dump 和作業記錄
- 傳輸中的資料或記憶體中的資料
- 資料庫中繼資料
Spanner 採用三層加密機制。靜態資料會拆分為子檔案區塊進行儲存,每個區塊都會在儲存層級使用個別加密金鑰加密。用來加密資料區塊的金鑰稱為資料加密金鑰 (DEK)。由於 Google 的金鑰數量龐大,且需要低延遲和高可用性,因此這些金鑰會儲存在加密資料附近。DEK 會以金鑰加密金鑰 (KEK) 加密 (或包裝)。最後,每個 KEK 都會以 CMEK 加密。
輪替 CMEK 金鑰時,Spanner 只會使用 CMEK 金鑰的最新主要版本,重新加密中繼 KEK。重新加密完成後,停用或刪除舊版 CMEK 金鑰不會停用資料庫存取權。您也可以查看用於保護資料庫的金鑰版本,或變更資料庫加密設定,改用其他 Cloud KMS 金鑰或 Google-owned and Google-managed encryption key。
使用 CMEK

不使用 CMEK

啟用 CMEK
您可以建立資料庫或更新現有資料庫,為 Spanner 資料庫啟用 CMEK。將 Cloud KMS CryptoKey 加密者/解密者 (roles/cloudkms.cryptoKeyEncrypterDecrypter) 角色授予 Google 代管的 Spanner 服務帳戶後,Spanner 就能代您存取金鑰。如需詳細操作說明,請參閱「使用 CMEK 保護資料庫」。
Spanner 的資料存取 API (例如用於管理工作階段和執行資料交易的 API) 對 CMEK 和 Google-owned and Google-managed encryption keys來說完全相同。應用程式在讀取或寫入資料時,不需要指定金鑰或加密設定。所有加密作業都由服務處理。
變更資料庫加密設定
您可以直接變更現有 Spanner 資料庫的加密設定,不需停機。支援下列加密設定選項:
- 在採用 Google-owned and Google-managed encryption key的現有資料庫上啟用 CMEK。
- 變更已啟用 CMEK 的資料庫上的 Cloud KMS 金鑰,包括在多區域金鑰和多個區域金鑰之間切換,或替換一或多個區域金鑰。
- 移除 CMEK,並將資料庫還原為 Google-owned and Google-managed encryption key。
更新資料庫的加密設定時,Spanner 會更新資料庫的 encryption_config 欄位,並在背景重新加密現有的資料庫資料。背景重新加密作業可能需要數小時才能完成。在背景重新加密期間,資料庫的 encryption_info 欄位會列出仍在使用的金鑰版本,其中可能包含先前的金鑰。詳情請參閱「確認背景重新加密作業完成」。
在背景重新加密期間,少數交易可能會失敗,並顯示可重試的 ABORTED 錯誤。Spanner 用戶端程式庫會自動重試這些交易。
這項程序不會重新加密備份。在重新加密之前或期間建立的備份仍可使用先前的金鑰,因此請保留這些金鑰,直到不再需要這些備份為止。詳情請參閱「變更資料庫加密設定」。
管理金鑰
金鑰管理作業是透過 Cloud KMS 執行。在 Cloud KMS 傳播金鑰變更之前,Spanner 無法偵測或處理任何金鑰變更。某些作業 (例如停用或刪除金鑰) 最多可能需要三小時才能生效,但權限變更通常會更快生效。
資料庫建立後,Spanner 會每隔約五分鐘呼叫 Cloud KMS,確認金鑰是否仍有效。
如果 Spanner 偵測到 Cloud KMS 金鑰已停用或刪除,就會立即執行作業,讓資料庫無法存取。後續對資料庫的任何呼叫 (包括工作階段、讀取和寫入) 都會傳回 FAILED_PRECONDITION 錯誤:KMS key required by the
Spanner resource is not accessible.。如果 Spanner 對 Cloud KMS 的呼叫偵測到先前停用的金鑰已重新啟用,Cloud KMS 會自動還原 Spanner 資料庫的存取權。
此外,如果資料庫受到多個區域金鑰保護,且所有金鑰都已停用或刪除,Spanner 會立即開始讓資料庫無法存取。如果 Spanner 偵測到只有部分資料庫金鑰遭到停用或刪除,就會在 12 小時內停用資料庫。強烈建議不要停用或刪除已啟用 CMEK 的資料庫中的部分金鑰,否則可能導致不確定的行為。為避免這種情況發生,您可以使用 Spanner CMEK 金鑰指標 (instance/replica/cmek/total_keys),在部分金鑰遭到停用或刪除時觸發快訊。詳情請參閱「建立停用部分 CMEK 的警告」。
建立停用部分 CMEK 的警告
您可以使用 Spanner CMEK 金鑰 (/instance/replica/cmek/total_keys) 指標,在部分 CMEK 停用或刪除時觸發警告。如要建立這項警告政策,請展開下列步驟和設定:
CMEK 警告政策的設定。
| 新條件 欄位 |
值 |
|---|---|
| 資源和指標 | 在「Resources」(資源) 選單中,選取「Spanner Instance」(Spanner 執行個體)。 在「Metric categories」(指標類別) 選單中,選取「Instance」(執行個體)。 在「Metrics」(指標) 選單中,選取「CMEK Keys」(CMEK 金鑰)。 (metric.type 為 spanner.googleapis.com/instance/replica/cmek/total_keys)。
|
| 篩選器 | instance_id = INSTANCE_IDis_key_revoked = TRUE |
| 跨時間序列 時間序列分組依據 |
database |
| 跨時間序列 時間序列匯總 |
sum |
| 滾動週期 | 10 m |
| 滾動週期函式 | mean |
| 設定快訊觸發條件 欄位 |
值 |
|---|---|
| 條件類型 | Threshold |
| 警告觸發條件 | Any time series violates |
| 門檻位置 | Above threshold |
| 門檻 | 0
|
| 重新測試週期 | 1 hr |
| 新條件 欄位 |
值 |
|---|---|
| 資源和指標 | 在「Resources」(資源) 選單中,選取「Spanner Instance」(Spanner 執行個體)。 在「Metric categories」(指標類別) 選單中,選取「Instance」(執行個體)。 在「Metrics」(指標) 選單中,選取「CMEK Keys」(CMEK 金鑰)。 (metric.type 為 spanner.googleapis.com/instance/replica/cmek/total_keys)。
|
| 篩選器 | instance_id = INSTANCE_IDis_key_revoked = FALSE |
| 跨時間序列 時間序列分組依據 |
database |
| 跨時間序列 時間序列匯總 |
sum |
| 滾動週期 | 10 m |
| 滾動週期函式 | mean |
| 設定快訊觸發條件 欄位 |
值 |
|---|---|
| 條件類型 | Threshold |
| 警告觸發條件 | Any time series violates |
| 門檻位置 | Above threshold |
| 門檻 | 0
|
| 重新測試週期 | 1 hr |
| 設定快訊觸發條件 欄位 |
值 |
|---|---|
| 多條件觸發 | All conditions are met |
建立快訊後,如果 Spanner 偵測到部分 CMEK 已停用,快訊的「Policy details」(政策詳細資料) 頁面中,「Incidents」(事件) 表格下方會顯示事件摘要項目。您也可以設定選用的通知管道。詳情請參閱「建立及管理通知管道」。
如何處理無法取得金鑰狀態
在極少數情況下 (例如 Cloud KMS 無法使用時),Spanner 可能無法從 Cloud KMS 擷取金鑰狀態。
如果 Spanner 資料庫受到金鑰保護,且該金鑰在 Spanner 首次無法與 Cloud KMS 通訊時已啟用,Spanner 會盡可能繼續支援完整的資料庫作業,最長可達一小時,盡量減少這類事件對工作負載的影響。如果一小時後 Spanner 仍無法連線至 Cloud KMS,Spanner 會開始將資料庫離線,做為保護措施。在資料庫重新連上 Cloud KMS,且 Cloud KMS 回應金鑰處於有效狀態之前,Spanner 資料庫中的資料都無法存取。
相反地,如果 Spanner 資料庫受到金鑰保護,且在 Spanner 首次無法與 Cloud KMS 通訊時,該金鑰處於停用狀態,則資料庫會維持無法存取的狀態,直到能夠重新連線至 Cloud KMS,且您已重新啟用金鑰為止。
如果您使用多個區域金鑰保護 Spanner 資料庫,只有受金鑰保護的副本會受到影響,而該金鑰位於無法使用的區域 Cloud KMS。
外部金鑰考量重點
使用 Cloud EKM 金鑰時,Google 無法控管外部金鑰管理合作夥伴系統中,外部代管金鑰的可用性。
如果無法使用外部代管金鑰,Spanner 會盡可能繼續支援完整的資料庫作業,最長可達一小時。如果 Spanner 在一小時後仍無法連線至 Cloud KMS,就會開始將資料庫設為離線,做為保護措施。呼叫資料庫時會失敗,並顯示 FAILED_PRECONDITION 錯誤:External key error: Could not find a key resource
at the key URI.
如果您使用多個 Cloud EKM 金鑰保護 Spanner 資料庫,只有受無法使用的金鑰保護的副本會受到影響。
如要進一步瞭解使用外部金鑰時的注意事項,請參閱 Cloud External Key Manager 說明文件。
備份與還原
您可以使用 CMEK 或 Google-owned and Google-managed encryption keys 保護 Spanner 備份。根據預設,備份會使用與資料庫相同的加密設定,但您可以在建立備份時指定不同的加密設定,覆寫這項行為。如果備份已啟用 CMEK,則會使用建立備份時的 KMS 金鑰主要版本加密。備份建立後,即使 KMS 金鑰輪替或資料庫的加密設定變更,金鑰和金鑰版本也無法修改。詳情請參閱「備份資料庫」。
從備份還原資料庫時,還原的資料庫預設會使用與備份相同的加密設定。如要覆寫這項行為,請在還原資料庫時指定其他加密設定。如要還原已啟用 CMEK 的備份,必須具備用於加密備份的金鑰和金鑰版本。詳情請參閱「從備份還原」。
您可以使用多個區域金鑰加密資料庫,並執行建立、複製和還原等備份作業。
備份排程建立的所有備份,都能受到 CMEK 或 Google-owned and Google-managed encryption keys保護。如果資料庫的增量備份排程繼承了加密設定,而您變更了該資料庫的加密設定,Spanner 會使用更新後的設定建立新的完整備份,並啟動新的增量備份鏈。
地理區域分區
您可以使用 CMEK 或 Google-owned and Google-managed encryption keys ,保護採用地理區域分區的 Spanner 資料庫。使用地理區域分區時,每個執行個體副本位置 (包括執行個體分區設定中的位置) 都必須使用區域性 Cloud KMS 金鑰。不支援多區域金鑰。每個區域性 Cloud KMS 金鑰都必須與對應的 Spanner 執行個體副本或執行個體分區位於相同區域。
舉例來說,如果 Spanner 資料庫位於多區域執行個體設定 nam3,且執行個體分區位於 europe-west1 和 europe-west2,則必須在下列區域建立 Cloud KMS 金鑰:
us-east4(nam3的一部分)us-east1(nam3的一部分)us-central1(nam3的一部分)europe-west1(執行個體分區的位置)europe-west2(執行個體分區的位置)
詳情請參閱「使用 CMEK 保護資料庫」。
記錄
如果您在專案中啟用 Cloud KMS API 的稽核記錄,就能在 Logging 稽核 Spanner 代表您傳送至 Cloud KMS 的要求。這些 Cloud KMS 記錄項目會顯示在記錄中。
在組織內要求或限制使用 CMEK
您可以設定組織層級政策,規範各種 Google Cloud 產品 (包括 Spanner) 的 CMEK 保護機制使用方式。這些政策可讓您:
要求貴組織建立的新 Spanner 資料庫使用 CMEK 保護措施。
限制組織中可用於 CMEK 保護措施的 Cloud KMS 金鑰。
詳情請參閱「CMEK 組織政策」。
後續步驟
- 瞭解如何使用 CMEK 保護資料庫。