Saltar a contenido

✍️ SSigner Cliente

Java JavaFX Motor Logging

SSigner Cliente es una aplicación de escritorio JavaFX para Windows que conecta una plataforma web con el motor de firma digital SSigner. La aplicación recibe una operación mediante el protocolo ssigner://, obtiene los hashes y la configuración desde el servidor, permite seleccionar un certificado y devuelve las firmas generadas.

Funcionalidades principales

  • Integración con sitios web mediante el protocolo personalizado ssigner://.
  • Lectura de certificados desde Windows Certificate Store (Windows-MY).
  • Firma mediante tokens USB o HSM compatibles con PKCS#11.
  • Filtrado opcional de certificados por DNI o RUC.
  • Configuración de motivo y ubicación de la firma.
  • Ejecución del motor ssigner-2.5.2.jar con Java 17.
  • Registro unificado DEBUG, INFO, WARN y ERROR con Log4j 2.
  • Envío automático de los hashes firmados al servidor.

Tipo de aplicación

SSigner Cliente es una aplicación de escritorio. No es un servidor web ni expone un puerto HTTP local. La plataforma web la inicia mediante una URL ssigner://.

Flujo general

Plataforma web
    │
    ├── ssigner://dni=...&cod-operation=...&token=...
    ▼
SSigner Cliente
    ├── consulta configuración
    ├── carga certificados
    ├── solicita hashes
    ├── ejecuta ssigner-2.5.2.jar
    └── envía firmas
    ▼
API SSigner

Contenido rápido

Documento Contenido
Guía de inicio Primera firma y prueba del protocolo
Instalación Requisitos, instalación y compilación
Manual de uso Firma con Windows-MY y PKCS#11
Referencia de API Protocolo y endpoints consumidos
Configuración Parámetros, propiedades, carpetas y logs
Problemas comunes Diagnóstico y códigos de error

Compatibilidad

Componente Compatibilidad
Sistema operativo principal Windows 10/11
Java 17
Certificados locales Windows-MY
Token criptográfico PKCS#11
Motor de firma SSigner 2.5.2
Protocolo ssigner://

Compilacion

ssigner-cliente no esta declarado como modulo del POM raiz. Para compilarlo:

cd ssigner-cliente
mvn -DskipTests package

PKCS12 y JKS

El cliente reconoce valores PKCS12 y JKS, pero actualmente carga ambos con la pantalla general. El flujo especializado y completamente implementado es PKCS#11; Windows-MY es el flujo predeterminado.