Manual de uso¶

Inicio desde la plataforma web¶

SSigner Cliente requiere normalmente los parámetros enviados por ssigner://. Si se abre sin ellos, muestra un error de inicialización y termina.

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

Firma con Windows-MY¶

Preparar el certificado¶

El certificado debe:

• estar instalado en el almacén personal de Windows;
• tener clave privada accesible;
• estar vigente;
• permitir firma digital.

Puede revisar certificados con:

certmgr.msc

Seleccionar y firmar¶

1. Abra la operación desde la plataforma.
2. Revise nombre, organización y cargo mostrados para cada certificado.
3. Seleccione el certificado correcto.
4. Complete Motivo y Ubicación si la operación lo permite.
5. Inicie la firma.
6. Espere el envío de los resultados.

Filtrar certificados¶

Para mostrar únicamente certificados cuyo sujeto contiene el DNI o RUC indicado:

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

También se acepta el alias filterByDni=true.

Firma con PKCS#11¶

Abrir el flujo¶

Use:

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

Cargar el token¶

1. Conecte el token USB o HSM.
2. Pulse Auto-detectar para buscar una DLL conocida.
3. Si no se detecta, pulse Buscar y seleccione la DLL del fabricante.
4. Introduzca el PIN.
5. Pulse Cargar certificados.
6. Seleccione un certificado.
7. Inicie la firma.

Errores visibles del token¶

Archivos temporales¶

Windows-MY utiliza:

%USERPROFILE%\.ssigner\
├── entrada\
├── salida\
├── config\
├── cache\
└── imagen\

PKCS#11 utiliza una carpeta por firmante:

%USERPROFILE%\.ssigner\<DNI>\
├── entrada\
├── salida\
├── config\
├── cache\
└── imagen\

Durante la firma se crean archivos como:

documento.pdf.prefirma.sha256
documento.pdf.prefirma.firmado
documentos.txt
ssigner.properties

Cierre de la operación¶

Tras una firma correcta, el cliente envía las firmas al endpoint /insertar-hash-firmado. No cierre la aplicación mientras se muestra:

Enviando firmas al servidor...