Unidad 2.3: Activity Logs y la pista de auditoría
Introducción
Un auditor rara vez pregunta qué ocurrió el mes pasado. Pregunta qué ocurrió un día específico hace un año, quién lo hizo y cómo sabe usted que el registro no ha sido alterado. El registro de actividad de la plataforma responde a las dos primeras preguntas solo durante un período limitado, y lo hace por contrato. El resto de la ruta de auditoría es una arquitectura que usted construye.
Esta unidad explica las propiedades fijas del registro de actividad y luego diseña el patrón en torno a ellas: extracción, exportación, agregación y bloqueo. Es una unidad de diseño; la Unidad 5.2 construye el bucket y la Unidad 7.2 los planos de observabilidad más amplios.
1. Qué le ofrece el registro de actividad
1.1 Alcance y acceso
El registro de actividad registra las acciones realizadas en un contrato: inicios de sesión de usuarios, aprovisionamiento de recursos, cambios de configuración, acceso a datos y más. Para cada entrada, también puede hacer seguimiento del origen de una acción, de los recursos afectados por la actividad y de la línea temporal de los eventos. Los registros de trazabilidad están limitados a productos IaaS, por lo que la evidencia de auditoría para los servicios PaaS gestionados debe provenir de otra fuente.
Cuatro propiedades son fijas:
- Por contrato. El registro de actividad se agrupa por contrato y puede refinarse utilizando intervalos de fechas. Lo recupera por número de contrato.
- Solo lectura. Todas las llamadas al registro de actividad son solicitudes
GET, por lo que ninguna llamada a la API modifica una entrada. - Solo API. El registro de actividad está disponible únicamente a través de su API RESTful, en
https://api.ionos.com/activitylog/v1, con autenticación Basic o un token Bearer. - Retención de 35 días. El período de retención de datos es de 35 días. Una vez que expira, se purgan los datos anteriores al período de retención.
Los propietarios de contrato y los administradores pueden acceder a la API del registro de actividad de forma predeterminada y pueden conceder acceso a las cuentas de usuario a través del privilegio Access Activity Log. Trate ese privilegio como sensible: la plataforma clasifica el acceso al registro de actividad, con sus perfiles de uso de la organización, como acceso a datos sensibles.
1.2 Lo que no hace
El registro de actividad no envía nada. Su interfaz consiste únicamente en llamadas de lectura, por lo que cada consumidor realiza la extracción de datos. Tampoco realiza agregación. Una credencial puede listar los contratos a los que está autorizada a acceder a través del endpoint /contracts, pero las entradas de cada contrato se recuperan por separado. Un grupo de contratos, por lo tanto, requiere un punto de agregación que usted administre.
2. El patrón de exportación
2.1 La ventana de 35 días es un plazo límite
Dado que las entradas se eliminan después de 35 días, el período de retención no es su archivo; es el tiempo que tiene para copiar cada entrada en un lugar duradero. IONOS CLOUD recomienda descargar los datos y almacenarlos en un almacenamiento diferente, como IONOS Cloud Object Storage, para una persistencia más prolongada. Diseñe la exportación de manera que una falla se detecte y repare con suficiente margen dentro de la ventana:
- Ejecute un exportador programado bajo un usuario de automatización dedicado (Unidad 2.2) que solo tenga el privilegio de Access Activity Log, con un token Bearer.
- Enumere los contratos con
GET /contracts, y luego recupere cada uno conGET /contracts/{contractNumber}, utilizando los filtrosdateStartydateEnd, y paginación conlimityoffset. El tamaño máximo de página es 10000. - Solape las ventanas. Recupere un rango que se solape con la ejecución anterior, y elimine duplicados en el campo
@uuidde la entrada, de modo que una ejecución omitida no implique ninguna pérdida. - Genere alertas por huecos. Monitoree la marca de tiempo más reciente exportada por contrato. Un exportador que ha estado en silencio durante días es un incidente, porque cada día de silencio consume parte del presupuesto de 35 días.
curl -s -H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" \
"https://api.ionos.com/activitylog/v1/contracts/$CONTRACT?dateStart=$START&dateEnd=$END&limit=10000&offset=0"
El punto del fragmento es arquitectónico: el intervalo de tiempo es responsabilidad suya de administrarlo, y el exportador, no la plataforma, es el responsable de la integridad.
2.2 Hacer que el archivo sea resistente a la manipulación
El destino del archivo es IONOS Cloud Object Storage con Object Lock. Object Lock aplica una protección de escritura única y lectura múltiple (WORM) a los objetos, de modo que no puedan eliminarse ni modificarse durante un período especificado. Tiene dos modos. El modo Governance permite a usuarios específicos con permisos especiales anular el bloqueo. El modo Compliance aplica un bloqueo estricto sin ninguna posibilidad de anulación: un objeto es inmutable hasta que haya transcurrido su fecha de retención, y el período de retención no puede acortarse por parte del propietario del bucket ni por IONOS CLOUD.
Cuatro restricciones determinan el diseño del bucket:
- Object Lock solo puede activarse al crear el bucket; no puede agregarse a un bucket existente. Al activarlo, también se activa la versionado, y ninguno de los dos puede desactivarse posteriormente.
- El DCD establece un período de retención de hasta 365 días. Para períodos más largos, use la API, que permite hasta 100 años.
- Un bucket con Object Lock activado no puede ser una fuente para la replicación ni el escalonamiento, aunque sí puede ser un destino.
- Las reglas de ciclo de vida gestionan la expiración después del período de retención; una configuración de ciclo de vida admite hasta 1000 reglas.
El costo de almacenamiento es moderado a este volumen: Object Storage tiene un precio de 0,007 € por GB por 30 días en la lista de precios en EUR, sin cargo por llamadas a la API.
2.3 Búsqueda y agregación
El archivo demuestra la integridad; no es el lugar donde los analistas realizan búsquedas. Para la búsqueda, reenvíe las entradas exportadas a una plataforma de registros. Un patrón documentado ejecuta un script que recupera eventos de registros de actividad para cada contrato y los reenvía a través de Fluent Bit al Logging Service de IONOS CLOUD, donde Grafana los consulta. Mantenga los roles separados: Grafana consulta una ventana de hasta 30 días, por lo que el Logging Service es el plano de búsqueda y el bucket bloqueado es el plano de evidencia. Las empresas con un sistema central de Gestión de Información y Eventos de Seguridad (SIEM) envían el mismo flujo allí en su lugar; la Unidad 7.2 diseña esa convergencia.
FinCorp combina estas partes. Su exportador se ejecuta cada seis horas bajo svc-fc-audit-export, recupera ambos contratos de la Unidad 2.1 y escribe archivos diarios en un bucket propiedad del contrato en Frankfurt (eu-central-4), creado con Object Lock en modo Compliance y un período de retención de varios años configurado a través de la API. La región propiedad del contrato en Berlín (eu-central-3) no se utiliza para este archivo porque su certificación BSI IT-Grundschutz está actualmente pendiente. Los mismos eventos alimentan el SIEM de FinCorp para la correlación. Dado que los registros de trazabilidad cubren solo productos IaaS, el mapeo de auditoría de FinCorp enumera la fuente de evidencia para cada servicio administrado por separado.
Resumen de decisiones
| Requisito | Propiedad de la plataforma | Decisión de diseño |
|---|---|---|
| Historial de auditoría superior a cinco semanas | Retención de 35 días y posterior purga | Exportación programada, ventanas superpuestas y alertas de huecos |
| Evidencia con detección de manipulación | El registro de actividad es de solo lectura, pero expira | Cubo de Object Storage con Object Lock en modo Compliance, creado con el bloqueo habilitado |
| Retención superior a 365 días | Límite de DCD de 365 días | Establecer el período de retención a través de la API |
| Una vista a través de los contratos | Agrupado y recuperado por contrato; sin empuje | El exportador enumera /contracts y agrega fuera de la plataforma |
| Acceso con privilegios mínimos a los datos de auditoría | Privilegio de acceso al registro de actividad; propietarios y administradores de forma predeterminada | Usuario de exportación dedicado con solo ese privilegio y un token Bearer |
| Evidencia para servicios administrados | Registros de trazabilidad limitados a productos de IaaS | Mapear cada servicio de PaaS a su propia fuente de evidencia |
Resumen
El registro de actividad es un registro de solo lectura, por contrato y exclusivo de la API, de la actividad de IaaS que conserva las entradas durante 35 días. Considere ese período como un plazo de exportación: extraiga cada contrato según un horario, solape los rangos y escriba los resultados en un bucket de Object Storage configurado en modo Compliance. La búsqueda y la correlación deben realizarse en una plataforma de registros o un SIEM, alimentada desde la misma exportación.
Puntos clave:
- El registro de actividad se agrupa por contrato, es de solo lectura (solo
GET) y está disponible únicamente a través de la API. - Las entradas se eliminan después de 35 días; IONOS CLOUD recomienda almacenarlas en otro lugar, como Object Storage.
- No se envía nada ni se agrega nada entre contratos; su exportador realiza ambas tareas.
- Object Lock debe habilitarse en la creación del bucket; el modo Compliance no puede acortarse por parte del propietario ni por IONOS CLOUD.
- Los registros de trazabilidad cubren únicamente los productos de IaaS; planifique evidencia separada para los servicios gestionados.