Instalar Trustux

Trustux se ejecuta enteramente en tu máquina. Hay una interfaz web para subir un documento firmado y leer el veredicto, y un verificador de línea de comandos para scripts y pipelines. En cualquier caso, el documento nunca sale de tu computadora.

Requisitos

Node.js 20+

Trustux es una aplicación Node sin paso de compilación nativa. La cripto de firmas es JS puro (asn1js / pkijs).

Un almacén de confianza

La raíz AC Raíz República Argentina viene precargada. Puedes agregar o reemplazar raíces por jurisdicción.

Un documento firmado

Un PDF firmado (PAdES), una factura XML (XAdES) o un CMS .p7m / .p7s (CAdES).

Ejecutarlo

Interfaz web

git clone https://github.com/diegoparras/trustux.git && cd trustux
npm install
npm start          # → http://localhost:8095

Abre la página, arrastra un documento firmado, y lee el veredicto tipo semáforo con su reporte exportable.

Línea de comandos

npm install
node firma-core/cli.js path/to/signed.pdf

La CLI imprime el veredicto de integridad, identidad, validez y el estándar detectado — práctico para scripts y CI.

Primera ejecución

1. Abre la UI en http://localhost:8095, o llama a la CLI sobre un archivo.
2. Arrastra un documento firmado. Trustux detecta el estándar (PAdES / XAdES / CAdES) automáticamente.
3. Lee el veredicto: una luz verde / ámbar / roja para integridad, identidad (con el CUIT/CUIL del firmante y la CA emisora) y validez al momento de la firma.
4. Exporta el reporte para adjuntarlo a tu archivo.

Inicio de sesión único

Trustux admite SSO opcional con Lockatus, el hub de identidad de la suite. Activa la federación para que un equipo inicie sesión una vez con dos factores y roles por app, en lugar de un login local de la app.

Almacén de confianza

La cadena de certificados se valida hasta una raíz de confianza. Trustux viene con la AC Raíz República Argentina precargada, y el almacén de confianza es editable por jurisdicción — agrega las raíces que necesites o fija las tuyas.

Fixtures de prueba

El repositorio incluye fixtures de ejemplo con una tabla de verdad: PDFs (PAdES) intactos, alterados, con doble firma, con sello de tiempo, SHA-1 y revocados, además de facturas XML (XAdES) firmadas y alteradas. Te permiten confirmar que Trustux marca cada caso correctamente antes de confiarle documentos reales.