La aplicación

FirmaUY Desktop

Arrastrá un documento para firmarlo. Soltá uno firmado para comprobarlo. Una aplicación para usar tu cédula, sin abrir una terminal.

Descargar Desktop

Versión alfa (en pruebas) Windows y Linux de 64 bits. Todavía no hay versión para macOS.

Cómo instalarlo

Empezá con un PDF de ejemplo. Firmalo con tu cédula y verificá el resultado.
Límites de esta versión Qué necesitás para empezar

Pantalla Verificar: un archivo con veredicto VÁLIDO, el aviso de que la revocación no se consultó, los datos del firmante y cuatro chequeos técnicos aprobados.
Un archivo VÁLIDO, con los detalles técnicos abiertos. Todas las capturas usan datos inventados.

Qué necesitás

  • Para comprobar un documento

    Solo la aplicación. No hace falta cédula, lector, PIN ni internet.

  • Para firmar, un lector de tarjetas

    Un lector de tarjetas inteligentes, de los que se conectan por USB. La guía del Estado dice que se compra en cualquier comercio de tecnología.

  • La cédula, con el certificado vigente

    El certificado de firma viene en el chip y vence a los 5 años de emitido el documento, sin importar cuándo vence la cédula. Se renueva en persona en cualquier oficina de la DNIC, sin costo y sin agenda.

  • Tu PIN

    Es el que elegiste el día que tramitaste la cédula. Si no lo recordás o se bloqueó, se pide uno nuevo en ese mismo trámite de la DNIC.

  • El equipo

    Linux de 64 bits (x86_64) con glibc 2.35 o más nueva, como Ubuntu 22.04 o posterior, o Windows 10 u 11 de 64 bits.

    En Linux, pcscd corriendo; en Windows, nada más. No hace falta instalar middleware: Desktop habla directo con la tarjeta.

Lo del lector, el certificado y el PIN sale de la guía de gub.uy para usar el documento con lector y del trámite de desbloqueo de PIN y renovación del certificado. Si no sabés si tu equipo está listo, la pantalla Diagnóstico lo revisa por vos.

Comprobar un documento firmado

Soltá en la pantalla Verificar uno o varios archivos firmados: un PDF, un XML o una firma .p7s. No necesita la cédula ni internet.

La respuesta tiene tres partes: el veredicto, con una frase que dice qué significa; quién firmó; y, bajo «Detalles técnicos», cada chequeo que se hizo.

  • VÁLIDO

    El documento no se modificó desde que se firmó, y el firmante es quien dice ser.

  • INDETERMINADO

    No se puede afirmar que sea válida. Puede que el certificado no llegue hasta la raíz nacional, que el sello de tiempo no cierre, o que falte algo para comprobarlo.

  • INVÁLIDO

    No confíes en este archivo. La firma no cierra: el documento pudo cambiar después de firmarse.

Lo que un VÁLIDO no dice

Por defecto no consulta si el certificado fue revocado, y la pantalla lo dice debajo del veredicto: «Revocación: no consultada». La consulta se activa en «Qué comprobar», y es la única parte de la verificación que usa internet.

Varios a la vez

Un lote recibe una fila por archivo, con su veredicto, y una cuenta sobre el conjunto. Al elegir una fila se ve la respuesta completa de ese archivo. Si llega una firma .p7s sin el archivo que firma, te pregunta cuál es, sin frenar el resto.

Después, firma.gub.uy

La respuesta trae un enlace a firma.gub.uy, el validador del Estado: es el árbitro que va a usar tu contraparte. Se abre en tu navegador, y la app no sube nada por sí sola. Subirlo envía el documento a ese sitio, y el portal está hecho para PDF.

Pantalla Verificar con un lote de cinco archivos: uno válido, uno indeterminado, uno inválido, una firma a la que le falta su original y un archivo que no está firmado.
Un lote mezclado: cada archivo con su veredicto, y arriba la cuenta del conjunto.

Firmar

  1. Conectá el lector y poné la cédula.

  2. Arrastrá uno o varios archivos a la pantalla Firmar y apretá «Firmar».

  3. La app comprueba el lector, la tarjeta y el certificado. Recién entonces pide el PIN, y solo acepta lo que una cédula puede tener: de 4 a 8 dígitos.

  4. Te muestra dónde quedó el archivo firmado y te deja verificarlo ahí mismo.

Qué vuelve, según lo que firmes
Si firmásRecibís
un PDFel PDF firmado, con firma visible (PAdES)
un XMLel XML firmado (XAdES)
cualquier otro archivola firma en un .p7s aparte (CAdES)
Pantalla Firmar después de firmar un PDF: la ruta del archivo firmado, el tipo de firma, el firmante y los botones para verificarlo, abrir la carpeta o firmar otro.
Después de firmar: dónde quedó el archivo y el botón para verificarlo.
  • Un PIN para todo el lote

    Varios archivos se firman en una sola sesión de la tarjeta, así que el PIN se pide una vez. Un lote largo se puede cancelar: se detiene después del archivo que está firmando.

  • Si el PIN está mal

    Te dice cuántos intentos quedan. Y si a la cédula le queda uno solo, la app no lo usa: te avisa que hay que desbloquear el PIN, y eso se hace en la DNIC.

  • Sello de tiempo, si lo querés

    Es opcional. Con una autoridad de sellado configurada en Ajustes, o para un documento en «Opciones avanzadas», la firma lleva la fecha. A esa autoridad le llega un hash, nunca el documento.

  • Después de firmar, contrastá

    Antes de mandar un documento firmado, subilo a firma.gub.uy y guardá su respuesta. Por qué.

Mi cédula y Diagnóstico

Pantalla Mi cédula: foto, nombre, número de cédula y fechas de nacimiento, expedición y vencimiento, con datos de ejemplo.
Mi cédula. Lee lo que la tarjeta dice de vos, sin PIN: foto, nombre, número con su dígito verificador, nacimiento y vencimiento. La foto se puede guardar, y nada se escribe en disco hasta que apretás ese botón. También comprueba el dígito verificador de cualquier número, sin tarjeta.
Pantalla Diagnóstico: la revisión del sistema, con avisos sobre pcscd, el lector y los certificados, y qué hacer con cada uno.
Diagnóstico. Revisa el lector, la tarjeta y los certificados de las CA nacionales, y te dice qué hacer cuando algo falla. «Copiar diagnóstico» deja afuera todo lo que te pueda identificar.

Hay una pantalla más, Avanzado, apagada por defecto: muestra lo que un módulo PKCS#11 ve en la tarjeta y exporta tu certificado público. Se activa en Ajustes y necesita un módulo instalado, que el modo directo no usa.

Descargar, comprobar e instalar

Las versiones están en la página de Releases del repositorio, cada archivo con su .sha256 al lado. La suma SHA-256 confirma que el archivo llegó entero. La atestación de GitHub confirma que salió del flujo de publicación del repositorio, a partir de un commit concreto.

En Linux

# ¿Llegó entero?
sha256sum -c firmauy-desktop-*-linux-x86_64.tar.gz.sha256
# ¿Salió del repositorio?
gh attestation verify firmauy-desktop-*-linux-x86_64.tar.gz \
    -R carlosplanchon/firmauy-desktop
# Instalar para tu usuario, sin root: crea el ícono y la entrada del menú
tar -xzf firmauy-desktop-*-linux-x86_64.tar.gz
cd firmauy-desktop-*-linux-x86_64
./install.sh firmauy-desktop

El archivo es un .tar.gz y trae su propio instalador. Para sacarlo está ./uninstall.sh, que deja tus ajustes y te dice dónde están.

En Windows

# En PowerShell. Cambiá 0.1.0 por la versión que bajaste.
# ¿Llegó entero? El hash tiene que coincidir con la primera palabra del .sha256
(Get-FileHash firmauy-desktop-0.1.0-windows-x86_64-setup.exe).Hash
Get-Content firmauy-desktop-0.1.0-windows-x86_64-setup.exe.sha256
# ¿Salió del repositorio?
gh attestation verify firmauy-desktop-0.1.0-windows-x86_64-setup.exe -R carlosplanchon/firmauy-desktop
# Instalar para tu usuario, sin permisos de administrador
.\firmauy-desktop-0.1.0-windows-x86_64-setup.exe

El instalador instala para tu usuario, sin permisos de administrador, y deja la entrada en el menú Inicio; el .zip sirve para correrlo sin instalar. Como todavía no está firmado con un certificado de código, Windows puede avisar que protegió tu equipo. Solo después de comprobar la atestación: «Más información» y después «Ejecutar de todas formas».

Qué sale a internet, y qué guarda

La app no hace ninguna conexión que no hayas pedido. Firmar y verificar funcionan con la máquina desconectada. Cuatro cosas sí usan la red, cada una porque la pediste, y solo una envía el documento.

  • Subir a firma.gub.uy

    Lo hacés en tu navegador, no desde la app. Es el único paso que envía el documento, y va a un servicio del Estado.

  • El sello de tiempo

    Solo si configuraste una autoridad de sellado. Se envía un hash, nunca el documento.

  • La consulta de revocación

    Solo si la activás en Verificar. Viene apagada.

  • «Actualizar certificados»

    Es un botón de Diagnóstico que vuelve a bajar los certificados de las CA nacionales de sus fuentes oficiales. No envía nada tuyo, y no hace falta para verificar: la app ya trae esos certificados.

Lo que guarda, y lo que no

  • El PIN vive en memoria para la firma que lo pidió. Nunca llega a un disco, a un log ni a la línea de comandos.
  • Los ajustes guardan cosas de la máquina: el lector, el modo de acceso a la tarjeta, la apariencia. Ningún nombre, ningún número de documento y ninguna lista de archivos recientes, a propósito.
  • El registro de actividad viene apagado. Si lo activás, anota qué tipo de operación hubo y qué clase de error, nunca qué documento, quién firmó ni el PIN. Ajustes tiene un botón para borrarlo.

Límites de esta versión

  • Es una versión alfa.
  • No hay versión para macOS.
  • En Windows, los instaladores todavía no están firmados con un certificado de código. Por eso la atestación importa.
  • En Linux necesita glibc 2.35 o más nueva.
  • No es una aplicación del Estado uruguayo ni está afiliada a AGESIC. Lo no oficial es el programa, no la firma: la hace tu 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. Qué significa no ser oficial.