Guide för eSigner Document Signing Gateway

Smakämnen eSigner dokumentsigneringsgateway API distribueras som en docker image och installeras på kundens premiss. Den utför följande åtgärder:

• Applikationen skickar det osignerade PDF-dokumentet till API:et för dokumentsigneringsgatewayen
• Dokumentsigneringsgatewayapplikationen beräknar PDF-hash och skickar till eSigner CSC API för hashsignering
• Den signerade hashen bäddas sedan in i PDF-dokumentet som en del av PDF-dokumentets signeringsoperation
• Det signerade PDF-dokumentet är tidsstämplat med SSL.com TSA
• Den CRL-baserade återkallelsen av certifikatkedjan hämtas och bäddas in i PDF-dokumentet för att göra det LTV-aktiverat

Krav

Begäran:-

URL:- /v1/pdf/seal En giltig åtkomsttoken krävs för att få åtkomst till API:t. En guide om hur du hämtar åtkomsttoken finns i den här artikeln: Fjärranslutning av dokument med 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, "width":250, "height": 150 }, "hand_signature": " ", "pdf": "" }

Förklaring:

• credential_id – Obligatoriskt legitimations-ID för eSeal-certifikatet. För att veta hur du identifierar legitimations-ID för ditt certifikat, se den här guiden: https://www.ssl.com/guide/esigner-signing-credential-guide/#ftoc-heading-2
• Sidonummer – Krävs endast för synliga signaturer. Det börjar med 0
• signering_reason – Valfri undertecknande orsak
• signering_plats – Valfri signeringsplats
• Kontaktinformation – Valfri kontaktinformation
• sig_field_position – x, y, bredd och höjd på signaturfältets position. Det krävs endast för synliga signaturer
• hand_signatur – Base64-kodad PNG-handsignaturbild. Det krävs bara för synliga signaturer och för att lägga till handsignatur som en del av signaturens utseende
• pdf – Base64-kodat PDF-dokument att signera

Svar:-

{ "signed_pdf": "" }

• signerad_pdf – Base64-kodat signerat LTV-aktiverat PDF-dokument

Installationsinstruktioner

1. Packa upp versionen av dokumentsigneringsgatewayen
2. Öppna application.properties-filerna och ändra därefter
   

   # För sandlådetestning, ställ in CSR URL till https://cs-try.ssl.com och för produktion ställ in den till https://cs.ssl.com csc.url=https://cs-try.ssl.com # URL för SSL.com TSA tsa.url=http://ts.ssl.com # Port in docker container server.port=8081 # TLS servercertifikatinställningar. Man kan använda självsignerat certifikat eller privat PKI eller offentliga PKI certifikat server.ssl.enabled=true server.ssl.key-store: ./server.jks server.ssl.key-lösenord: hemlig server.ssl.key-store-lösenord: hemligt

3. Öppna Dockerfilen

   FRÅN eclipse-temurin:17.0.9_9-jdk-jammy # Port på vilken dokumentsigneringsgateway kommer att köras. Detta måste vara samma som i filen 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. Installera Docker Engine på din maskin. Bygg sedan docker-bilden med följande kommando:
   

   docker build -t document_signing_gateway:1.0.0 .

5. Kör behållaren med följande kommando. Det skapar också volym för docker signering gateway API-loggfil och portmappning också.
   

   docker kör -it -p 8081:8081 -v document_signing_gateway_logs:/logs document_signing_gateway:1.0.0

6. Få åtkomst till dokumentsigneringsgatewayens API med ett program eller POSTMAN-verktyg.