Problemas comunes¶

La aplicación no abre desde el navegador¶

Síntomas¶

• Windows pregunta con qué aplicación abrir ssigner://.
• El navegador no realiza ninguna acción.

Solución¶

1. Compruebe que SSigner Cliente está instalado.
2. Revise el registro:

reg query HKEY_CLASSES_ROOT\ssigner\shell\open\command

1. Confirme que la ruta registrada apunta al .exe.
2. Pruebe:

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

Parámetros inválidos o incompletos¶

La URL requiere dni y cod-operation:

ssigner://dni=12345678&cod-operation=1001&token=TOKEN

Codifique valores especiales en URL. En JavaScript:

const url = `ssigner://dni=${encodeURIComponent(dni)}`
  + `&cod-operation=${encodeURIComponent(operation)}`
  + `&token=${encodeURIComponent(token)}`;

No aparecen certificados¶

Windows-MY¶

1. Abra certmgr.msc.
2. Revise Personal > Certificados.
3. Confirme que el certificado tiene clave privada.
4. Desactive temporalmente filter-by-dni=true para descartar un filtro incorrecto.

PKCS#11¶

1. Instale el middleware del fabricante.
2. Compruebe la DLL seleccionada.
3. Reconecte el token.
4. Verifique el PIN.
5. Use Buscar si la detección automática no encuentra la DLL.

No se encuentra el motor¶

Mensaje:

No se encontro el motor de firma (ssigner-2.5.2.jar)

Compruebe:

Test-Path ".\lib\ssigner-2.5.2.jar"

La solución recomendada es restaurar:

<instalación>\lib\ssigner-2.5.2.jar

Java no está disponible¶

El cliente intenta utilizar el JRE empaquetado. Compruebe:

Test-Path ".\jre\bin\java.exe"
.\jre\bin\java.exe -version

La versión esperada es Java 17.

Errores de red o autenticación¶

Pruebe conectividad:

Test-NetConnection s-055-2025.plussigner.com -Port 443

Códigos devueltos por el motor¶

Activar logs de diagnóstico¶

Ejecute la operación con:

&debug=true

Abra el archivo:

Get-Content "$env:USERPROFILE\.ssigner\logs\cliente\ssigner-cliente-$(Get-Date -Format yyyy-MM-dd).log" -Tail 200

Buscar errores:

Select-String `
  -Path "$env:USERPROFILE\.ssigner\logs\cliente\ssigner-cliente-$(Get-Date -Format yyyy-MM-dd).log" `
  -Pattern "ERROR|WARN"

Limpiar archivos temporales¶

Cierre la aplicación antes de borrar archivos:

Remove-Item "$env:USERPROFILE\.ssigner\entrada\*" -Force -ErrorAction SilentlyContinue
Remove-Item "$env:USERPROFILE\.ssigner\config\*" -Force -ErrorAction SilentlyContinue

No elimine certificados, controladores PKCS#11 ni el motor instalado.