eSigner dokumentsigneringsgateway API distribueres som et docker-image og installeres på kundens præmisser. Den udfører følgende handlinger:
- Applikationen sender det usignerede PDF-dokument til dokumentsigneringsgatewayens API
- Dokumentsigneringsgateway-applikationen beregner PDF-hash og sender til eSigner CSC API til hash-signering
- Den signerede hash indlejres derefter i PDF-dokumentet som en del af PDF-dokumentets signeringsoperation
- Det signerede PDF-dokument er tidsstemplet vha SSL.com TSA
- Den CRL-baserede tilbagekaldelse af certifikatkæden hentes og indlejres i PDF-dokumentet for at gøre det LTV aktiveret
Krav
Anmodning:-
URL:- /v1/pdf/eseal Der kræves et gyldigt adgangstoken for at få adgang til API'en. En guide til, hvordan du henter adgangstokenet, kan findes i denne artikel: Fjern dokumentsignering 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": "" }
Legende:
- credential_id – Obligatorisk legitimations-id for eSeal-certifikatet. For at vide, hvordan du identificerer legitimations-id'et for dit certifikat, se venligst denne vejledning: https://www.ssl.com/guide/esigner-signing-credential-guide/#ftoc-heading-2
- sidenummer – Kun påkrævet for synlige signaturer. Det starter med 0
- underskriftsårsag – Valgfri underskriftsårsag
- signering_placering – Valgfri signeringsplacering
- Kontaktoplysninger – Valgfri kontaktoplysninger
- sig_felt_position – x, y, bredde og højde af signaturfeltets position. Det er kun påkrævet for synlige signaturer
- hånd_signatur – Base64-kodet PNG-håndsignaturbillede. Det er kun påkrævet for synlige signaturer og for at tilføje håndsignatur som en del af signaturoptræden
- pdf – Base64-kodet PDF-dokument til underskrift
Respons:-
{ "signed_pdf": "" }
- underskrevet_pdf – Base64-kodet signeret LTV-aktiveret PDF-dokument
Installationsvejledning
- Pak udgivelsen af dokumentsigneringsgatewayen ud
- Åbn application.properties-filerne og skift i overensstemmelse hermed
# Til sandkassetestning skal du indstille CSR URL til https://cs-try.ssl.com, og for produktion skal den indstilles til https://cs.ssl.com csc.url=https://cs-try.ssl.com # URL for SSL.com TSA tsa.url=http://ts.ssl.com # Port i docker container server.port=8081 # TLS servercertifikatindstillinger. Man kan bruge selvsigneret certifikat eller privat PKI eller offentlige PKI certifikat server.ssl.enabled=true server.ssl.key-store: ./server.jks server.ssl.key-adgangskode: hemmelig server.ssl.key-store-adgangskode: hemmelig
-
Åbn Dockerfilen
FRA eclipse-temurin:17.0.9_9-jdk-jammy # Port på hvilken dokumentsigneringsgateway vil køre. Dette skal være det samme som i application.properties filen 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=fil:/app/application.properties", "-jar", "document_signing_gateway-1.0.0.jar"]
- Installer Docker Engine på din maskine. Byg derefter docker-billedet ved hjælp af følgende kommando:
docker build -t document_signing_gateway:1.0.0 .
- Kør beholderen ved hjælp af følgende kommando. Det skaber også volumen til Docker Signing Gateway API-logfil og portkortlægning også.
docker run -it -p 8081:8081 -v document_signing_gateway_logs:/logs document_signing_gateway:1.0.0
- Få adgang til dokumentsigneringsgateway-API'en ved hjælp af et program eller POSTMAN-værktøj.