1. Resumen Ejecutivo
La 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, la Casa Hacker implantó una instancia autoalojada 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 alto de la legislación brasileña— por una fracción del costo de las alternativas propietarias.2. Sobre la Casa Hacker
La 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 todas las personas. La organización opera diversos servicios digitales de interés público, entre ellos 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 encuestas utilizada por socios de la sociedad civil en todo Brasil.
La filosofía de infraestructura de la Casa Hacker se basa en la autosuficiencia: siempre que es viable, los servicios se autoalojan 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 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 alto grado de autenticidad: contratos con financiadores, acuerdos laborales, declaraciones ante organismos públicos. Por otro, operan por lo general con presupuestos severamente limitados. Las plataformas comerciales de firma electrónica suelen cobrar por documento o por usuario, lo que las vuelve prohibitivas a escala.
Más allá 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. Esa exigencia corresponde directamente al concepto jurídico de firma electrónica cualificada en la legislación brasileña.
La 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 autoalojamiento y —de forma determinante— el soporte nativo para certificados de firma externos, 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 Lei 14.063/2020.
4.2 Legislación Relevante
Medida Provisória 2.200-2/2001
Este instrumento fundacional creó la ICP-Brasil (Infraestrutura de Chaves Públicas Brasileira), la infraestructura nacional de claves públicas. 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 nunca fue derogada.
Lei 12.682/2012 — Digitalización de Documentos
El artículo 1º regula 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.
Lei 13.874/2019 — Lei da Liberdade Econômica
Esta ley actualizó la Lei 12.682/2012 para reforzar la validez jurídica de los documentos digitalizados y extendió esa validez a los flujos de digitalización del sector privado, reduciendo exigencias burocráticas para empresas y organizaciones.
Decreto 10.278/2020 — Normas Técnicas para la Digitalización
Este decreto reglamenta la Lei 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 tenga 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) que certifique al autor de la digitalización y la integridad del documento.
Para 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 Justiça (STJ), instancia máxima en materia infraconstitucional en Brasil, decidió por unanimidad que las firmas electrónicas avanzadas tienen 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 reconocida por semejanza, mientras que la firma cualificada equivale a la firma reconocida por autenticidad. Ambas son jurídicamente válidas; la diferencia reside 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 más alta protección jurídica disponible en la legislación brasileña. Los documentos firmados sin ICP-Brasil, pero con verificación adecuada de identidad, siguen siendo jurídicamente válidos, aunque puedan exigir prueba adicional si son impugnados.
5. Documenso Community Edition
Documenso es una plataforma de firma electrónica de documentos, de código abierto y autoalojable, posicionada como alternativa orientada por la transparencia a DocuSign y servicios propietarios similares. La Community Edition es gratuita y está disponible en github.com/documenso/documenso bajo la licencia AGPL-3.0.
Capacidades principales relevantes para el cumplimiento jurídico brasileño:
- Certificados de firma externos: soporte nativo para certificados PKCS#12 (.p12), que permite el uso directo de credenciales ICP-Brasil
- Sellos de tiempo RFC 3161: integración con autoridades de sellado de tiempo para la Validación a Largo Plazo (LTV), que certifica el momento exacto de la firma de forma independiente
- Rastro de auditoría inmutable: cada acción sobre cada documento queda registrada y preservada
- Flujo basado en PDF: los documentos son PDF estándar verificables por cualquier lector de PDF o por el portal ITI/VALIDAR
- Arquitectura autoalojada: 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 una implantación restringida a la organización
6. Configuración de la Implantación de la Casa Hacker
6.1 Visión General de la Infraestructura
La Casa Hacker opera Documenso CE en un servidor Linux autoalojado 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 vía Let’s Encrypt.
La implantación utiliza una base de datos PostgreSQL dedicada y se conecta a un relay SMTP externo para los correos de notificación. El registro de usuarios está deshabilitado (NEXT_PUBLIC_DISABLE_SIGNUP=true), lo que restringe 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, autoridad certificadora acreditada en la cadena de la ICP-Brasil. El titular del certificado es la propia organización, y no una persona específica, lo que lo hace adecuado para la firma institucional de documentos.
El certificado se almacena como archivo PKCS#12 (.p12) montado directamente en el contenedor de Documenso. La contraseña de firma se proporciona mediante 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 vía secrets)NEXT_PRIVATE_SIGNING_TIMESTAMP_URLS — endpoints duales de TSA (DigiCert y Sectigo)
Nota operativa: el período de validez del certificado se controla en el calendario operativo de la organización. La renovación debe iniciarse con al menos 30 días de antelación respecto al vencimiento para evitar la interrupción de la capacidad de firma.
6.3 Integración de Sellos de Tiempo RFC 3161
Hay dos endpoints de Autoridad de Sellado de Tiempo RFC 3161 configurados: uno operado por DigiCert y otro por Sectigo. Esta configuración dual-TSA garantiza redundancia: si una autoridad está temporalmente indisponible 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 tercero confiable. Este es el mecanismo detrás de la Validación a Largo Plazo (LTV): incluso después del vencimiento del certificado de firma, el sello de tiempo demuestra que la firma se realizó mientras el certificado era válido, lo que preserva la validez jurídica del documento por tiempo indeterminado.
Esta configuración resuelve el estado “Indeterminada” que muestra 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 Operativos
7.1 Flujo de Firma de Documentos Nativos Digitales
Para documentos creados directamente en formato digital —contratos, acuerdos, declaraciones— el flujo sigue las siguientes etapas:
El documento resultante es un PDF estándar que contiene una firma electrónica cualificada incorporada, 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 documentos físicos que deben preservarse en formato digital con plena equivalencia jurídica al original —actas, acuerdos firmados, certificados— el siguiente flujo cumple 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 autoalojados en el mismo servidor, lo que mantiene 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 RR. HH. (contratos de trabajo, 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 ante entidades públicas que acepten firmas avanzadas o cualificadas
Los siguientes casos de uso quedan fuera del alcance de esta configuración y exigen infraestructura adicional o certificados cualificados individuales:
- Transferencia y registro de inmuebles: 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 reglamentaciones específicas de cada tribunal
8. Resumen de Cumplimiento Jurídico
8.1 Cumplimiento de la Firma
8.2 Cumplimiento 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.
CT anual específico de Documenso (certificado ICP + fracción atribuible del alojamiento): aproximadamente R$ 600–R$ 1.000 al 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 cumplimiento 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 certificado ICP-Brasil A1 entrega protección jurídica de nivel cualificado con un costo de 10 a 20 veces menor que el de plataformas SaaS comerciales equivalentes, manteniendo todos los datos bajo 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 vía 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 servicio opera en su propia red Docker; Documenso expone únicamente su puerto designado a la red de Traefik
- Copias de seguridad: copias nocturnas cifradas hacia Azure Blob Storage en tres regiones geográficas (Europa, América, África)
10.2 Gestión del Ciclo de Vida del Certificado
El certificado ICP-Brasil A1 es una credencial con plazo de validez que exige una gestión activa del ciclo de vida:
- Los certificados son válidos por un año desde su emisión; la renovación debe iniciarse con al menos 30 días de antelació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 implantarse en el servidor y reiniciarse el contenedor de Documenso
- La fecha de vencimiento debe controlarse 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 la 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 hasta 2029. Las organizaciones deben seguir las comunicaciones del ITI en iti.gov.br para orientaciones sobre la migración. La arquitectura agnóstica a certificados de Documenso (estándar PKCS#12) garantiza compatibilidad con el nuevo formato de Sello Electrónico cuando esté disponible.
11. Conclusión
Documenso Community Edition, cuando se configura debidamente con un certificado organizacional ICP-Brasil A1 y autoridades de sellado de tiempo RFC 3161, entrega una infraestructura de firma y digitalización de documentos que cumple plenamente con el nivel más alto de la legislación brasileña de firmas electrónicas.
Para organizaciones como la Casa Hacker, que manejan documentos de consecuencia jurídica —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 archivística 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 estudio de caso demuestra que una infraestructura de firma de documentos basada en código abierto, cuando se implanta de forma rigurosa, puede alcanzar o superar los estándares jurídicos logrados por alternativas comerciales por una fracción del costo, y se convierte así en una opción genuinamente viable para organizaciones de la sociedad civil, ONG, instituciones académicas y pequeñas empresas que operan en Brasil.
12. Agradecimientos
La 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 atar a las organizaciones a una infraestructura propietaria de certificados— fue la funcionalidad determinante que hizo viable esta implantación.
Este whitepaper se ofrece a la comunidad de Documenso como contribución al acervo de conocimiento compartido sobre implantaciones con cumplimiento jurídico en Brasil y, potencialmente, en otras jurisdicciones con marcos maduros de infraestructura de claves públicas.
Referencias
- Medida Provisória 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 (diciembre de 2024) — stj.jus.br
- ITI/VALIDAR — gov.br/iti
- Documenso CE — github.com/documenso/documenso
- ICP-Brasil — iti.gov.br