En este documento se describe cómo rotar una clave raíz. Si tu clave raíz se ve vulnerada o si decides rotar periódicamente las claves raíz para mejorar la seguridad, puedes rotar tus claves a una nueva clave raíz mediante el recurso RotationJob.
Al rotar una clave raíz, se crea una nueva clave raíz, que se convierte en la clave principal y envuelve todas las claves que no son raíz. No puedes eliminar una clave raíz; la rotación es la única forma de sustituirla. Consulta Tipos de claves raíz para obtener más información sobre las claves raíz.
Consulta la información general de la API de KMS para obtener más información sobre la API de KMS y la API de KRM del servicio de gestión de claves para ver la definición completa de la API.
Antes de empezar
Antes de rotar una clave raíz, debes tener los permisos necesarios y preparar tu entorno.
Solicitar roles de gestión de identidades y accesos
Para rotar claves, ponte en contacto con el admin. de la org. de gestión de identidades y accesos para solicitar el rol de administrador de tareas de rotación de KMS (kms-rotationjob-admin).
Prepara tu entorno
Genera un archivo kubeconfig para configurar el acceso de
kubectl.
Rotar una clave raíz
Para rotar una clave raíz, primero debes identificar el nombre de recurso de la clave raíz que se está usando. Para encontrar esta información, examina cualquier recurso AEADKey de tu proyecto, ya que todas estas claves están protegidas por la misma clave raíz.
Crea una clave raíz y rota tus claves:
Enumera los recursos de
AEADKeyde tu proyecto:kubectl get AEADKey -n PROJECTSustituye
PROJECTpor el nombre del espacio de nombres de tu proyecto.En el resultado, anota el nombre de cualquier
AEADKey.Descarga
ROOT_KEY_RESOURCE_NAMEenAEADKey. 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}'Haz los cambios siguientes:
KEY_NAME: el nombre de cualquierAEADKeyde tu proyectoPROJECT: el nombre del espacio de nombres de tu proyecto
El resultado debería ser similar al siguiente:
namespaces/kms-system/secrets/kms-key-local-rootCrea un archivo YAML y añade el recurso
RotationJoby el siguiente contenido:apiVersion: "kms.gdc.goog/v1" kind: RotationJob metadata: name: ROTATION_NAME spec: rootKeyResourceName: ROOT_KEY_RESOURCE_NAMEHaz los cambios siguientes:
ROTATION_NAME: un nombre para la tarea de rotación (por ejemplo,rotate-job1).ROOT_KEY_RESOURCE_NAME: el resultado que has obtenido en el paso anterior
Aplica el contenido del archivo YAML al KMS:
kubectl apply -f FILENAME.yamlSustituye FILENAME por el nombre del archivo YAML.
Después de ejecutar el comando, el KMS crea una clave raíz y rota todas las claves con la nueva clave raíz.
Para verificar que la rotación de la clave raíz se ha completado, ejecuta lo siguiente:
kubectl get rotationjobs ROTATION_NAMESustituye ROTATION_NAME por el nombre de la tarea de rotación.
Después de ejecutar el comando, verás el estado de la tarea de rotación como
Completedsi se ha completado correctamente.