Desarrollo e integraciones
El motor, en tu sistema.
Usá FirmaUY desde la terminal o Python, revisá documentos con tu asistente de IA o accedé a la tarjeta. Elegí la herramienta y seguí su guía.
Terminal y Python
FirmaUY es el motor que también usan Desktop y MCP Inspect. Desde la terminal o la API de Python podés firmar por lotes, verificar documentos y diagnosticar la instalación.
- Para scripts: códigos de salida y resultados en JSON.
- Para Python: resultados y errores tipados para integrar la firma en tu sistema.
- Para verificar: sin lector, tarjeta ni PIN.
La guía de uso reúne la instalación, los comandos y sus opciones; la referencia de la API explica cómo usar el motor desde Python.
MCP Inspect
Un servidor MCP de solo lectura para que tu asistente revise documentos firmados y resuma cuáles son válidos y cuáles hay que mirar.
No puede firmar ni acceder al PIN. Por defecto, tampoco le muestra al modelo la identidad del firmante. Quien lo instala decide qué carpetas puede revisar.
La configuración, las herramientas disponibles y las opciones de privacidad están en el repositorio de MCP Inspect.
OpenSC y NFC
OpenSC permite usar la cédula desde programas que hablan PKCS#11: certificado, PIN, firma y datos públicos de identidad.
El acceso es por contacto y, en las cédulas compatibles emitidas desde fines de 2022, también por NFC. Para NFC hace falta la MRZ del dorso, que abre el canal de acceso a la tarjeta.
Consultá la documentación para elegir la versión y preparar el soporte que necesita tu equipo.
Leer la MRZ
cedulauy-mrz-scan, de Nicolás Gutiérrez, lee las tres líneas del dorso de la cédula desde una cámara o una imagen guardada y las comprueba con sus dígitos de control.
El procesamiento ocurre en tu computadora. El resultado sirve como entrada para OpenSC por NFC o para tu propio programa.
La herramienta está en versión alfa, bajo licencia GPL-3. Su repositorio detalla los requisitos, la captura guiada y la API.
Cómo contribuir
Podés aportar con un reporte de error, una pregunta, una receta de uso, documentación o un cambio de código.
Contá un problema
Indicá la versión, el sistema, qué intentaste y cómo reproducirlo. Compartí salidas redactadas y datos inventados.
Compartí una receta
Un caso de uso con los comandos mínimos, el resultado esperado, las notas de privacidad y el entorno donde lo probaste.
Proponé un cambio
Leé las pautas de contribución y la arquitectura. La guía explica las pruebas con tarjetas de software y el sign-off DCO requerido en cada commit.