API Java del Motor SSigner¶

SSigner ssigner = new SSigner();
String estado = ssigner.iniciar(args);

// Metodos principales
crearConfiguracion(Properties) -> SSignerConfiguracion
crearFirmaEnBlanco(String codigo, String docOriginal, String prefirma, String campo, Properties) -> byte[]
firmar(byte[] hashSha256, Properties) -> byte[]
insertarHashFirmado(String preFirma, File docFirmado, byte[] hashFirmado, String nombreCampo, Properties)
agregarLtv(File docFirmado, Properties)

// Fase 1: Generar hash
byte[] signedAttrs = cades.generarHashParaFirmar(archivo, ssc);

// Fase 2: Firmar
byte[] firma = cades.firmarConClave(signedAttrs, ssc);

// Fase 3: Construir .p7m
cades.construirP7m(archivoOriginal, ssc, firma, archivoP7m);

SSignerFirmaDetached ssfd = new SSignerFirmaDetached(ssr);
ssfd.firmar(ssc, archivoEntrada, archivoSalida, "__signature__", "CODIGO");

validarCadenaCompleta(Certificate[], boolean requiereNoRepudio) -> String
validarCertificadoTsa(X509Certificate) -> String

generarRecuadroFirmanteYTexto(...)
generarRecuadroTextoConImagenDerecha(...)
generarRecuadroTextoConImagenIzquierda(...)
generarRecuadroTextoConImagenArriba(...)
generarRecuadroTextoConImagenAbajo(...)

CacheUtil.guardar(carpeta, nombre, contenido) -> boolean
CacheUtil.leer(archivo) -> byte[]
CacheUtil.guardarPropiedades(props, ruta) -> boolean

// 1. Cargar keystore
KeyStore ks = KeyStore.getInstance("Windows-My");
ks.load(null);

// 2. Configurar firma
SSignerConfiguracion ssc = new SSignerConfiguracion();
ssc.setAlias("mi-alias");
ssc.setVisible(true);
ssc.setPagina(1);
ssc.setX(0); ssc.setY(0); ssc.setX1(200); ssc.setY1(100);
ssc.setTexto("Firmado por [CN]");
ssc.setAlgoritmo("SHA256");
ssc.setEstiloFirma(0);

// 3. Crear firmante remoto
SSignerRemoto ssr = new SSignerRemoto();
ssr.setKs(ks);
ssr.setClavePrivada((PrivateKey) ks.getKey("mi-alias", null));
ssr.setCadenaCertificacion(ks.getCertificateChain("mi-alias"));
ssr.setNombreProveedor(ks.getProvider().getName());

// 4. Fase 1: Crear campo en blanco
byte[] hash = ssr.crearFirmaEnBlanco("CODIGO",
    "/entrada/doc.pdf", "/salida/doc.prefirma", "__signature__", props);

// 5. Fase 2: Firmar hash
byte[] hashFirmado = ssr.firmar(hash, props);

// 6. Fase 3: Insertar en PDF
ssr.insertarHashFirmado("/salida/doc.prefirma",
    new File("/salida/doc_firmado.pdf"), hashFirmado, "__signature__", props);

Properties props = new Properties();
props.setProperty("firma.repositorio", "Windows-My");
props.setProperty("firma.visible", "true");
props.setProperty("firma.pagina", "1");
props.setProperty("firma.estilo", "3");
props.setProperty("firma.texto", "Firmado por [CN] el [FECHA]");
props.setProperty("firma.x", "0");
props.setProperty("firma.y", "0");
props.setProperty("firma.x1", "200");
props.setProperty("firma.y1", "100");
props.setProperty("firma.carpeta.entrada", "/ruta/entrada");
props.setProperty("firma.carpeta.salida", "/ruta/salida");
props.setProperty("firma.algoritmo", "SHA256");

SSignerRemoto ssr = new SSignerRemoto();
ssr.setKs(keyStore);
ssr.setClavePrivada(privateKey);
ssr.setCadenaCertificacion(certChain);

<dependency>
    <groupId>com.saeta</groupId>
    <artifactId>ssigner</artifactId>
    <version>2.5.2</version>
    <classifier>all</classifier>
</dependency>