A eSigner dokumentum-aláíró átjáró Az API-t docker-lemezképként terjeszti, és az ügyfél telephelyére telepíti. A következő műveleteket hajtja végre:
- Az alkalmazás elküldi az aláíratlan PDF-dokumentumot a dokumentum-aláíró átjáró API-nak
- A dokumentum-aláíró átjáróalkalmazás kiszámítja a PDF-kivonatot, és elküldi az eSigner CSC API-nak hash-aláíráshoz
- Az aláírt hash ezután beágyazódik a PDF dokumentumba a PDF dokumentum aláírási művelet részeként
- Az aláírt PDF-dokumentum időbélyegzővel van ellátva SSL.com TSA
- A tanúsítványlánc CRL-alapú visszavonását a rendszer lekéri és beágyazza a PDF dokumentumba, hogy az LTV engedélyezve legyen.
követelmények
Kérés:-
URL:- /v1/pdf/eseal Az API eléréséhez érvényes hozzáférési token szükséges. A hozzáférési token lekéréséhez ebben a cikkben talál útmutatót: Távoli dokumentum-aláírás eSigner CSC API-val{ "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": "" }
Jelmagyarázat:
- hitelesítő_azonosító – Az eSeal tanúsítvány kötelező hitelesítő azonosítója. A tanúsítvány hitelesítési azonosítójának azonosításához olvassa el ezt az útmutatót: https://www.ssl.com/guide/esigner-signing-credential-guide/#ftoc-heading-2
- oldalszám – Csak a látható aláírásokhoz szükséges. 0-val kezdődik
- aláírási_ok – Opcionális aláírási ok
- aláírási_hely – Választható aláírási hely
- elérhetőségei – Választható elérhetőség
- sig_field_position – x, y, az aláírási mező pozíciójának szélessége és magassága. Csak a látható aláírásokhoz szükséges
- kézi_aláírás – Base64 kódolású PNG kézi aláírás kép. Csak a látható aláírásokhoz és a kézi aláírás hozzáadásához szükséges az aláírás megjelenésének részeként
- pdf – Aláírandó Base64 kódolású PDF dokumentum
Válasz:-
{ "signed_pdf": "" }
- signed_pdf – Base64 kódolású aláírt LTV-kompatibilis PDF dokumentum
Szerelési útmutató
- Csomagolja ki a dokumentum-aláíró átjáró kiadását
- Nyissa meg az application.properties fájlokat, és módosítsa ennek megfelelően
# Sandbox teszteléshez állítsa be a CSR URL a https://cs-try.ssl.com címre, éles esetén pedig a https://cs.ssl.com csc.url=https://cs-try.ssl.com # Az SSL.com URL-je TSA tsa.url=http://ts.ssl.com # Port a docker konténerben server.port=8081 # TLS szerver tanúsítvány beállításait. Használható önaláírt tanúsítvány vagy privát PKI vagy nyilvános PKI tanúsítvány szerver.ssl.enabled=true server.ssl.key-store: ./server.jks server.ssl.key-password: titkos szerver.ssl.key-store-password: titkos
-
Nyissa meg a Docker-fájlt
FROM eclipse-temurin:17.0.9_9-jdk-jammy # Port, amelyen a dokumentum-aláíró átjáró futni fog. Ennek meg kell egyeznie az application.properties fájlban 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"]
- Telepítse a Docker Engine-t a gépeden. Ezután készítse el a docker image-et a következő paranccsal:
docker build -t document_signing_gateway:1.0.0 .
- Futtassa a tárolót a következő paranccsal. Hangerőt is létrehoz a számára docker signing gateway API naplófájl és portleképezés is.
docker run -it -p 8081:8081 -v document_signing_gateway_logs:/logs document_signing_gateway:1.0.0
- Hozzáférés a dokumentum-aláíró átjáró API-hoz egy alkalmazás vagy POSTMAN eszköz segítségével.
