Rota una clave raíz

En este documento, se describe cómo rotar una clave raíz. Si tu clave raíz se ve comprometida o si decides rotar las claves raíz de forma periódica para mejorar la seguridad, puedes rotar tus claves a una nueva clave raíz con el recurso RotationJob.

Cuando se rota una clave raíz, se crea una nueva, que se convierte en la clave primaria y une todas las claves que no son raíz. No puedes borrar una clave raíz; la rotación es la única forma de reemplazarla. Consulta Tipos de claves raíz para obtener más información sobre las claves raíz.

Consulta la descripción general de la API de KMS para obtener detalles sobre la API de KMS y la API de KRM del servicio de administración de claves para ver la definición completa de la API.

Antes de comenzar

Antes de rotar una clave raíz, debes tener los permisos necesarios y preparar tu entorno.

Solicita roles de IAM

Para rotar las claves, comunícate con el administrador de la organización de IAM y solicita el rol de Administrador de trabajos de rotación de KMS (kms-rotationjob-admin).

Prepara el entorno

Rota una clave raíz

Para rotar una clave raíz, primero debes identificar el nombre del recurso de la clave raíz en uso. Puedes encontrar esta información examinando cualquier recurso AEADKey dentro de tu proyecto, ya que todas estas claves están protegidas por la misma clave raíz.

Crea una clave raíz nueva y rota tus claves:

  1. Enumera los recursos AEADKey de tu proyecto:

    kubectl get AEADKey -n PROJECT
    

    Reemplaza PROJECT por el nombre del espacio de nombres de tu proyecto.

    En el resultado, toma nota del nombre de cualquier AEADKey.

  2. Obtén el ROOT_KEY_RESOURCE_NAME de la AEADKey. El siguiente comando extrae y cambia el formato del identificador de clave raíz necesario para el recurso RotationJob:

    kubectl describe aeadkey KEY_NAME -n PROJECT | grep "Root Key ID:" | awk '{print $4}' | awk -F/ '{print "namespaces/" $1 "/secrets/" $2}'
    

    Reemplaza lo siguiente:

    • KEY_NAME: el nombre de cualquier AEADKey en tu proyecto
    • PROJECT: Es el nombre del espacio de nombres de tu proyecto.

    El resultado podría ser similar al siguiente:

    namespaces/kms-system/secrets/kms-key-local-root
    
  3. Crea un archivo YAML y agrega el recurso RotationJob y el siguiente contenido:

    apiVersion: "kms.gdc.goog/v1"
    kind: RotationJob
    metadata:
      name: ROTATION_NAME
    spec:
      rootKeyResourceName: ROOT_KEY_RESOURCE_NAME
    

    Reemplaza lo siguiente:

    • ROTATION_NAME: Es un nombre para el trabajo de rotación, por ejemplo, rotate-job1.
    • ROOT_KEY_RESOURCE_NAME: Es el resultado que obtuviste en el paso anterior.
  4. Aplica el contenido del archivo YAML al KMS:

    kubectl apply -f FILENAME.yaml
    

    Reemplaza FILENAME por el nombre del archivo YAML.

    Después de ejecutar el comando, el KMS crea una clave raíz nueva y rota cada clave con la clave raíz nueva.

  5. Para verificar que se haya completado la rotación de claves raíz, ejecuta lo siguiente:

    kubectl get rotationjobs ROTATION_NAME
    

    Reemplaza ROTATION_NAME por el nombre del trabajo de rotación.

    Después de ejecutar el comando, verás el estado del trabajo de rotación como Completed si se realiza correctamente.