Adelys Docs

Biblioteca › Seguridad › Auditoría

Auditoría y cadena de integridad

Un registro de auditoría que se puede editar no es evidencia: es una opinión. El de Adelys está encadenado con hashes, de modo que alterar o borrar una línea rompe la verificación desde ese punto en adelante — y la verificación la puedes correr tú, desde el CRM, cuando quieras.

Alcance: bitácora de tu organización Ver la bitácora: rol administrador ⏱ 8 min

Cómo está encadenada

Cada evento sensible se guarda con estos datos: organización, usuario que lo hizo, acción, entidad y registro afectados, IP, agente del navegador, fecha exacta y unos metadatos según el caso.

Antes de guardarlo, el servidor toma todos esos campos más el hash del evento anterior de tu organización, los concatena en un orden fijo y calcula un SHA-256. Ese resultado se guarda con la fila y pasa a ser el eslabón del siguiente. El primero de la cadena parte de un valor conocido.

La consecuencia es la que se busca: cambiar un campo de una fila cambia su hash, y como el siguiente evento lo incluye en su propio cálculo, todo lo que viene después deja de cuadrar. No hay forma de editar «solo un renglón» sin que la comprobación lo delate.

Dos detalles de construcción que suelen faltar en implementaciones parecidas:

Verificarlo tú mismo

En el CRM, Seguridad → Bitácora del sistema muestra la bitácora real del servidor y trae el botón de verificación de la cadena. La verificación recalcula todos los eslabones y responde una de dos cosas: que la cadena está íntegra, o exactamente a partir de qué registro dejó de cuadrar.

Centro de Seguridad de Datos con la pestaña «Bitácora del sistema» seleccionada y el mensaje «Bitácora del servidor no disponible en modo demostración — esta bitácora es la cadena hash SHA-256 del backend real (append-only, verificable). Inicia sesión contra el servidor de Adelys para consultarla».
Dónde vive: Seguridad → Bitácora del sistema. La captura está tomada del CRM en modo demostración, que no habla con el servidor — de ahí el aviso. El propio mensaje nombra lo que hay detrás: la cadena SHA-256, solo-añadir, verificable.
No confundas las dos pestañas. «Bitácora del sistema» es la cadena real del servidor. «Auditoría» es un feed unificado y más legible que junta esa actividad con la de otros módulos para el trabajo del día a día. Cuando lo que necesitas es evidencia, la pestaña es Bitácora del sistema.

Qué queda registrado

La bitácora cubre acciones de seguridad y de ciclo de vida, no cada clic. Entre ellas:

Se conserva mientras exista la cuenta. Se borra en un solo caso: cuando se purga la organización, porque tu auditoría también es un dato tuyo.

El límite honesto

El registro de auditoría es «mejor esfuerzo»: si su escritura fallara, la operación principal no se cae, y el fallo queda en los registros del servidor. Es una decisión de diseño —que la bitácora tumbe una factura sería peor— pero significa que la cadena garantiza que lo que está escrito no se alteró, no que todo lo que ocurrió está escrito. Son dos promesas distintas y solo hacemos la primera.

La única excepción es el registro de consentimiento de marketing, que sí es estricto: si no se puede encadenar, la operación falla. Ahí la prueba es el producto, así que no se admite el hueco.

Hay dos cadenas, no una

La tuya, la de tu organización, es la que ves en el CRM. Existe además una cadena separada para el plano de operador de Adelys: todo lo que hace una persona de Adelys en el panel de plataforma —incluida cada consulta a la ficha de una organización— se encadena igual, con el antes y el después de cada cambio, y su tabla es solo-añadir incluso para la aplicación (se le revocan UPDATE y DELETE). Ni un token del CRM llega a esa cadena, ni un token del panel llega a la tuya: son secretos y audiencias distintos.

Está explicado en Quién de Adelys puede ver tus datos.

Casos prácticos

Ferretería El Tornillo — «alguien bajó la lista de clientes»

El dueño sospecha que un vendedor que renunció se llevó la cartera. Entra a Seguridad → Bitácora del sistema, filtra por acción de exportación y por rango de fechas, y ve quién generó qué y desde qué IP. Antes de usarlo en una conversación seria, corre la verificación de la cadena: si responde íntegra, ese renglón no se escribió después ni se retocó. Es la diferencia entre una sospecha y algo que se puede sostener.

Estudio Contable Vista Alegre — la revisión anual del cliente regulado

Un cliente del estudio pide evidencia de que solo dos personas acceden a su expediente. El estudio filtra la bitácora por la entidad del cliente y por rango de fechas, y adjunta el resultado de la verificación de la cadena tomado ese mismo día. El auditor no tiene que creer en la buena fe del estudio: tiene el mecanismo por el que un renglón alterado no habría pasado la comprobación.

Preguntas frecuentes

¿Quién puede ver la bitácora de mi empresa?

Solo usuarios con rol administrador de tu organización. La consulta va filtrada por tu organización en la aplicación y corre bajo el contexto de tenant en la base de datos, así que nadie de otra empresa la alcanza. Lo que se devuelve es un DTO: los eslabones hash internos no se exponen.

Si Adelys puede escribir en la base, ¿no puede reescribir mi bitácora?

La respuesta honesta tiene dos partes. Con la conexión que usa la aplicación, no: el privilegio de UPDATE está revocado. Con la conexión del dueño de la base —la que se usa para migraciones— alguien podría reescribir filas, pero tendría que recalcular toda la cadena a partir de ahí para que la verificación siguiera dando íntegra. Eso es exactamente lo que el diseño busca: no hacerlo imposible en abstracto, sino hacerlo imposible en silencio.

¿Y si la verificación me dice que la cadena está rota?

Escríbenos de inmediato a ventas@digitalek.net con la fecha y el identificador que te devuelve, y sigue los pasos de Si sospechas un acceso indebido. Una cadena rota no siempre significa manipulación —también la rompería una restauración parcial mal hecha— pero en los dos casos es un evento que hay que investigar, no anotar.

¿La bitácora guarda mi dirección IP?

Sí, la de cada evento, junto con el agente del navegador. Es lo que hace útil el registro para investigar. Distinto es el registro de dispositivos conocidos del motor de riesgo, donde la IP no se guarda en claro sino como hash con un pepper del servidor.

Sigue con