本文說明如何輪替根金鑰。如果根金鑰遭到入侵,或您選擇定期輪替根金鑰以提高安全性,可以使用 RotationJob 資源將金鑰輪替至新的根金鑰。
輪替根金鑰會建立新的根金鑰,並成為主金鑰,包裝所有非根金鑰。根金鑰無法刪除,只能透過輪替來更換。如要進一步瞭解根金鑰,請參閱「根金鑰類型」。
如要進一步瞭解 KMS API,請參閱 KMS API 總覽;如要查看完整的 API 定義,請參閱金鑰管理服務 KRM API。
事前準備
輪替根金鑰前,您必須具備必要權限並準備環境。
要求 IAM 角色
如要輪替金鑰,請與 IAM 機構組織管理員聯絡,要求取得 KMS 輪替工作管理員 (kms-rotationjob-admin) 角色。
準備環境
產生 kubeconfig 檔案,設定
kubectl存取權。
輪替根金鑰
如要輪替根金鑰,請先找出使用中根金鑰的資源名稱。您可以檢查專案中的任何 AEADKey 資源,因為所有金鑰都由同一個根金鑰保護。
建立新的根金鑰並輪替金鑰:
列出專案中的
AEADKey資源:kubectl get AEADKey -n PROJECT將
PROJECT替換為專案命名空間的名稱。記下輸出內容中任何
AEADKey的名稱。從
AEADKey取得ROOT_KEY_RESOURCE_NAME。下列指令會擷取RotationJob資源所需的根金鑰 ID,並重新設定格式:kubectl describe aeadkey KEY_NAME -n PROJECT | grep "Root Key ID:" | awk '{print $4}' | awk -F/ '{print "namespaces/" $1 "/secrets/" $2}'更改下列內容:
KEY_NAME:專案中任何AEADKey的名稱PROJECT:專案命名空間的名稱
輸出內容大致如下:
namespaces/kms-system/secrets/kms-key-local-root建立 YAML 檔案,並新增
RotationJob資源和下列內容:apiVersion: "kms.gdc.goog/v1" kind: RotationJob metadata: name: ROTATION_NAME spec: rootKeyResourceName: ROOT_KEY_RESOURCE_NAME更改下列內容:
ROTATION_NAME:輪替工作的名稱,例如rotate-job1。ROOT_KEY_RESOURCE_NAME:您在上述步驟中取得的輸出內容
將 YAML 檔案的內容套用至 KMS:
kubectl apply -f FILENAME.yaml將 FILENAME 替換成 YAML 檔案的名稱。
執行指令後,KMS 會建立新的根金鑰,並使用新的根金鑰輪替每個金鑰。
如要確認根金鑰輪替作業已完成,請執行下列指令:
kubectl get rotationjobs ROTATION_NAME將 ROTATION_NAME 替換為輪替工作的名稱。
執行指令後,如果成功,輪替工作的狀態會顯示為
Completed。