Skip to content

Cambiar el vencimiento o los límites de uso de una clave

Cambia cuándo una clave deja de proteger datos, cuántos usos permite, si se puede exportar, o su nombre y su descripción.

Quién puede hacerlo

Un administrador del tenant, un gestor de claves del tenant o un superadministrador de plataforma que trabaja dentro del tenant. En un despliegue SaaS, el servidor rechaza a un administrador de la plataforma. La consola ofrece Editar metadatos solo cuando el servidor indica que puedes editar los metadatos de esta clave.

Antes de empezar

  • El vencimiento, los límites de uso y el ajuste de exportación pertenecen a la versión de material actual de la clave. Una clave activa, vencida o suspendida tiene una. Una clave revocada, archivada o pendiente de destrucción no tiene ninguna, así que solo pueden cambiar su nombre y su descripción.
  • Un límite que la clave ya alcanzó es definitivo. Una vez pasado el vencimiento, la fecha de vencimiento ya no se puede cambiar ni quitar; una vez agotado el número máximo de usos, el máximo tampoco. Rota la clave para darle un vencimiento y un límite de uso nuevos.
  • Un máximo nuevo debe estar por encima de los usos que la clave ya registró. Un máximo de 0, o un campo vacío, significa ilimitado. Los usos cuentan las operaciones de cifrado y de firma; el descifrado y la verificación no se cuentan.
  • Si tu tenant tiene una política de aprobación por quórum, un cambio que debilita la clave espera la aprobación: hacerla exportable, mover su vencimiento a una fecha posterior o quitarlo, o subir o quitar un límite de uso. Acortar una vida útil, bajar un límite, agregar un límite y hacer que una clave no sea exportable se aplican de inmediato.

Pasos

  1. Abre Inventario de claves y selecciona Ver detalles en la clave.
  2. Selecciona Editar metadatos al pie de los detalles de la clave. No se ofrece en la fila de la clave.
  3. En Editar metadatos, cambia lo que necesites:
    • Nombre y Descripción. Deja un campo vacío para quitarlo.
    • En Material de clave actual: Exportable, Fecha de vencimiento (o Quitar fecha), Fecha de advertencia, Límite máximo de uso y Límite de uso de advertencia.
  4. Revisa los Cambios que lista el diálogo y luego selecciona Guardar cambios.

El identificador, el algoritmo y el tipo se muestran en solo lectura: no se pueden cambiar después de la creación.

Qué ves cuando funcionó

La consola indica Metadatos de la clave actualizados, y los detalles de la clave muestran los valores nuevos. El cambio queda registrado en la auditoría, donde la pestaña Historial de auditoría lista cada campo antes y después.

Una clave que había dejado de proteger solo por un límite de advertencia no se ve afectada: la fecha de advertencia y el límite de uso de advertencia solo avisan. Si el cambio espera una aprobación por quórum, la consola muestra En espera de aprobación con un enlace a la solicitud de quórum, y la clave conserva sus valores actuales hasta que se den las aprobaciones.

Si falla

Qué ves Causa Qué hacer
Límite de protección de la clave alcanzado El vencimiento de la clave pasó, o su límite de uso se agotó, y el cambio nombra ese campo Cierra el diálogo y usa Rotar en la clave: la rotación le da un material actual nuevo con su propio vencimiento y su propio límite de uso
Esta clave no tiene material de clave actual, así que solo puedes cambiar su nombre y su descripción. La clave está revocada, archivada o pendiente de destrucción Solo se pueden cambiar el nombre y la descripción
No se actualizaron los metadatos, nombrando el límite Un máximo positivo igual o inferior a los usos ya registrados, un límite de uso de advertencia que no está por debajo del máximo, o una fecha de advertencia que no es anterior a la fecha de vencimiento Corrige los valores y guarda de nuevo
No se actualizaron los metadatos, nombrando el vencimiento La fecha de vencimiento está en el pasado Elige una fecha futura
No se ofrece Editar metadatos No tienes el permiso para editar los metadatos de las claves Pídeselo a un administrador del tenant

Sin la consola

Superficie Cómo
CLI de gestión de claves ankasecure-km keys update --kid <id> --body-file <json>, donde el archivo es un JSON merge patch
Admin SDK KeyOperations.update(String kid, AdminKeyMergePatchRequest patch)
API PATCH /api/v3/admin/tenants/{tenantId}/keys/{kid} (operación patchKeyMetadata), con un JSON merge patch

Relacionado