Configuración¶

Fuentes de configuración¶

La aplicación combina configuración de tres orígenes, en este orden funcional:

1. parámetros del protocolo ssigner://;
2. propiedades obtenidas desde /obtener-configuracion;
3. propiedades devueltas por /generar-hash.

Los valores introducidos por el usuario para motivo y ubicación tienen prioridad durante la operación.

Parámetros del protocolo¶

ssigner://dni=12345678&cod-operation=1001&token=TOKEN&tipo-repo=Windows-MY

Parámetro base-url¶

El parámetro base-url permite configurar dinámicamente la URL del API REST sin recompilar.

ssigner://dni=12345678&cod-operation=1001&token=TOKEN&base-url=s-055-2025.plussigner.com/api/v2/ssigner

El valor proporcionado se prefija automáticamente con https://. Si el valor termina en /, se elimina el trailing slash antes de concatenar los endpoints.

Valor por defecto (hardcoded):

https://s-055-2025.plussigner.com/api/v2/ssigner

Propiedades de firma¶

Ejemplo de propiedades generadas para el motor:

firma.alias=ALIAS_DEL_CERTIFICADO
firma.repositorio=Windows-My
firma.motivo=Aprobación
firma.locacion=Lima
firma.campo=__signature__
firma.carpeta.entrada=C:\\Users\\usuario\\.ssigner\\entrada
firma.carpeta.salida=C:\\Users\\usuario\\.ssigner\\salida
firma.carpeta.config=C:\\Users\\usuario\\.ssigner\\config
firma.carpeta.cache=C:\\Users\\usuario\\.ssigner\\cache
firma.carpeta.imagen=C:\\Users\\usuario\\.ssigner\\imagen
documento=documentos.txt
certificado.validar.limite=1

Propiedades PKCS#11¶

firma.repositorio=PKCS11
firma.repositorio.pkcs11.libreria=C:\\Windows\\System32\\eTPKCS11.dll
firma.repositorio.pkcs11.clave=PIN_DEL_TOKEN
firma.alias=ALIAS_DEL_CERTIFICADO

Configuraciones individuales¶

El servidor puede devolver configuracionesIndividuales, un mapa de nombre de archivo a propiedades. El cliente crea cada archivo dentro de la carpeta config.

{
  "contrato.properties": {
    "firma.motivo": "Aprobación",
    "firma.locacion": "Lima",
    "firma.texto": "Firmado por [NOMBRE]"
  }
}

Si el usuario modifica motivo o ubicación, el cliente actualiza esas propiedades y procura reemplazar el valor anterior dentro de firma.texto.

Configuración de logs¶

Active el log desde el protocolo:

&debug=true

O desde las propiedades del servidor:

{
  "debug": "true"
}

Archivo activo:

%USERPROFILE%\.ssigner\logs\cliente\ssigner-cliente-AAAA-MM-DD.log

Formato:

2026-06-09 09:58:45.745 [thread] INFO  Clase - Mensaje

La configuración incluye:

• nivel INFO para el cliente y DEBUG cuando debug=true;
• salida por consola y archivo;
• un archivo del cliente por fecha;
• hasta 90 archivos diarios;
• stack traces para errores;
• aislamiento respecto a los archivos de log propios del motor.

Timeout de inserción de firmas¶

El cliente espera 15 minutos por defecto al invocar POST /api/v2/ssigner/insertar-hash-firmado. Los límites pueden cambiarse al iniciar Java:

-Dssigner.http.insertar.connect-timeout-ms=60000
-Dssigner.http.insertar.read-timeout-ms=900000

Un HTTP 504 proviene del proxy y requiere aumentar también proxy_read_timeout en OpenResty o Nginx.

Selección de Java¶

El cliente busca Java en este orden:

1. jre\bin\java.exe junto a la aplicación;
2. jre/bin/java;
3. %JAVA_HOME%\bin\java.exe;
4. comando java disponible en PATH.

Selección del motor¶

Windows-MY busca:

lib\ssigner-2.5.2.jar
<directorio de la aplicación>\lib\ssigner-2.5.2.jar
recurso /lib/ssigner-2.5.2.jar

El flujo PKCS#11 también revisa rutas relativas cercanas al directorio actual.