Skip to content

Revocar o destruir una versión de una clave

Actúa sobre una versión de material de una clave sin tocar la versión en uso: revoca una versión retirada, solicita su destrucción o cancela una destrucción programada de ella.

Quién puede hacerlo

Un administrador del tenant, un gestor de claves del tenant o un superadministrador de plataforma que trabaja dentro del tenant. Leer las versiones, revocar una, solicitar una destrucción y cancelarla son permisos distintos; la pestaña Linaje y cada acción solo aparecen con el permiso correspondiente. La aprobación de una destrucción la da una persona distinta de quien la solicita.

Antes de empezar

  • Una versión se puede revocar mientras está retirada o a punto de pasar a ser la actual. La versión en uso no se puede revocar por sí sola: rota la clave, o revoca la clave completa.
  • La causa de la revocación de una versión decide qué puede seguir haciendo después: descifrar o verificar datos históricos, y recifrar a partir de ella. Un compromiso de seguridad los detiene; cualquier otra causa los deja en manos de la política de ciclo de vida de tu tenant.
  • Una solicitud de destrucción siempre espera la aprobación de otra persona. Una vez aprobada, la versión se destruye cuando termina su periodo de espera, de 7 a 365 días después de la aprobación.
  • Cuando una versión es la última de la clave que todavía no se está destruyendo, solicitar su destrucción es la destrucción de toda la clave. Eso requiere una clave archivada y el permiso para solicitar destrucciones de claves, y la consola lo indica antes de que confirmes.

Pasos

  1. Abre Inventario de claves, selecciona Ver detalles en la clave y abre la pestaña Linaje.
  2. En la fila de la versión, abre Acciones del material. Solo ofrece las acciones que se aplican a esa versión.

Para revocar la versión:

  1. Selecciona Revocar.
  2. Elige la Causa y escribe el Motivo. Ambos son obligatorios; el motivo es la frase que lee un auditor.
  3. Selecciona Revocar material.

Para solicitar la destrucción de la versión:

  1. Selecciona Marcar para destrucción.
  2. De forma opcional, establece el Periodo de espera (días) y luego escribe el Motivo.
  3. Selecciona Marcar para destrucción. En la última versión de la clave, el diálogo se titula Solicitar la destrucción de toda la clave, y el botón es Solicitar la destrucción de la clave.

Para cancelar una destrucción programada de la versión:

  1. Selecciona Cancelar la destrucción en una versión pendiente de destrucción.
  2. Confirma con Cancelar la destrucción.

Qué ves cuando funcionó

  • Revocación: la consola indica que la versión está revocada, y la pestaña Linaje la muestra revocada con su causa. Solo cambia esa versión.
  • Solicitud de destrucción: el diálogo muestra En espera de aprobación con un enlace a la solicitud de quórum, y nada cambia hasta que otra persona apruebe la solicitud. Una vez aprobada, la versión aparece como pendiente de destrucción, y la plataforma la destruye cuando termina el periodo de espera. Destruir la última versión de la clave destruye la clave y termina todas las autorizaciones que la nombran, igual que destruir la clave.
  • Cancelación: la consola indica que la destrucción de esa versión está cancelada. La versión conserva su material de clave y vuelve al estado que tenía antes. Si la versión formaba parte de una destrucción de toda la clave, se cancela la destrucción de toda la clave.

Cada acto queda registrado en la auditoría.

Si falla

Qué ves Causa Qué hacer
No se muestra Acciones del material en una versión No se aplica ninguna acción a esa versión, o te falta el permiso Revisa el estado de la versión
Se rechaza la revocación por ser una transición no válida La versión es la que está en uso, o su estado no permite la revocación Rota primero la clave, o revoca la clave completa
Introduce un número entero de días entre 7 y 365. El periodo de espera está fuera de sus límites Corrígelo, o déjalo vacío
No se pudo marcar el material para destrucción El servidor lo rechazó: para la última versión de la clave, la clave no está archivada; ya hay una solicitud en espera para la misma versión; o no hay ningún aprobador habilitado aparte de ti Lee el motivo que se muestra, corrígelo e inténtalo de nuevo
No se pudo cancelar la destrucción La versión ya no está pendiente de destrucción, o la destrucción ya se ejecutó Vuelve a abrir la pestaña Linaje para ver el estado de la versión

Sin la consola

Superficie Cómo
CLI de gestión de claves ankasecure-km materials revoke --kid <id> --material-version <n> --cause <cause> --reason <text>; ankasecure-km destruction request-version --kid <id> --material-version <n> --reason <text> [--cooling-off-days <7..365>]; ankasecure-km destruction cancel-version --kid <id> --material-version <n>
Admin SDK MaterialOperations.revoke(String stableKid, int version, MaterialRevokeRequest request); DestructionOperations.requestVersion(String stableKid, int version, MaterialMarkForDestructionRequest request); DestructionOperations.cancelVersion(String stableKid, int version)
API POST /api/v3/admin/tenants/{tenantId}/keys/{stableKid}/materials/{version}/revoke (operación revokeKeyMaterialVersion); POST …/materials/{version}/mark-for-destruction (operación markKeyMaterialVersionForDestruction), que responde 202 con la solicitud de quórum; POST …/materials/{version}/cancel-destruction (operación cancelKeyMaterialVersionDestruction)

Relacionado