Confianza y seguridad
Por qué confiar.
Y hasta dónde.
Qué hace FirmaUY con tus documentos, cómo cuida el PIN, qué significa cada resultado y cómo reportar una vulnerabilidad. Con enlaces al código y a las pruebas.
Tus documentos no salen de tu computadora
Firmar y verificar pasa en tu máquina y funciona sin internet. Lo que usa la red es opcional y lo pedís vos:
- Un sello de tiempo. A la autoridad de sellado le llega un hash, nunca el documento.
- La consulta de revocación de un certificado. Viene apagada.
- La actualización de los certificados nacionales, desde sus fuentes oficiales.
Los dos primeros pedidos van a direcciones que vienen de afuera: de un certificado dentro de un archivo que te mandaron, o de la autoridad que elegiste. Por eso salen solo hacia direcciones públicas, con límites de tamaño, de tiempo y de redirecciones, y sin leer credenciales guardadas.
El único paso que envía un documento lo hacés vos, en tu navegador: subirlo a firma.gub.uy.
El PIN, al final
Un PIN equivocado gasta uno de los pocos intentos de la tarjeta. Por eso el orden en que se hacen las cosas es una regla de seguridad, no de estilo:
Primero se revisa lo que no necesita lector ni PIN: las opciones, los archivos y dónde se va a escribir.
Después, lo que se puede comprobar sin PIN: que hay lector y tarjeta, que el certificado está vigente y que el PIN no está bloqueado ni en su último intento.
Recién entonces se pide el PIN.
Antes de mandarlo a la tarjeta se rechaza el que no puede ser: vacío, con algo que no sea dígitos o fuera de 4 a 8 de largo.
- El PIN nunca queda en la línea de comandos, en un resultado, en un log ni en el texto de un error.
- Sobre el último intento: en modo directo, FirmaUY lee el contador de la tarjeta. Por un módulo PKCS#11 depende de que el módulo lo informe. OpenSC lo informa.
- Las pruebas automáticas nunca tocan una cédula real: usan certificados armados en memoria y tarjetas de software, donde un PIN equivocado no cuesta nada.
En quién confía
FirmaUY trae incluidos los dos certificados de la cadena de la cédula: la raíz nacional, de AGESIC, y la intermedia, del Ministerio del Interior. Antes de usarlos comprueba cada uno contra una huella SHA-256 fijada en el código, y que la intermedia esté firmada por la raíz. Por eso verificar funciona sin internet desde que lo instalás.
raíz (ACRN): 5533a0401f612c688ebce5bf53f2ec14a734eb178bfae00e50e85dae6723078a
intermedia (MICA): a29cad5c89aa49cff81f17f45c42fd44685510246d9ab5d031448e2fda2517be
Comparalas vos
# La raíz, desde su fuente oficial. openssl la muestra en mayúsculas y con dos puntos
curl -s https://www.uce.gub.uy/acrn/acrn.cer | openssl x509 -noout -fingerprint -sha256
- El almacén de certificados del sistema operativo no se consulta nunca.
- Con
--ca-filepodés verificar contra las anclas que elijas. Esas no se fijan: el punto es confiar en lo que elegiste vos. - Los dos certificados vencen en 2031, y el emisor puede cambiarlos antes. Un cambio necesita una versión nueva de FirmaUY, o
--ca-file:fetch-casrechaza todo lo que no coincida con la huella, también un certificado nuevo y legítimo. Es el costo de que nadie pueda colar otra raíz.
Qué dice un VÁLIDO, y qué no
VÁLIDO quiere decir dos cosas: la firma está íntegra y la cadena de certificados llega a la raíz nacional. INDETERMINADO, que está íntegra pero la confianza no se pudo establecer. INVÁLIDO, que la firma está rota o el documento cambió.
-
No dice si el certificado fue revocado
La consulta viene apagada para que verificar no use la red. Se activa con
--check-revocationo con la casilla de Desktop. Todavía no está confirmada de punta a punta contra una firma real de cédula. -
Juzga con la fecha de hoy
Una firma sin sello de tiempo no prueba cuándo se hizo, así que el certificado se evalúa al momento de verificar, no al de firmar. Con un sello de una autoridad en la que vos confiás, se evalúa en la fecha sellada.
-
Un sello de tiempo no es fecha cierta
Un sello de tiempo prueba que la firma ya existía en esa fecha. Para que además el documento haga fe de su fecha, la Ley 18.600 pide un prestador acreditado por la UCE.
-
Solo confía en la cadena uruguaya
Una firma de otra infraestructura da INDETERMINADO, salvo que le pases su raíz. Los niveles de archivo AdES -LT y -LTA no están implementados.
-
No es un dictamen legal
Es una evaluación técnica, hecha con estándares abiertos. Para una validación con peso oficial está firma.gub.uy.
Cómo se prueba la parte más delicada
El sello de tiempo viaja en una parte del archivo que la firma no cubre. Quien puede editar el archivo lo puede reescribir sin romper la firma. La pregunta es qué logra con eso, y la respuesta tiene que ser: nada.
Ocho invariantes lo dicen por escrito. Un sello dañado nunca deja el veredicto en VÁLIDO y nunca acusa a la firma del documento. Y solo un sello íntegro, válido y de una autoridad en la que confiás puede mover la fecha en que se juzga el certificado.
Cada invariante está vinculado a la cláusula del Marco de Ciberseguridad de AGESIC a la que le habla. El vínculo es una lectura del proyecto, no un dictamen de AGESIC.
| 8 | invariantes, cada uno con el riesgo que controla y las pruebas que lo sostienen |
| 7 | defectos reales encontrados en el camino, cada uno con su corrección y su prueba de regresión |
| 1096 | mutaciones de un bit sobre un sello, probadas una por una, sin una sola violación |
| 6000 | ejemplos al azar en la corrida profunda de pruebas de propiedades, sin contraejemplos |
Las dos búsquedas corren en cada pull request.
Los límites, dichos por el propio documento
- Cubre los sellos de tiempo, no todo el verificador. El resto, y el lado que firma, se prueban como el resto del código, sin una matriz como esta.
- Auditable no es auditado. Ninguna parte externa revisó, certificó ni evaluó este código.
- No es una declaración de cumplimiento ni una acreditación.
Lo que falta
El mismo documento lista lo que falta, en el orden en que debería cerrarse. Lo primero:
Conformidad con el validador oficial. Nada de lo anterior prueba que los veredictos coincidan con los de firma.gub.uy sobre firmas reales de cédula. Es lo primero que debería preguntar quien revise el proyecto para una institución.
Revocación de punta a punta. Falta confirmarla contra una firma real, y falta ver un certificado revocado siendo detectado.
Los niveles de archivo. Sin AdES -LT ni -LTA, un sello se juzga en la fecha que él mismo afirma.
Las dos primeras no se cierran con más código, ni con una sola persona. Se cierran con variedad: certificados de distintos años y tarjetas de las dos generaciones del chip. La lista completa.
Ayudá con una fila
No se puede juntar un corpus de documentos firmados reales: cada uno lleva el nombre y el número de documento de quien firmó. Lo que sí se puede juntar son veredictos.
Con un documento que hayas firmado con tu cédula, corré el script desde un clon del repositorio.
Subí el mismo archivo a firma.gub.uy y leé qué contesta.
Volvé a correr el script con esa respuesta y pegá la fila en un issue titulado «Conformance row».
Al 10 de noviembre de 2026 no había llegado ninguna.
git clone https://github.com/carlosplanchon/firmauy.git
cd firmauy
# Verifica en tu máquina e imprime una fila
uv run scripts/conformance_row.py firmado.pdf
# Después de subirlo a firma.gub.uy, con lo que contestó el portal
uv run scripts/conformance_row.py firmado.pdf --firma-gub-uy "correcta"
Una fila lleva la autoridad que emitió el certificado, a qué lista de revocación apunta, el algoritmo y los dos veredictos. No lleva tu nombre, tu número de documento, el número de serie del certificado ni el nombre del archivo: el script se niega a imprimir una fila que los tenga.
Censurada no es anónima. Una combinación rara de año, chip y autoridad acota a quién describe una fila: aportala sabiendo eso.
No es una herramienta oficial
FirmaUY es un proyecto independiente y comunitario. No está afiliado a AGESIC, no tiene certificación oficial y no garantiza la validez legal de lo que firmás.
Lo que eso descarta es el programa, no la firma. La firma la hace tu propia tarjeta, con el certificado que le puso el Ministerio del Interior, y vale lo que vale ese certificado, la haga el programa que la haga.
Tampoco puede acreditarse. Bajo la Ley 18.600, la acreditación es de los prestadores de servicios de certificación y la otorga la UCE. Una biblioteca no es un prestador.
Contrastá siempre en firma.gub.uy
Antes de mandar un documento firmado, o de confiar en uno, subilo al validador del Estado y guardá su respuesta. Es el árbitro que va a usar tu contraparte, y ninguna herramienta que revisa su propia firma lo reemplaza.
Subirlo envía el documento a un servicio del Estado: con lo confidencial, pensalo. El portal está hecho para PDF: un XML firmado o un .p7s aparte no tienen lugar ahí.
Reportar una vulnerabilidad
Los problemas de seguridad se reportan en privado, sin abrir un issue ni un pull request público. Para el motor FirmaUY, estos son los canales:
Reportar en GitHub
El canal principal es el reporte privado de vulnerabilidades del repositorio: Security → Report a vulnerability.
Abrir un reporte privadoSi no podés usar GitHub
Escribí a [email protected] con [SECURITY] en el asunto.
Los reportes pueden estar en español o inglés.
Qué incluir en el reporte
Compartí lo que tengas para entender y reproducir el problema:
- Una descripción de la falla y su impacto.
- Los pasos para reproducirla y, si la tenés, una prueba de concepto.
- La versión afectada.
- Tu evaluación de qué permite hacer la vulnerabilidad.
Alcance y proceso de los reportes de FirmaUY
Qué cubre esta política
Verificación
Un resultado VÁLIDO para una firma que no debería validar, incluidos fallos en la cadena de confianza.
Firma y PIN
Falsificación o uso indebido de la firma, exposición del PIN o consumo inesperado de intentos de la tarjeta.
Tarjeta y publicación
Secuencias del modo nativo que puedan bloquear o dañar la tarjeta, y problemas de integridad de las publicaciones de FirmaUY en PyPI.
Problemas de otros componentes
Las fallas de la cédula o su applet, los servicios de AGESIC, el validador oficial y el middleware propietario se reportan a sus responsables. Para el driver de la cédula dentro de OpenSC, usá el proceso de seguridad de OpenSC. Los problemas que requieren un equipo ya comprometido quedan fuera del alcance de esta política.
Qué pasa después
Es un proyecto comunitario con un único mantenedor. La política prevé confirmar la recepción en un plazo de siete días, evaluar el reporte y coordinar una corrección cuando se confirme.
Una vez disponible la corrección, la divulgación se hace mediante un aviso de seguridad en GitHub. Se da crédito a quien reportó, salvo que prefiera no figurar.
Solo la última versión publicada en PyPI recibe correcciones de seguridad.
El alcance y el proceso se rigen por la política de seguridad del repositorio. Consultar la guía completa en GitHub
Políticas de cada componente
Para problemas en Desktop, MCP Inspect o el driver de OpenSC, consultá el proceso del repositorio correspondiente.