- eSigner asiakirjan allekirjoitusyhdyskäytävä API jaetaan telakointikuvana ja asennetaan asiakkaan tiloissa. Se suorittaa seuraavat toiminnot:
- Sovellus lähettää allekirjoittamattoman PDF-dokumentin asiakirjan allekirjoitusyhdyskäytävän API:lle
- Asiakirjan allekirjoituksen yhdyskäytäväsovellus laskee PDF-tiivisteen ja lähettää sen eSigner CSC API:lle hajautusallekirjoitusta varten
- Allekirjoitettu hash upotetaan sitten PDF-dokumenttiin osana PDF-dokumentin allekirjoitustoimintoa
- Allekirjoitettu PDF-dokumentti on aikaleimattu käyttämällä SSL.com TSA
- Varmenneketjun CRL-pohjainen kumoaminen noudetaan ja upotetaan PDF-dokumentin sisään, jotta se voidaan ottaa käyttöön
vaatimukset
Pyyntö:-
URL:- /v1/pdf/eseal Sovellusliittymän käyttämiseen tarvitaan kelvollinen käyttöoikeustunnus. Tästä artikkelista löytyy opas pääsytunnuksen hakemiseen: Etäasiakirjojen allekirjoittaminen eSigner CSC -sovellusliittymällä{ "credential_id": "db1653b7-6135-4a10-809b-e29a25d3bb7b", "sivun_numero": 0, "signing_reason": "", "signing_location": "", "contact_Info": "", "sig_field_position":{ " x": 160, "y":245, "width":250, "height": 150 }, "hand_signature": " ", "pdf": "" }
Legend:
- credential_id – eSeal-varmenteen pakollinen tunniste. Katso tästä oppaasta, kuinka voit tunnistaa varmenteesi tunnistetunnuksen: https://www.ssl.com/guide/esigner-signing-credential-guide/#ftoc-heading-2
- sivunumero – Vaaditaan vain näkyville allekirjoituksille. Se alkaa 0:lla
- allekirjoitussyy – Valinnainen allekirjoitussyy
- signing_location – Valinnainen allekirjoituspaikka
- yhteystiedot – Valinnaiset yhteystiedot
- sig_field_position – x, y, allekirjoituskentän sijainnin leveys ja korkeus. Sitä tarvitaan vain näkyville allekirjoituksille
- käsin_allekirjoitus – Base64-koodattu PNG-käsikirjoituskuva. Sitä tarvitaan vain näkyville allekirjoituksille ja käsin allekirjoituksen lisäämiselle osaksi allekirjoituksen ulkoasua
- pdf – Base64-koodattu PDF-dokumentti allekirjoitettavaksi
Vastaus:-
{ "allekirjoitettu_pdf": "" }
- signed_pdf – Base64-koodattu allekirjoitettu LTV-yhteensopiva PDF-dokumentti
Asennusohjeet
- Pura asiakirjan allekirjoitusyhdyskäytävän julkaisu
- Avaa application.properties-tiedostot ja muuta niitä vastaavasti
# Aseta hiekkalaatikkotestausta varten CSR URL-osoite osoitteeseen https://cs-try.ssl.com ja tuotantoa varten aseta se https://cs.ssl.com csc.url=https://cs-try.ssl.com # SSL.comin URL-osoite TSA tsa.url=http://ts.ssl.com # Portti telakointisäiliössä server.port=8081 # TLS palvelimen varmenneasetukset. Voidaan käyttää itse allekirjoitettua varmennetta tai yksityistä PKI tai julkista PKI sertifikaattipalvelin.ssl.enabled=true server.ssl.key-store: ./server.jks server.ssl.key-password: salainen palvelin.ssl.key-store-salasana: salainen
-
Avaa Docker-tiedosto
FROM eclipse-temurin:17.0.9_9-jdk-jammy # Portti, jossa asiakirjan allekirjoitusyhdyskäytävä ajetaan. Tämän on oltava sama kuin tiedostossa 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"]
- Asenna Docker Engine koneellesi. Rakenna tämän jälkeen telakointikuva seuraavalla komennolla:
docker build -t document_signing_gateway:1.0.0 .
- Suorita säilö käyttämällä seuraavaa komentoa. Se luo myös volyymia Docker Signing Gateway API -lokitiedosto ja porttikartoitus samoin.
docker run -it -p 8081:8081 -v document_signing_gateway_logs:/logs document_signing_gateway:1.0.0
- Käytä asiakirjan allekirjoitusyhdyskäytävän sovellusliittymää sovelluksen tai POSTMAN-työkalun avulla.