Guía de instalación¶

Instalación para usuarios¶

Requisitos¶

• Windows 10 u 11.
• Permiso para registrar el protocolo ssigner://.
• Acceso HTTPS a s-055-2025.plussigner.com.
• Certificado instalado o controlador del token PKCS#11.

La distribución debe incluir, como mínimo:

SSignerUcsp.exe
lib/
└── ssigner-2.5.2.jar
jre/
└── bin/
    └── java.exe

Instalar¶

1. Ejecute el instalador como usuario con permisos suficientes.
2. Mantenga la carpeta de instalación propuesta.
3. Autorice el registro del protocolo ssigner.
4. Finalice la instalación.
5. Pruebe una URL ssigner:// desde PowerShell.

Start-Process "ssigner://dni=12345678&cod-operation=1001&token=TOKEN_TEMPORAL"

Registro manual del protocolo¶

Si el instalador no registra el protocolo, un administrador puede crear las claves correspondientes en el Registro de Windows:

Windows Registry Editor Version 5.00

[HKEY_CLASSES_ROOT\ssigner]
@="URL:SSigner Protocol"
"URL Protocol"=""

[HKEY_CLASSES_ROOT\ssigner\shell\open\command]
@="\"C:\\Program Files (x86)\\SSignerUcsp\\SSignerUcsp.exe\" \"%1\""

Controladores PKCS#11¶

Para tokens USB:

1. instale el middleware del fabricante;
2. conecte el token;
3. identifique la DLL PKCS#11;
4. compruebe que la arquitectura de la DLL coincide con la aplicación.

Rutas detectadas habitualmente:

C:\Windows\System32\eToken.dll
C:\Windows\System32\eTPKCS11.dll
C:\Windows\System32\bit4ipki.dll
C:\Program Files\OpenSC Project\OpenSC\pkcs11\opensc-pkcs11.dll

Ejecución del JAR en desarrollo¶

Puede ejecutar el artefacto directamente:

.\jre\bin\java.exe -jar .\out\artifacts\prevecon_jar\prevecon.jar `
  "ssigner://dni=12345678&cod-operation=1001&token=TOKEN_TEMPORAL&debug=true"

Compilación para desarrolladores¶

Herramientas¶

• JDK 17.
• Maven Wrapper incluido en el proyecto.
• Dependencias JavaFX 17.0.6.

Compilar¶

En Windows, confirme primero la ruta de javac definida en pom.xml:

<executable>C:\Users\Personal\.jdks\temurin-17.0.18\bin\javac.exe</executable>

Después ejecute:

.\mvnw.cmd clean test
.\mvnw.cmd package

Artefacto de IntelliJ¶

El proyecto contiene el artefacto prevecon:jar:

Build > Build Artifacts > prevecon:jar > Build

Resultado esperado:

out\artifacts\prevecon_jar\prevecon.jar

El artefacto incluye JavaFX, Gson y Log4j. El motor ssigner-2.5.2.jar se distribuye separadamente en lib.