Skip to content

Buscar una clave y revisar su estado, sus versiones y sus rotaciones

Encuentra una clave de tu tenant y lee en qué situación está: su estado y sus límites, sus versiones de material, cómo y cuándo rota, y si se solicitó su destrucción.

Quién puede hacerlo

Cualquiera que tenga el permiso para leer claves: todos los roles integrados del tenant, y todos los roles integrados de la plataforma que trabajan dentro del tenant. Algunas partes del detalle de una clave necesitan otro permiso de lectura:

  • La pestaña Linaje necesita el permiso para leer las versiones de material.
  • La columna y la fila Próxima rotación necesitan el permiso para leer los calendarios de rotación.
  • La pestaña Calendario de rotación necesita el permiso para leer los calendarios del tenant, que tienen los roles integrados del tenant y no los roles integrados de la plataforma.

Antes de empezar

  • Conoce el identificador de la clave, o lo suficiente de él para buscarlo. Una clave conserva un solo identificador durante toda su vida; rotarla agrega una versión de material con el mismo identificador.
  • El detalle que se describe aquí es de solo lectura. Cambiar el estado de una clave es otra tarea.

Pasos

  1. Abre Inventario de claves. Los gestores de claves llegan a él al iniciar sesión; los administradores del tenant lo abren desde la navegación de su tenant.
  2. Acota la lista:
    • Escribe parte del identificador en Buscar por ID de clave.... La búsqueda acota las claves de la página actual.
    • Elige un estado, de Todos los estados a Destruidas (solo lectura), que muestra las claves destruidas con su causa y sus fechas.
    • Elige un tipo de clave en Todos los tipos, o un veredicto de Conformidad frente a tu política de algoritmos.
    • Selecciona Solo sin referencias para quedarte con las claves de la página actual que nada referencia.
  3. Lee la fila: ID de clave, Tipo, Algoritmo, Estado, Conformidad, Uso, Referencias, Vence y Próxima rotación.
  4. Selecciona la fila, o Ver detalles, para abrir el detalle de la clave.
  5. En Detalles, lee:
    • Información de la clave: el ID de clave, la Identidad de la clave que nombra esta única clave, el Origen, el Nivel de seguridad, la fecha de Vence y la Próxima rotación.
    • Ciclo de vida y uso: el Estado, por qué la clave dejó de proteger cuando lo hizo, la causa y las fechas de una revocación o de un archivado, si es Exportable, sus Operaciones de la clave, su Uso frente a su límite y su Límite de advertencia.
    • Rotación automática: si Rotar esta clave automáticamente está activado, las condiciones de Cuándo rotar y la Tolerancia.
    • Destrucción: para una clave archivada, pendiente de destrucción o destruida, la solicitud y las órdenes de destrucción.
    • Metadatos JSON sin procesar: la lectura completa de la clave, que puedes copiar.
  6. Selecciona Linaje para ver cada versión de material con su Versión, su estado, su algoritmo, la Causa de la rotación, Activada, Retirada, el vencimiento y la Revocación.
  7. Selecciona Calendario de rotación para ver el calendario de la clave y sus ejecuciones. Con más de un calendario, Ver ejecuciones elige de cuál se muestran las ejecuciones.
  8. Selecciona Acceso para ver las concesiones de capacidad que nombran la clave, e Historial de auditoría para la propia auditoría de la clave.

Qué ves cuando funcionó

El detalle muestra el estado de la clave tal como lo leyó el servidor al abrirlo, y su pie solo ofrece las acciones que el servidor permite ahora sobre esa clave. Cuando no tienes ninguna acción del ciclo de vida disponible, el pie indica por qué.

Dos veredictos del servidor se muestran donde actuarías sobre ellos, no en el detalle: si la clave puede rotar ahora, cuando inicias Rotar, y qué haría cada causa a las lecturas de esta clave, cuando abres Suspender o Revocar.

Si falla

Qué ves Causa Qué hacer
Un enlace a una clave indica "No se encontró la clave «{kid}» en este tenant." No existe ninguna clave con ese identificador en tu tenant Revisa el identificador; una clave destruida aparece en Destruidas (solo lectura)
El detalle de la clave muestra que la lectura falló, con Reintentar La lectura de la clave falló Selecciona Reintentar
La búsqueda no encuentra nada aunque la clave existe La búsqueda solo acota la página actual Borra la búsqueda y recorre las páginas de la lista, o acótala con los filtros de estado y de tipo
No aparece la pestaña Linaje o Calendario de rotación No tienes el permiso de lectura que necesita Pide el permiso a un administrador
"La rotación automática no está activada para esta clave" La clave no tiene calendario de rotación No pasa nada; activa Rotar esta clave automáticamente si quieres uno

Sin la consola

Cuatro de estas lecturas no tienen un control propio en la consola: una sola versión de material, las ejecuciones de rotación de la clave, las órdenes de destrucción de la clave como lista, y la propia lectura de metadatos del servicio criptográfico, que hace una aplicación y cuyo permiso no tiene ningún rol integrado.

Superficie Cómo
CLI de gestión de claves ankasecure-km keys list (con --status, --origin, --restricted, --kty, --conformance y paginación), keys get --kid <id>, materials list --kid <id>, materials get --kid <id> --material-version <n>, rotation schedule --kid <id>, rotation executions --kid <id>, rotation admissibility --kid <id>, keys lifecycle-cause-verdicts --kid <id> y destruction orders --kid <id>
Admin SDK KeyOperations.list(KeyListQuery), KeyOperations.get(String), KeyOperations.lifecycleCauseVerdicts(String), MaterialOperations.list(String), MaterialOperations.get(String, int), RotationOperations.schedule(String), RotationOperations.listExecutions(String, RotationExecutionListQuery), RotationOperations.admissibility(String) y DestructionOperations.orders(String). Una aplicación lee los metadatos del servicio criptográfico con getKeyMetadata(String) del SDK
API GET /api/v3/admin/tenants/{tenantId}/keys (operación listKeys), GET /api/v3/admin/tenants/{tenantId}/keys/{kid} (getKeyMetadata), GET /api/v3/admin/tenants/{tenantId}/keys/{kid}/materials (listKeyMaterialVersions), GET /api/v3/admin/tenants/{tenantId}/keys/{kid}/materials/{version} (getKeyMaterialVersion), GET /api/v3/admin/tenants/{tenantId}/keys/{kid}/rotation-schedule (getKeyRotationSchedule), GET /api/v3/admin/tenants/{tenantId}/keys/{kid}/rotation-executions (listKeyRotationExecutions), GET /api/v3/admin/tenants/{tenantId}/keys/{kid}/rotation-admissibility (rotationAdmissibility), GET /api/v3/admin/tenants/{tenantId}/keys/{kid}/lifecycle-cause-verdicts (getKeyLifecycleCauseVerdicts) y GET /api/v3/admin/tenants/{tenantId}/keys/{kid}/destruction-orders (listKeyDestructionOrders). Una aplicación lee GET /api/v3/key-management/keys/{kid}/metadata (operación getKeyMetadata del servicio criptográfico)

Relacionado