El Portal de firma de documentos eSigner La API se distribuye como una imagen acoplable y se instala en las instalaciones del cliente. Realiza las siguientes acciones:
- La aplicación envía el documento PDF sin firmar a la API de la puerta de enlace de firma de documentos.
- La aplicación de puerta de enlace de firma de documentos calcula el hash del PDF y lo envía a la API eSigner CSC para la firma del hash.
- Luego, el hash firmado se incrusta dentro del documento PDF como parte de la operación de firma del documento PDF.
- El documento PDF firmado tiene una marca de tiempo usando SSL.com TSA
- La revocación de la cadena de certificados basada en CRL se recupera y se incrusta dentro del documento PDF para habilitar LTV.
Requisitos
Pedido:-
URL:- /v1/pdf/eseal
Se requiere un token de acceso válido para acceder a la API. Puede encontrar una guía sobre cómo recuperar el token de acceso en este artículo: Firma remota de documentos con eSigner CSC API
{ "credential_id": "db1653b7-6135-4a10-809b-e29a25d3bb7b", "page_number": 0, "signing_reason": "", "signing_location": "", "contact_Info": "", "sig_field_position":{ " x": 160, "y":245, "ancho":250, "alto": 150 }, "hand_signature": " ", "pdf": "" }
Leyenda:
- credencial_id – ID de credencial obligatoria del certificado eSeal. Para saber cómo identificar el ID de credencial de su certificado, consulte esta guía: https://www.ssl.com/guide/esigner-signing-credential-guide/#ftoc-heading-2
- número de página – Sólo se requiere para firmas visibles. comienza con 0
- firma_motivo – Motivo de firma opcional
- firma_ubicación – Ubicación de firma opcional
- Datos de contacto – Información de contacto opcional
- posición_campo_sig – x, y, ancho y alto de la posición del campo de firma. Sólo es necesario para firmas visibles.
- firma_de_mano – Imagen de firma de mano PNG codificada en Base64. Solo es necesario para firmas visibles y para agregar firma manual como parte de la apariencia de la firma.
- pdf – Documento PDF codificado en Base64 para firmar
Respuesta:-
{ "firmado_pdf": "" }
- pdf_firmado – Documento PDF habilitado para LTV firmado y codificado en Base64
Instrucciones de aplicación
- Descomprima la versión del portal de firma de documentos
- Abra los archivos application.properties y cámbielos en consecuencia
# Para pruebas de espacio aislado, configure el CSR URL a https://cs-try.ssl.com y para producción configúrelo en https://cs.ssl.com csc.url=https://cs-try.ssl.com # URL de SSL.com TSA tsa.url=http://ts.ssl.com # Puerto en el contenedor Docker server.port=8081 # TLS configuración del certificado del servidor. Se puede utilizar un certificado autofirmado o privado. PKI o público PKI certificado server.ssl.enabled=true server.ssl.key-store: ./server.jks server.ssl.key-password: secreto server.ssl.key-store-contraseña: secreto
-
Abra el archivo Docker
FROM eclipse-temurin:17.0.9_9-jdk-jammy # Puerto en el que se ejecutará la puerta de enlace de firma de documentos. Esto debe ser igual que en el archivo application.properties EXPOSE 8081 WORKDIR /app COPY document_signing_gateway-1.0.0.jar /app/ COPY application.properties /app/ COPY server.jks /app/ COPY GoNotoKurrent.ttf /app/ ENTRYPOINT [" java", "-Dspring.config.location=file:/app/application.properties", "-jar", "document_signing_gateway-1.0.0.jar"]
- Instalar el motor Docker en su máquina. Luego, cree la imagen de la ventana acoplable usando el siguiente comando:
ventana acoplable build -t document_signing_gateway:1.0.0.
- Ejecute el contenedor usando el siguiente comando. También crea volumen para Archivo de registro de API de puerta de enlace de firma de Docker y mapeo de puertos también.
ventana acoplable ejecutar -it -p 8081:8081 -v document_signing_gateway_logs:/logs document_signing_gateway:1.0.0
- Acceda a la API de la puerta de enlace de firma de documentos mediante una aplicación o herramienta POSTMAN.
