Guida al gateway di firma dei documenti eSigner

Il Gateway per la firma dei documenti eSigner L'API viene distribuita come immagine docker e installata presso la sede del cliente. Esegue le seguenti azioni:

  • L'applicazione invia il documento PDF non firmato all'API del gateway di firma dei documenti
  • L'applicazione gateway per la firma dei documenti calcola l'hash PDF e lo invia all'API CSC di eSigner per la firma dell'hash
  • L'hash firmato viene quindi incorporato nel documento PDF come parte dell'operazione di firma del documento PDF
  • Al documento PDF firmato viene assegnato un timestamp utilizzando SSL.com TSA
  • La revoca della catena di certificati basata su CRL viene recuperata e incorporata nel documento PDF per renderlo abilitato LTV

Requisiti

Richiesta:-

URL:- /v1/pdf/eseal Per accedere all'API è necessario un token di accesso valido. Una guida su come recuperare il token di accesso può essere trovata in questo articolo: Firma remota dei documenti 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, "larghezza":250, "altezza": 150 }, "hand_signature": " ", "PDF": "" }

Legenda:

  • ID_credenziale – ID credenziale obbligatorio del certificato eSeal. Per sapere come identificare l'ID credenziale del tuo certificato, fai riferimento a questa guida: https://www.ssl.com/guide/esigner-signing-credential-guide/#ftoc-heading-2
  • numero di pagina – Necessario solo per firme visibili. Inizia con 0
  • firma_motivo – Motivo della firma facoltativo
  • firma_posizione – Posizione della firma opzionale
  • Informazioni di contatto – Informazioni di contatto facoltative
  • sig_field_position – x, y, larghezza e altezza della posizione del campo firma. È richiesto solo per le firme visibili
  • firma_mano – Immagine della firma a mano PNG con codifica Base64. È necessario solo per le firme visibili e per aggiungere la firma a mano come parte dell'aspetto della firma
  • pdf – Documento PDF codificato Base64 da firmare

Risposta:-

{ "firmato_pdf": "" }
  • firmato_pdf – Documento PDF abilitato LTV firmato con codifica Base64

Istruzioni per l'installazione

  1. Decomprimere la versione del gateway di firma del documento
  2. Apri i file application.properties e modificali di conseguenza
    # Per i test sandbox, imposta il file CSR URL su https://cs-try.ssl.com e per la produzione impostalo su https://cs.ssl.com csc.url=https://cs-try.ssl.com # URL di SSL.com TSA tsa.url=http://ts.ssl.com # Porta nel contenitore docker server.port=8081 # TLS impostazioni del certificato del server. È possibile utilizzare un certificato autofirmato o privato PKI o pubblico PKI certificato server.ssl.enabled=true server.ssl.key-store: ./server.jks server.ssl.key-password: segreto server.ssl.key-store-password: segreto
  3. Apri il Dockerfile
    FROM eclipse-temurin:17.0.9_9-jdk-jammy # Porta su cui verrà eseguito il gateway di firma dei documenti. Deve essere lo stesso del file 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"]
  4. Installa il motore Docker sulla tua macchina. Successivamente, crea l'immagine docker utilizzando il seguente comando:
    docker build -t document_signing_gateway:1.0.0 .
  5. Esegui il contenitore utilizzando il comando seguente. Crea anche volume per anche il file di registro dell'API del gateway di firma docker e la mappatura delle porte.
    docker run -it -p 8081:8081 -v document_signing_gateway_logs:/logs document_signing_gateway:1.0.0
  6. Accedi all'API del gateway di firma dei documenti utilizzando un'applicazione o uno strumento POSTMAN.

Iscriviti alla newsletter di SSL.com

Non perdere nuovi articoli e aggiornamenti da SSL.com

Rimani informato e sicuro

SSL.com è un leader globale nella sicurezza informatica, PKI e certificati digitali. Iscriviti per ricevere le ultime notizie del settore, suggerimenti e annunci di prodotti da SSL.com.

Ci piacerebbe il tuo feedback

Partecipa al nostro sondaggio e facci sapere cosa ne pensi del tuo recente acquisto.