En esta página, se muestra cómo programar una versión de clave de Cloud Key Management Service para su destrucción permanente. En Cloud KMS, el material de clave criptográfica que usas para encriptar, desencriptar, firmar y verificar los datos se almacena en una versión de clave. Una clave tiene cero o más versiones de clave. Cuando rotas una clave, creas una versión de clave nueva.
Destruir una versión de clave significa que el material de la clave se borra de forma permanente. Cuando destruyes una versión de clave, no se borran otros detalles, como el nombre y el número de la versión de clave. Una vez que se destruye una clave, no se pueden desencriptar los datos que se encriptaron con la versión de clave.
La única excepción es la reimportación de claves, que te permite restablecer una clave importada anteriormente proporcionando el mismo material de claves original.
Dado que la destrucción de claves suele ser irreversible, Cloud KMS no permite destruir versiones de claves de inmediato. En su lugar, programa una versión de clave para su destrucción. La versión de clave permanece en el estado de destrucción programada durante un tiempo configurable. Durante el período programado para la destrucción, puedes restablecer una versión de clave para cancelar su destrucción.
La duración predeterminada de la destrucción programada es de 30 días. Puedes establecer una duración personalizada programada para la destrucción de una clave durante la creación de la clave. Tu organización puede aplicar una duración mínima programada de destrucción si establece la restricción Duración mínima programada de destrucción por clave en sus políticas de la organización.
También puedes administrar el acceso a la clave mediante la administración de identidades y accesos (IAM). Las operaciones de IAM son coherentes en segundos. Para obtener más información, consulta Usa IAM.
También puedes inhabilitar una versión de clave de forma temporal. Te recomendamos que inhabilites las versiones de clave antes de programar su destrucción como parte de tus procedimientos para garantizar que la clave se pueda destruir de forma segura. Según las políticas de tu organización, es posible que debas inhabilitar una versión de clave antes de programar su destrucción. Para obtener más información sobre cómo controlar la destrucción de versiones de claves con políticas de la organización, consulta Controla la destrucción de versiones de claves.
En el resto de este documento, se habla de la destrucción de la clave para hacer referencia a programar una clave para su destrucción, aunque la destrucción no sea inmediata.
Antes de comenzar
Comprende los riesgos
La destrucción de una versión de clave es una operación permanente. Destruir una versión de clave que aún se necesita tiene los siguientes riesgos:
Interrupción del servicio: Si destruyes una clave que se requiere para iniciar un contenedor o una instancia, es posible que tus servicios o aplicaciones dejen de estar disponibles.
Pérdida permanente de datos: Si destruyes una clave que se usó para encriptar datos, esos datos dejarán de estar disponibles. Los datos encriptados con una clave que se destruyó se consideran destruidos criptográficamente. En algunos casos, destruir una clave puede provocar que los recursos encriptados se borren de forma permanente.
Problemas de cumplimiento o reglamentarios: Si destruyes una clave que se requiere para acceder a datos sujetos a un período de retención antes de que se complete ese período, es posible que incumplas un requisito reglamentario o de cumplimiento.
Roles obligatorios
Para obtener los permisos que necesitas para destruir y restablecer versiones de claves,
pídele a tu administrador que te otorgue el
rol de IAM de administrador de Cloud KMS (roles/cloudkms.admin
)
en la clave.
Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso a proyectos, carpetas y organizaciones.
También puedes obtener los permisos necesarios mediante roles personalizados o cualquier otro rol predefinido.
Cómo verificar si se está usando la versión de la llave
Antes de destruir una versión de clave, completa los siguientes pasos para ver si está en uso:
Consulta los detalles del seguimiento de uso de la clave. Si algún recurso está protegido por la versión de clave que deseas destruir, vuelve a encriptarlo con otra versión de clave.
Activa los registros de cualquier servicio o aplicación que pueda estar usando la versión de la clave.
Activa los registros en el proyecto de Cloud KMS que contiene la clave.
Inhabilita la versión de clave. Inhabilitar la versión de clave impide que se use. Con la versión de clave inhabilitada, fallarán todos los intentos de usarla.
Supervisa los registros hasta que te asegures de que ninguna aplicación o servicio siga dependiendo de la versión de clave que inhabilitaste. Si algún error indica que falló el acceso a la versión de la clave, configura la aplicación o el recurso para que usen otra versión de la clave.
El tiempo que dedicas a supervisar los registros antes de destruir una versión de clave depende del tipo de clave, su patrón de uso y su nivel de sensibilidad. Por ejemplo, antes de destruir una versión de clave que se usa en un proceso que se ejecuta trimestralmente, mantén inhabilitada la versión de clave hasta que ese proceso se complete correctamente.
Verifica el uso de la clave en relación con los requisitos de cumplimiento aplicables. Por ejemplo, la versión de clave y los datos encriptados con ella pueden estar sujetos a períodos de retención de datos.
Estos pasos te ayudan a identificar si aún se necesita una clave, pero no pueden garantizar que ya no se necesite una versión de clave. Tu organización debe implementar procedimientos y lineamientos para garantizar que la destrucción de la versión de la clave no cause efectos negativos.
Destruir una versión de clave
Puedes destruir una versión de clave habilitada o inhabilitada.
Console
En la consola de Google Cloud , ve a la página Administración de claves.
Marca la casilla junto a la versión de clave que deseas programar para la destrucción.
Haz clic en Destruir en el encabezado.
En el mensaje de confirmación, ingresa el nombre de la clave y, luego, haz clic en Programar destrucción.
gcloud
Para usar Cloud KMS en la línea de comandos, primero instala o actualiza a la versión más reciente de Google Cloud CLI.
gcloud kms keys versions destroy KEY_VERSION \ --key KEY_NAME \ --keyring KEY_RING \ --location LOCATION
Reemplaza lo siguiente:
KEY_VERSION
: Es el número de versión de la versión de la clave que deseas destruir.KEY_NAME
: Es el nombre de la clave para la que deseas destruir una versión.KEY_RING
: el nombre del llavero de claves que incluye la claveLOCATION
: la ubicación de Cloud KMS del llavero de claves.
Para obtener información sobre todas las marcas y los valores posibles, ejecuta el comando con la marca --help
.
C#
Para ejecutar este código, primero configura un entorno de desarrollo de C# e instala el SDK de C# para Cloud KMS.
Go
Para ejecutar este código, primero configura un entorno de desarrollo de Go y, luego, instala el SDK de Go para Cloud KMS.
Java
Para ejecutar este código, primero configura un entorno de desarrollo de Java y, luego, instala el SDK de Java para Cloud KMS.
Node.js
Para ejecutar este código, primero configura un entorno de desarrollo de Node.js y, luego, instala el SDK de Node.js para Cloud KMS.
PHP
Para ejecutar este código, primero obtén información sobre cómo usar PHP en Google Cloud y, luego, instala el SDK de PHP para Cloud KMS.
Python
Para ejecutar este código, primero configura un entorno de desarrollo de Python y, luego, instala el SDK de Python para Cloud KMS.
Ruby
Para ejecutar este código, primero configura un entorno de desarrollo de Ruby y, luego, instala el SDK de Ruby para Cloud KMS.
API
En estos ejemplos, se usa curl como un cliente HTTP para demostrar el uso de la API. Para obtener más información sobre el control de acceso, consulta Accede a la API de Cloud KMS.
Llama al método CryptoKeyVersions.destroy para destruir una versión de clave.
curl "https://cloudkms.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/keyRings/KEY_RING/cryptoKeys/KEY_NAME/cryptoKeyVersions/KEY_VERSION:destroy" \ --request "POST" \ --header "authorization: Bearer TOKEN"
Si no puedes destruir una versión de clave, es posible que tu organización requiera que las versiones de clave se inhabiliten antes de la destrucción. Intenta inhabilitar la versión de clave antes de destruirla.
Cuando envías la solicitud de destrucción, el estado de la versión de clave pasa a estar programado para su destrucción. Una vez que transcurre la duración programada configurada para la destrucción de la clave, el estado de la versión de clave pasa a ser destruido, lo que significa que comenzó la eliminación lógica del material de la clave de los sistemas activos y el cliente no puede recuperar el material de la clave. El material de la clave puede permanecer en los sistemas de Google hasta 45 días después de la hora de destrucción programada.
A fin de recibir una alerta cuando una versión de clave está programada para su destrucción, consulta Usa Cloud Monitoring con Cloud KMS.
Las versiones de clave destruidas no son recursos facturados.
Destruye claves externas
Para quitar de forma permanente la asociación entre una clave de Cloud EKM y una clave externa, puedes destruir la versión de la clave. La clave se destruye después de que pasa el período Programada para su destrucción. Una vez que se destruye la versión de clave, ya no puedes encriptar ni desencriptar los datos que se encriptaron con la versión de clave de Cloud EKM.
La destrucción de una versión de una clave administrada manualmente en Cloud KMS no modifica la clave en el administrador de claves externo. Te recomendamos que primero destruyas la clave o la versión de clave en Google Cloud. Después de que se destruya la versión de la clave de Cloud EKM, puedes destruir el material de la clave en el administrador de claves externo.
La destrucción de una versión de clave externa coordinada en Cloud KMS primero destruye la versión de clave en Google Cloudy, luego, envía una solicitud de destrucción al EKM para destruir el material de la clave externa.
Restablece una versión de clave
Durante el período en el que el estado de una versión de clave está programado para su destrucción, puedes restablecer la versión de clave enviando una solicitud de restablecimiento.
Console
Ve a la página Administración de claves en la consola de Google Cloud .
Haz clic en el nombre del llavero de claves que contiene la clave cuya versión se restablecerá.
Haz clic en la clave cuya versión de clave deseas restablecer.
Marca la casilla junto a la versión de clave que deseas restablecer.
Haga clic en Restablecer en el encabezado.
En el mensaje de confirmación, haz clic en Restablecer.
gcloud
Para usar Cloud KMS en la línea de comandos, primero instala o actualiza a la versión más reciente de Google Cloud CLI.
gcloud kms keys versions restore key-version \ --key key \ --keyring key-ring \ --location location
Reemplaza key-version por la versión de la clave que deseas restablecer. Reemplaza key por el nombre de la clave. Reemplaza key-ring por el nombre del llavero de claves en el que se encuentra la clave. Reemplaza location por la ubicación de Cloud KMS para el llavero de claves.
Para obtener información sobre todas las marcas y los valores posibles, ejecuta el comando con la marca --help
.
C#
Para ejecutar este código, primero configura un entorno de desarrollo de C# e instala el SDK de C# para Cloud KMS.
Go
Para ejecutar este código, primero configura un entorno de desarrollo de Go y, luego, instala el SDK de Go para Cloud KMS.
Java
Para ejecutar este código, primero configura un entorno de desarrollo de Java y, luego, instala el SDK de Java para Cloud KMS.
Node.js
Para ejecutar este código, primero configura un entorno de desarrollo de Node.js y, luego, instala el SDK de Node.js para Cloud KMS.
PHP
Para ejecutar este código, primero obtén información sobre cómo usar PHP en Google Cloud y, luego, instala el SDK de PHP para Cloud KMS.
Python
Para ejecutar este código, primero configura un entorno de desarrollo de Python y, luego, instala el SDK de Python para Cloud KMS.
Ruby
Para ejecutar este código, primero configura un entorno de desarrollo de Ruby y, luego, instala el SDK de Ruby para Cloud KMS.
API
En estos ejemplos, se usa curl como un cliente HTTP para demostrar el uso de la API. Para obtener más información sobre el control de acceso, consulta Accede a la API de Cloud KMS.
Llama al método CryptoKeyVersions.restore para restablecer una versión de clave.
curl "https://cloudkms.googleapis.com/v1/projects/project-id/locations/location-id/keyRings/key-ring-id/cryptoKeys/crypto-key-id/cryptoKeyVersions/version-id:restore" \ --request "POST" \ --header "authorization: Bearer token"
Una vez que se completa la solicitud de restablecimiento, el estado de la versión de clave pasa a inhabilitado. Debes habilitar la clave para poder usarla.
Permisos de IAM obligatorios
Para destruir una versión de clave, el emisor necesita el permiso cloudkms.cryptoKeyVersions.destroy
de IAM en la clave, el llavero de claves o el proyecto, la carpeta o la organización.
Para restablecer una versión de clave, el emisor necesita el permiso cloudkms.cryptoKeyVersions.restore
.
Ambos permisos se otorgan a la función de administrador de Cloud KMS (roles/cloudkms.admin
).
Cronograma de eliminación
Cloud KMS se compromete a borrar el material de las claves del cliente de toda la infraestructura de Google en un plazo de 45 días a partir de la hora de destrucción programada. Esto incluye la eliminación de datos de los sistemas activos y de las copias de seguridad de los centros de datos. Otros datos del cliente están sujetos al cronograma de eliminación de Google Cloud estándar de 180 días.