. eSigneri dokumentide allkirjastamise lüüs API levitab dokipildina ja installib kliendi ruumidesse. See teostab järgmisi toiminguid:
- Rakendus saadab allkirjastamata PDF-dokumendi dokumendi allkirjastamise lüüsi API-le
- Dokumendi allkirjastamise lüüsi rakendus arvutab PDF-i räsi ja saadab räsi allkirjastamiseks eSigner CSC API-le
- Allkirjastatud räsi manustatakse seejärel PDF-dokumenti osana PDF-dokumendi allkirjastamise operatsioonist
- Allkirjastatud PDF-dokument on ajatempliga kasutades SSL.com TSA
- Sertifikaadi ahela CRL-põhine tühistamine tuuakse ja manustatakse PDF-dokumenti, et muuta see LTV lubatud
Nõuded
Taotlus:-
URL:- /v1/pdf/eseal API-le juurdepääsuks on vaja kehtivat juurdepääsuluba. Juhendi juurdepääsuloa hankimiseks leiate sellest artiklist: Kaugdokumentide allkirjastamine eSigner CSC API abil{ "credential_id": "db1653b7-6135-4a10-809b-e29a25d3bb7b", "lehe_number": 0, "signing_reason": "", "signing_location": "", "contact_Info": "", "sig_field_position":{ " x": 160, "y": 245, "width": 250, "height": 150 }, "hand_signature": " ", "pdf": "" }
Legend:
- mandaadi_id – eSeali sertifikaadi kohustuslik mandaadi ID. Et teada saada, kuidas oma sertifikaadi mandaadi ID tuvastada, vaadake seda juhendit: https://ssl.com/guide/esigner-signing-credential-guide/#ftoc-heading-2
- lehekülje number – Nõutav ainult nähtavate allkirjade puhul. See algab 0-ga
- allkirjastamise_põhjus – Valikuline allkirjastamise põhjus
- allkirjastamise_koht – Valikuline allkirjastamiskoht
- kontaktinfo - Valikuline kontaktteave
- sig_field_position – x, y, allkirjavälja asukoha laius ja kõrgus. See on vajalik ainult nähtavate allkirjade jaoks
- käsitsi_allkiri - Base64 kodeeritud PNG-käeallkirja pilt. See on vajalik ainult nähtavate allkirjade jaoks ja allkirja välimuse osana omapoolse allkirja lisamiseks
- pdf - Base64 kodeeritud PDF-dokument allkirjastamiseks
Vastus:-
{ "signed_pdf": "" }
- signed_pdf – Base64 kodeeritud allkirjastatud LTV-ga PDF-dokument
Paigaldusjuhend
- Pakkige lahti dokumendi allkirjastamise lüüsi väljalase
- Avage failid application.properties ja muutke seda vastavalt
# Liivakasti testimiseks määrake CSR URL aadressile https://cs-try.ssl.com ja tootmiseks määrake see https://cs.ssl.com csc.url=https://cs-try.ssl.com # SSL.com-i URL TSA tsa.url=http://ts.ssl.com # Port dokkeri konteineris server.port=8081 # TLS serveri sertifikaadi seaded. Võib kasutada ise allkirjastatud sertifikaati või privaatset sertifikaati PKI või avalik PKI sertifikaat server.ssl.enabled=true server.ssl.key-store: ./server.jks server.ssl.key-password: salajane server.ssl.key-store-password: salajane
-
Avage Dockerfile
FROM eclipse-temurin:17.0.9_9-jdk-jammy # Port, millel dokumendi allkirjastamise lüüs töötab. See peab olema sama, mis failis 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"]
- Installige Docker Engine teie masinal. Seejärel looge dokkeri pilt järgmise käsu abil:
docker build -t document_signing_gateway:1.0.0 .
- Käivitage konteiner järgmise käsu abil. See loob ka helitugevust docker signing gateway API logifail ja pordi kaardistamine.
docker run -it -p 8081:8081 -v document_signing_gateway_logs:/logs document_signing_gateway:1.0.0
- Juurdepääs dokumendi allkirjastamise lüüsi API-le rakenduse või POSTMANi tööriista abil.
