Auditoría de acceso en ns8-candados: Implementación de access.log y registro de eventos (authorize/get/lock)

2026-03-07 08:00:14 -03:00
parent 8243315e4f
commit 604653ee5e
2 changed files with 32 additions and 2 deletions
@@ -26,6 +26,15 @@
  - `ruby ns8-candados.rb list`: Lista las claves guardadas (requiere autorización).
  - `ruby ns8-candados.rb get <clave>`: Recupera el valor descifrado (requiere autorización).

+## 🛡️ Auditoría (logging)
+La herramienta mantiene un archivo `access.log` en su directorio local que registra de forma inmutable:
+- **Timestamp**: Fecha y hora exacta de la acción.
+- **Usuario**: El usuario del sistema operativo que ejecutó el comando.
+- **Acción**: `AUTHORIZE`, `GET`, `LOCK`, `DENIED` o `EXPIRED`.
+- **Detalle**: Nombre de la clave solicitada (solo en comandos `get`).
+
+El archivo tiene permisos `600` para asegurar que solo el propietario pueda auditar los accesos.
+
 ## 🧠 Contexto para IA
 - **Flujo Obligatorio**: Los agentes de IA DEBEN ejecutar `authorize` antes de intentar recuperar cualquier clave.
 - **Captura Segura**: Capturar siempre la salida en variables silenciadas: