轮替根密钥

本文档介绍了如何轮替根密钥。如果您的根密钥遭到入侵,或者您选择定期轮替根密钥以增强安全性,则可以使用 RotationJob 资源将密钥轮替为新的根密钥。

轮替根密钥会创建一个新的根密钥,该密钥会成为主密钥并封装所有非根密钥。您无法删除根密钥;轮替是替换根密钥的唯一方法。如需详细了解根密钥,请参阅根密钥类型。

如需详细了解 KMS API,请参阅 KMS API 概览;如需查看完整的 API 定义,请参阅 Key Management Service 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 资源所需的根密钥标识符并重新设置其格式:

    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。