Saltar a contenido

Guía de inicio rápido

Objetivo

Esta guía permite comprobar la instalación y ejecutar una operación de firma desde Windows.

Requisitos previos

  • SSigner Cliente instalado.
  • Acceso a la API configurada por la aplicación.
  • Certificado digital con clave privada:
  • instalado en Windows-MY; o
  • disponible en un token PKCS#11.
  • DNI o identificador del firmante.
  • Código de operación vigente.
  • Token de autenticación emitido por la plataforma.

Proteja el token

El parámetro token es una credencial. No lo publique, no lo incluya en capturas y no lo guarde en scripts compartidos.

Primera ejecución

1. Construir la URL

Use este formato:

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

Parámetros mínimos:

Parámetro Requerido Ejemplo
dni Sí 12345678
cod-operation Sí 1001
token Según el servidor eyJ...

2. Abrir la URL

Desde la plataforma web:

window.location.href =
  "ssigner://dni=12345678&cod-operation=1001&token=TOKEN_TEMPORAL";

Para una prueba manual en PowerShell:

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

3. Seleccionar el certificado

En el flujo Windows-MY:

  1. Revise la lista de certificados.
  2. Seleccione el certificado que contiene la clave privada.
  3. Complete Motivo y Ubicación si corresponde.
  4. Pulse el botón de firma.

4. Esperar la confirmación

La aplicación:

  1. solicita los hashes al servidor;
  2. ejecuta el motor local;
  3. lee las firmas generadas;
  4. envía las firmas al servidor;
  5. muestra el resultado.

Resultado esperado

La interfaz debe indicar que las firmas fueron subidas correctamente y mostrar la cantidad de documentos firmados.

Probar con PKCS#11

Añada el repositorio al protocolo:

ssigner://dni=12345678&cod-operation=1001&token=TOKEN_TEMPORAL&tipo-repo=PKCS11

Después:

  1. conecte el token;
  2. seleccione o detecte la DLL PKCS#11;
  3. introduzca el PIN;
  4. cargue los certificados;
  5. seleccione un certificado y firme.

Activar diagnóstico

Añada debug=true:

ssigner://dni=12345678&cod-operation=1001&token=TOKEN_TEMPORAL&debug=true

El archivo se crea en:

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

Consulte Problemas comunes si la ventana no abre, no aparecen certificados o el motor devuelve un error.