輪替根金鑰

本文說明如何輪替根金鑰。如果根金鑰遭到入侵,或您選擇定期輪替根金鑰以提高安全性,可以使用 RotationJob 資源將金鑰輪替至新的根金鑰。

輪替根金鑰會建立新的根金鑰,並成為主金鑰,包裝所有非根金鑰。根金鑰無法刪除,只能透過輪替來更換。如要進一步瞭解根金鑰,請參閱「根金鑰類型」。

如要進一步瞭解 KMS API,請參閱 KMS API 總覽;如要查看完整的 API 定義,請參閱金鑰管理服務 KRM API。

事前準備

輪替根金鑰前,您必須具備必要權限並準備環境。

要求 IAM 角色

如要輪替金鑰,請與 IAM 機構組織管理員聯絡,要求取得 KMS 輪替工作管理員 (kms-rotationjob-admin) 角色。

準備環境

輪替根金鑰

如要輪替根金鑰,請先找出使用中根金鑰的資源名稱。您可以檢查專案中的任何 AEADKey 資源,因為所有金鑰都由同一個根金鑰保護。

建立新的根金鑰並輪替金鑰:

  1. 列出專案中的 AEADKey 資源:

    kubectl get AEADKey -n PROJECT
    

    將 PROJECT 替換為專案命名空間的名稱。

    記下輸出內容中任何 AEADKey 的名稱。

  2. 從 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
    
  3. 建立 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:您在上述步驟中取得的輸出內容
  4. 將 YAML 檔案的內容套用至 KMS:

    kubectl apply -f FILENAME.yaml
    

    將 FILENAME 替換成 YAML 檔案的名稱。

    執行指令後,KMS 會建立新的根金鑰,並使用新的根金鑰輪替每個金鑰。

  5. 如要確認根金鑰輪替作業已完成,請執行下列指令:

    kubectl get rotationjobs ROTATION_NAME
    

    將 ROTATION_NAME 替換為輪替工作的名稱。

    執行指令後,如果成功,輪替工作的狀態會顯示為 Completed。