Ver el historial completo de una clave, un usuario, un actor o una concesión
Lee todo lo que la traza de auditoría guarda sobre un objeto de tu tenant: cada operación que usó una clave, cada cambio administrativo que hizo un usuario, y el historial de un actor o de una concesión de capacidad.
Quién puede hacerlo
Un administrador del tenant o un auditor del tenant, y un superadministrador o un auditor de la plataforma que trabaje en tu tenant. Las operaciones con una clave necesitan el permiso para leer la traza criptográfica; los cambios y las acciones de un usuario necesitan el permiso para leer la traza administrativa. Una parte que no puedes leer se indica como no legible con tus permisos, nunca se muestra vacía.
Antes de empezar
- El historial de cada objeto se muestra en el propio detalle de ese objeto, no solo en el registro de auditoría.
- Un identificador de clave nombra una sola clave y nunca se reutiliza en un tenant, así que el historial de una clave es solo el de esa clave.
Pasos
- Para una clave: abre Inventario de claves, selecciona la clave y abre Historial de auditoría. Lista cada operación que usó la clave, con la identidad de la clave y las claves que usó cada operación, y los cambios administrativos de la clave.
- Para un usuario: abre Usuarios, selecciona el usuario y abre Actividad. Lista las acciones administrativas que realizó ese usuario.
- Para un actor criptográfico o una concesión de capacidad: abre Actores criptográficos o Concesiones de capacidad, selecciónalo y abre Actividad. Lista las operaciones que lo nombran y los cambios administrativos que se le hicieron. Selecciona Cargar más para ver entradas más antiguas.
- Para ver el mismo historial con todos los filtros del registro de auditoría, selecciona Ver en auditoría. El registro de auditoría se abre ya acotado a ese sujeto en los últimos 365 días.
- Para seguir una fila a través de los servicios, selecciona Trazar la solicitud en ella.
Qué ves cuando funcionó
Cada historial se lista de la entrada más reciente a la más antigua, con su uso y su administración lado a lado. El panel indica cuándo una parte está completa, cuándo se retienen las entradas más antiguas hasta que se cargue la otra parte, y cuándo una lectura llegó a su límite.
Si falla
| Qué ves | Causa | Qué hacer |
|---|---|---|
| "La actividad de uso no es legible con tus permisos actuales." o "La actividad administrativa no es legible con tus permisos actuales." | No puedes leer esa traza | Pide un rol que la agregue, como el rol de auditor del tenant |
| "No se pudo cargar la actividad." | La lectura falló | Vuelve a intentarlo |
| "No se pudo cargar el registro de actividad" en un usuario | No se pudieron leer las acciones administrativas del usuario | Vuelve a intentarlo |
Sin la consola
La consola no tiene ningún control para el historial de un cliente (el identificador de cliente que presentó una aplicación); usa la API para eso.
| Superficie | Cómo |
|---|---|
| API, una clave | GET /api/v3/audit/tenants/{tenantId}/crypto/keys/{keyId}/history (operación getKeyHistory), con materialVersion, startTime y endTime opcionales |
| API, el uso de una clave por versión de material | GET /api/v3/audit/tenants/{tenantId}/crypto/keys/{keyId}/material-usage (getKeyMaterialUsage), con from y to opcionales; la ventana tiene un máximo de 365 días |
| API, las acciones administrativas de un usuario o un actor | GET /api/v3/audit/tenants/{tenantId}/admin/actors/{actorId}/history (getActorHistory) |
| API, los cambios de una entidad | GET /api/v3/audit/tenants/{tenantId}/admin/entities/{entityType}/{entityId}/history (getEntityHistory), con includeChildren=true para agregar los registros de sus entidades hijas |
| API, un cliente (sin control en la consola) | GET /api/v3/audit/tenants/{tenantId}/crypto/clients/{clientId}/history (getClientHistory), con startTime y endTime opcionales |
No hay ningún comando de la CLI ni método del Admin SDK para el historial de auditoría.