Seguridad | CILQUM

CILQUM está orientado a una arquitectura SaaS multi-tenant. Esto significa que los datos de negocio se organizan alrededor de workspaces, y las operaciones privadas deben ejecutarse dentro del contexto de un workspace autorizado.

La arquitectura técnica prevista utiliza API Go/Fiber, PostgreSQL, autenticación con tokens, rutas privadas por workspace y rutas públicas de firma con token seguro. Esta separación reduce el riesgo de confundir operaciones internas de administración con la experiencia pública del firmante.

La aplicación administrativa utiliza autenticación basada en token de acceso. El contrato técnico del frontend indica que el access token se envía como Authorization Bearer y que el refresh token se maneja mediante cookie HTTP-only bajo la ruta de autenticación.

Este enfoque busca reducir exposición del token de renovación en JavaScript y permite renovar sesión sin obligar al usuario a iniciar sesión constantemente. Ante una respuesta 401, el cliente debe intentar renovar sesión una sola vez y, si falla, pedir autenticación nuevamente.

Los firmantes no necesitan crear una cuenta para completar su parte. Acceden mediante un enlace con token público. El contrato técnico define que el token se envía en la URL y que el backend almacena el hash del token, no el token en claro.

La secuencia pública de firma se modela en pasos: resolver el token, validar identidad si corresponde, registrar la firma y permitir la descarga del PDF solo cuando el flujo haya sido completado según las reglas del proceso.

CILQUM trabaja con documentos PDF asociados a workspaces. La carga de documentos se realiza mediante multipart/form-data y debe restringirse a archivos PDF. El tamaño máximo del archivo depende del plan o configuración activa del workspace.

La arquitectura objetivo contempla almacenamiento local mediante un servicio de storage abstraído, con posibilidad de migrar a S3 compatible en una etapa posterior. Esta abstracción permite cambiar la infraestructura sin rediseñar el dominio documental.

El valor de seguridad no está solo en bloquear accesos. También está en registrar eventos relevantes del proceso. CILQUM contempla un módulo de auditoría para consultar eventos de workspace y reconstruir el avance de documentos.

Los eventos pueden incluir creación de flujo, invitaciones, apertura de enlaces, validaciones, firmas, cierres, fallas y acciones administrativas. Esta información ayuda a explicar qué ocurrió, cuándo y en qué contexto operativo.

Una página de seguridad debe explicar cómo se espera actuar ante incidentes: identificación, contención, análisis, corrección y comunicación. CILQUM debe mantener una práctica interna para revisar accesos, errores de procesamiento, fallas de disponibilidad y cualquier evento que pueda afectar documentos o datos personales.

A nivel comercial, es preferible declarar compromisos prudentes y verificables antes que prometer certificaciones no obtenidas. Si en el futuro CILQUM obtiene certificaciones, reportes de auditoría o controles formales, esta página debe actualizarse.