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
Genera un archivo kubeconfig para configurar el acceso a
kubectl.
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:
Enumera los recursos
AEADKeyde tu proyecto:kubectl get AEADKey -n PROJECTReemplaza
PROJECTpor el nombre del espacio de nombres de tu proyecto.En el resultado, toma nota del nombre de cualquier
AEADKey.Obtén el
ROOT_KEY_RESOURCE_NAMEde laAEADKey. El siguiente comando extrae y cambia el formato del identificador de clave raíz necesario para el recursoRotationJob: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 cualquierAEADKeyen tu proyectoPROJECT: 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-rootCrea un archivo YAML y agrega el recurso
RotationJoby el siguiente contenido:apiVersion: "kms.gdc.goog/v1" kind: RotationJob metadata: name: ROTATION_NAME spec: rootKeyResourceName: ROOT_KEY_RESOURCE_NAMEReemplaza 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.
Aplica el contenido del archivo YAML al KMS:
kubectl apply -f FILENAME.yamlReemplaza 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.
Para verificar que se haya completado la rotación de claves raíz, ejecuta lo siguiente:
kubectl get rotationjobs ROTATION_NAMEReemplaza 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
Completedsi se realiza correctamente.