1. Resumen Ejecutivo
Casa Hacker es una organización brasileña de la sociedad civil sin fines de lucro, dedicada a la educación STEAM y a la innovación social. Como parte de su programa de fortalecimiento institucional, Casa Hacker implementó una instancia autohospedada de Documenso Community Edition como plataforma de firma electrónica y digitalización de documentos.
Este estudio de caso se comparte con la comunidad de Documenso como referencia práctica para organizaciones que buscan construir una infraestructura de firma de documentos con validez jurídica utilizando tecnología de código abierto.
Conclusión principal: Cuando se configura con un certificado ICP-Brasil A1, sellos de tiempo RFC 3161 y el flujo de preprocesamiento adecuado, Documenso CE produce firmas electrónicas cualificadas —el nivel jurídico más elevado de la legislación brasileña— por una fracción del costo de las alternativas propietarias.2. Sobre Casa Hacker
Casa Hacker es una asociación sin fines de lucro con sede en São Paulo, Brasil. Su misión es hacer que la educación STEAM y la innovación social sean accesibles para todos. La organización opera diversos servicios digitales de interés público, incluyendo una plataforma de aprendizaje basada en Moodle (Mão na Massa), un canal de denuncias anónimas (Abre o Jogo, basado en GlobaLeaks) y una infraestructura de investigación utilizada por socios de la sociedad civil en todo Brasil.
La filosofía de infraestructura de Casa Hacker se fundamenta en la autosuficiencia: siempre que es viable, los servicios se autohospedan en suelo brasileño utilizando software de código abierto. Este enfoque reduce la dependencia de proveedores SaaS propietarios, disminuye los costos operativos y asegura el control total sobre los datos sensibles, un requisito crítico cuando se trata de documentos relacionados con actividades de interés público.
3. El Desafío
Las organizaciones de la sociedad civil en Brasil enfrentan una tensión específica. Por un lado, están legalmente obligadas a mantener documentación con un alto grado de autenticidad —contratos con financiadores, acuerdos laborales, declaraciones ante órganos públicos—. Por el otro, operan típicamente con presupuestos severamente limitados. Las plataformas comerciales de firma electrónica a menudo cobran por documento o por usuario, volviéndose prohibitivas a escala.
Además del costo, las organizaciones que actúan en el interés público necesitan poder demostrar, en cualquier momento futuro, que un documento fue firmado por partes específicas en un momento específico. Esta exigencia corresponde directamente al concepto jurídico de firma electrónica cualificada en la legislación brasileña.
Casa Hacker evaluó diversas plataformas antes de elegir Documenso CE. Los factores decisivos fueron la combinación de transparencia del código abierto, la capacidad de autohospedaje y —de forma determinante— el soporte nativo para certificados de firma externos, lo que permitió a la organización integrar directamente su propio certificado ICP-Brasil A1 en el flujo de firma.
4. Marco Jurídico Brasileño para Firmas Electrónicas y Digitalización de Documentos
4.1 Clasificación en Tres Niveles
La legislación brasileña reconoce tres niveles de firma electrónica, cada uno con un peso probatorio distinto. El marco está establecido principalmente por la Ley 14.063/2020.
4.2 Legislación Relevante
Medida Provisoria 2.200-2/2001
Este instrumento fundacional creó la ICP-Brasil (Infraestructura de Clave Pública Brasileña), la infraestructura nacional de clave pública. El artículo 10, §1 establece que los documentos firmados con certificados ICP-Brasil gozan de presunción legal de autenticidad equivalente a la atribuida a las firmas manuscritas por el artículo 219 del Código Civil. La MP permanece en vigor por disposición constitucional y jamás ha sido revocado.
Ley 12.682/2012 — Digitalización de Documentos
El artículo 1º reglamenta la digitalización, el almacenamiento electrónico y la reproducción de documentos públicos y privados. La ley define la digitalización como la conversión fiel de un documento físico a formato digital. Los documentos digitalizados bajo esta ley pueden sustituir al original en papel para todos los efectos legales, siempre que se cumplan los requisitos de autenticidad e integridad.
Ley 13.874/2019 — Ley de Libertad Económica
Esta ley actualizó la Ley 12.682/2012 para reforzar la validez jurídica de los documentos digitalizados y extendió dicha validez a los flujos de digitalización del sector privado, reduciendo las exigencias burocráticas para empresas y organizaciones.
Decreto 10.278/2020 — Normas Técnicas para Digitalización
Este decreto reglamenta la Ley 12.682/2012 al definir los estándares técnicos específicos que un proceso de digitalización debe cumplir para que el documento resultante posea el mismo valor probatorio que el original físico. Los requisitos principales incluyen: resolución mínima de 300 DPI, formato PDF/A-2B, campos de metadatos obligatorios y firma electrónica cualificada (ICP-Brasil) certificando al autor de la digitalización y la integridad del documento.
Para los documentos que involucran solo a partes privadas, el artículo 6º permite cualquier método de prueba acordado. En ausencia de acuerdo previo, se aplica el estándar ICP-Brasil por defecto.
STJ — REsp 2.159.442 (Diciembre de 2024)
El Superior Tribunal de Justicia (STJ), instancia máxima para materia infraconstitucional en Brasil, decidió por unanimidad que las firmas electrónicas avanzadas poseen fuerza jurídica válida incluso cuando la entidad certificadora no está acreditada por la ICP-Brasil. La ministra Nancy Andrighi consignó que la firma avanzada equivale a la firma notariada por semejanza, mientras que la firma cualificada equivale a la firma notariada por autenticidad. Ambas son jurídicamente válidas; la diferencia radica en la carga de la prueba exigida para impugnarlas.
Implicación práctica: Los documentos firmados por Documenso CE con un certificado ICP-Brasil A1 válido reciben la protección jurídica más alta disponible en la legislación brasileña. Los documentos firmados sin ICP-Brasil, pero con una verificación adecuada de identidad, siguen siendo jurídicamente válidos, aunque puedan requerir prueba adicional si son cuestionados.
5. Documenso Community Edition
Documenso es una plataforma de firma electrónica de documentos, de código abierto y autohospedable, posicionada como una alternativa impulsada por la transparencia frente a DocuSign y servicios propietarios similares. Community Edition es gratuita y está disponible en github.com/documenso/documenso bajo la licencia AGPL-3.0.
Capacidades principales relevantes para la conformidad jurídica brasileña:
- Certificados de firma externos: Soporte nativo para certificados PKCS#12 (.p12), permitiendo el uso directo de credenciales ICP-Brasil
- Sellos de tiempo RFC 3161: Integración con autoridades de sellado de tiempo para Validación a Largo Plazo (LTV), certificando el momento exacto de la firma de forma independiente
- Pista de auditoría inmutable: Cada acción en cada documento se registra y preserva
- Flujo basado en PDF: Los documentos son PDFs estándar verificables por cualquier lector de PDF o por el portal ITI/VALIDAR
- Arquitectura autohospedada: Los datos nunca salen de la infraestructura de la propia organización
- Firma con múltiples destinatarios: Orden de firma configurable con soporte para flujos secuenciales y paralelos
- Control de acceso: El registro público puede deshabilitarse para implementaciones restringidas a la organización
6. Configuración de la Implementación de Casa Hacker
6.1 Descripción General de la Infraestructura
Casa Hacker opera Documenso CE en un servidor Linux autohospedado ubicado en São Paulo, Brasil. Toda la pila tecnológica funciona en contenedores Docker con Traefik como proxy inverso con terminación TLS. Los certificados SSL se obtienen automáticamente a través de Let’s Encrypt.
La implementación utiliza una base de datos PostgreSQL dedicada y se conecta a un relé SMTP externo para correos electrónicos de notificación. El registro de usuarios está deshabilitado (NEXT_PUBLIC_DISABLE_SIGNUP=true), restringiendo el acceso a usuarios organizacionales autorizados.
6.2 Configuración del Certificado ICP-Brasil
El certificado de firma es un certificado organizacional ICP-Brasil A1 (tipo e-CNPJ) emitido por AC VALID BRASIL v5, una autoridad certificadora acreditada en la cadena de la ICP-Brasil. El titular del certificado es la propia organización, y no un individuo específico, lo que lo hace adecuado para la firma institucional de documentos.
El certificado se almacena como un archivo PKCS#12 (.p12) montado directamente en el contenedor de Documenso. La contraseña de la firma se proporciona a través de una variable de entorno y nunca se almacena en texto plano en ningún archivo de configuración versionado.
Parámetros de configuración relevantes:
NEXT_PRIVATE_SIGNING_LOCAL_FILE_PATH — ruta al archivo .p12 dentro del contenedorNEXT_PRIVATE_SIGNING_PASSPHRASE — contraseña del certificado (gestionada mediante secretos)NEXT_PRIVATE_SIGNING_TIMESTAMP_URLS — puntos finales duales de TSA (DigiCert y Sectigo)
Nota operacional: El período de validez del certificado se rastrea en el calendario operativo de la organización. La renovación debe iniciarse con al menos 30 días de anticipación al vencimiento para evitar la interrupción de la capacidad de firma.
6.3 Integración de Sellos de Tiempo RFC 3161
Se configuran dos puntos finales de Autoridad de Sellado de Tiempo RFC 3161: uno operado por DigiCert y otro por Sectigo. Esta configuración dual-TSA garantiza redundancia; en caso de que una autoridad esté temporalmente no disponible en el momento de la firma, la otra se utiliza automáticamente.
El sello de tiempo vincula criptográficamente el hash del documento a un momento exacto en el tiempo mediante un reloj de terceros confiable. Este es el mecanismo detrás de la Validación a Largo Plazo (LTV): incluso después de que expire el certificado de firma, el sello de tiempo prueba que la firma se realizó mientras el certificado era válido, preservando la validez jurídica del documento por tiempo indefinido.
Esta configuración resuelve el estado “Indeterminada” que se muestra en el portal ITI/VALIDAR para documentos sin sello de tiempo. Los documentos firmados por esta infraestructura muestran el estado “Válida” en ITI/VALIDAR, la herramienta oficial de validación del gobierno brasileño.
7. Casos de Uso Operacionales
7.1 Flujo de Firma de Documentos Nativo Digitales
Para los documentos creados directamente en formato digital —contratos, acuerdos, declaraciones— el flujo sigue los siguientes pasos:
El documento resultante es un PDF estándar que contiene una firma electrónica cualificada incrustada, verificable por Adobe Acrobat Reader, cualquier validador de PDF y el portal ITI/VALIDAR (iti.gov.br/validar).
7.2 Flujo de Digitalización de Documentos Físicos
Para los documentos físicos que deben conservarse en formato digital con plena equivalencia jurídica con el original —actas, acuerdos firmados, certificados— el flujo a continuación cumple con los requisitos del Decreto 10.278/2020:
Nota: Stirling PDF (versión Ultra-Lite, sin OCR) realiza la conversión a PDF/A-2B y la edición básica de metadatos sin necesidad de ningún servicio externo. Tanto Documenso como Stirling PDF funcionan como contenedores autohospedados en el mismo servidor, manteniendo todo el flujo dentro de la infraestructura controlada por la organización.
7.3 Alcance y Limitaciones
Esta configuración es adecuada para:
- Contratos y acuerdos con partes privadas y socios de la sociedad civil
- Documentación de recursos humanos (términos de empleo, acuerdos de voluntariado)
- Declaraciones y autorizaciones
- Documentos de gobernanza organizacional (actas de reuniones, decisiones de la junta directiva)
- Formularios de cumplimiento y debida diligencia (KYC/KYS, cumplimiento de proveedores)
- Documentos presentados a entidades públicas que acepten firmas avanzadas o cualificadas
Los siguientes casos de uso están fuera del alcance de esta configuración y requieren infraestructura adicional o certificados cualificados individuales:
- Transferencia y registro de bienes raíces — requiere certificados ICP-Brasil individuales e intervención notarial
- Facturas electrónicas (NF-e) — regidas por la infraestructura propia de la SEFAZ
- Procesos judiciales — sujetos a regulaciones específicas de cada tribunal
8. Resumen de Conformidad Jurídica
8.1 Conformidad de la Firma
8.2 Conformidad de la Digitalización
9. Análisis de Costos
9.1 Costo Total (Anual)
Todos los costos se basan en precios reales del primer trimestre de 2026. Los valores en USD utilizan un tipo de cambio indicativo de R$ 5,75/USD.
TC anual específico de Documenso (certificado ICP + fracción atribuible del alojamiento): aproximadamente R$ 600–R$ 1.000 por año (USD 104–174).
9.2 Comparación con Alternativas Comerciales
La siguiente comparación utiliza precios públicos del primer trimestre de 2025 para funcionalidad equivalente —firmas electrónicas cualificadas con conformidad ICP-Brasil en Brasil—.
Conclusión: Para una organización de la sociedad civil que firma entre 100 y 500 documentos al año, Documenso CE con un certificado ICP-Brasil A1 ofrece protección jurídica de nivel cualificado con un costo de 10 a 20 veces menor que las plataformas SaaS comerciales equivalentes, manteniendo todos los datos bajo el control directo de la organización.
10. Consideraciones de Seguridad y Operación
10.1 Seguridad de la Infraestructura
La instancia de Documenso está protegida por múltiples capas independientes de seguridad:
- Protección a nivel de red: CrowdSec IDS/IPS con inteligencia de amenazas comunitaria, operando tanto en la capa del proxy inverso Traefik (HTTP) como en la capa iptables del host (todos los protocolos, incluido SSH)
- Seguridad de transporte: TLS 1.2/1.3 aplicado en la capa Traefik; renovación automática de certificados a través de ACME/Let’s Encrypt
- Control de acceso: El registro de usuarios está deshabilitado; solo las cuentas previamente aprovisionadas pueden acceder a la interfaz de administración
- Aislamiento de red: Cada pila de servicios opera en su propia red Docker; Documenso expone únicamente su puerto designado a la red de Traefik
- Respaldo: Copias de seguridad nocturnas cifradas en Azure Blob Storage en tres regiones geográficas (Europa, Américas, África)
10.2 Gestión del Ciclo de Vida del Certificado
El certificado ICP-Brasil A1 es una credencial con fecha de caducidad que requiere una gestión activa de su ciclo de vida:
- Los certificados son válidos por un año a partir de su emisión; la renovación debe iniciarse con al menos 30 días de anticipación
- La renovación exige la presentación de documentos organizacionales actualizados ante la Autoridad de Registro y el pago de una tasa anual
- Tras la renovación, el nuevo archivo .p12 debe implementarse en el servidor y el contenedor de Documenso debe reiniciarse
- La fecha de vencimiento debe ser monitoreada en el calendario operativo de la organización con recordatorios automatizados
Nota sobre la hoja de ruta de los certificados ICP-Brasil: El órgano de gobernanza de ICP-Brasil anunció la transición de los certificados A1/A3 para personas jurídicas hacia un modelo de Sello Electrónico, con previsión de conclusión para 2029. Las organizaciones deben seguir las comunicaciones de ITI en iti.gov.br para obtener orientaciones sobre la migración. La arquitectura agnóstica de certificados de Documenso (estándar PKCS#12) garantiza la compatibilidad con el nuevo formato de Sello Electrónico cuando esté disponible.
11. Conclusión
Documenso Community Edition, cuando se configura adecuadamente con un certificado organizacional ICP-Brasil A1 y autoridades de sellado de tiempo RFC 3161, ofrece una infraestructura de firma y digitalización de documentos que cumple plenamente con el nivel más alto de la legislación brasileña sobre firmas electrónicas.
Para organizaciones como Casa Hacker, que manejan documentos con consecuencias jurídicas —contratos con socios públicos y privados, registros de cumplimiento, gobernanza organizacional—, esta configuración proporciona:
- Firmas electrónicas cualificadas con presunción legal de autenticidad
- Flujos de digitalización que producen registros con equivalencia jurídica a los originales físicos
- Validez de archivo a largo plazo mediante sellos de tiempo RFC 3161
- Soberanía completa de los datos: ningún documento sale de la infraestructura de la organización
- Eficiencia de costos: el principal costo recurrente es el certificado ICP-Brasil (~R$ 300–400/año)
Este caso de estudio demuestra que una infraestructura de firma de documentos basada en código abierto, cuando se implementa de manera rigurosa, puede igualar o superar los estándares jurídicos alcanzados por alternativas comerciales por una fracción del costo, convirtiéndose en una opción genuinamente viable para organizaciones de la sociedad civil, ONGs, instituciones académicas y pequeñas empresas que operan en Brasil.
12. Agradecimientos
Casa Hacker agradece al equipo de Documenso y a la comunidad de código abierto por construir una plataforma que prioriza la transparencia, la autosuficiencia y el rigor jurídico. La decisión de admitir certificados de firma externos —en lugar de vincular a las organizaciones a una infraestructura propietaria de certificados— fue la funcionalidad determinante que hizo posible esta implementación.
Este documento técnico se ofrece a la comunidad de Documenso como una contribución al acervo de conocimiento compartido sobre implementaciones con conformidad jurídica en Brasil y, potencialmente, en otras jurisdicciones con marcos maduros de infraestructura de clave pública.
Referencias
- Medida Provisoria nº 2.200-2/2001 — planalto.gov.br
- Lei nº 12.682/2012 — planalto.gov.br
- Lei nº 13.874/2019 (Lei da Liberdade Econômica) — planalto.gov.br
- Lei nº 14.063/2020 — planalto.gov.br
- Decreto nº 10.278/2020 — planalto.gov.br
- STJ — REsp 2.159.442 (Dezembro de 2024) — stj.jus.br
- ITI/VALIDAR — gov.br/iti
- Documenso CE — github.com/documenso/documenso
- ICP-Brasil — iti.gov.br