De eSigner-gateway voor documentondertekening API wordt gedistribueerd als een docker-image en wordt geïnstalleerd op het terrein van de klant. Het voert de volgende acties uit:
- De toepassing verzendt het niet-ondertekende PDF-document naar de documentondertekeningsgateway-API
- De gateway-applicatie voor documentondertekening berekent de PDF-hash en verzendt deze naar de eSigner CSC API voor hash-ondertekening
- De ondertekende hash wordt vervolgens in het PDF-document ingebed als onderdeel van de ondertekeningsbewerking van het PDF-document
- Het ondertekende PDF-document krijgt een tijdstempel met behulp van SSL.com TSA
- De op CRL gebaseerde intrekking van de certificaatketen wordt opgehaald en ingebed in het PDF-document om het LTV mogelijk te maken
Voorwaarden
Verzoek:-
URL:- /v1/pdf/eseal
Om toegang te krijgen tot de API is een geldig toegangstoken vereist. Een handleiding over het ophalen van het toegangstoken vindt u in dit artikel: Ondertekening van documenten op afstand met 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": "" }
Legenda:
- referentie_id – Verplichte identificatie-ID van het eSeal-certificaat. Raadpleeg deze handleiding om te weten hoe u de identificatie-ID van uw certificaat kunt identificeren: https://www.ssl.com/guide/esigner-signing-credential-guide/#ftoc-heading-2
- paginanummer – Alleen vereist voor zichtbare handtekeningen. Het begint met 0
- ondertekening_reden – Optionele ondertekeningsreden
- ondertekening_locatie – Optionele ondertekeningslocatie
- contact informatie – Optionele contactgegevens
- sig_veld_positie – x, y, breedte en hoogte van de handtekeningveldpositie. Dit is alleen vereist voor zichtbare handtekeningen
- hand_handtekening – Base64-gecodeerde PNG-handtekeningafbeelding. Dit is alleen vereist voor zichtbare handtekeningen en om een handtekening toe te voegen als onderdeel van de weergave van de handtekening
- pdf – Base64-gecodeerd PDF-document om te ondertekenen
Antwoord:-
{ "ondertekende_pdf": "" }
- ondertekend_pdf – Base64-gecodeerd ondertekend LTV-compatibel PDF-document
Installatie-instructies
- Pak de release van de gateway voor documentondertekening uit
- Open de application.properties-bestanden en wijzig deze dienovereenkomstig
# Voor sandbox-testen stelt u de CSR URL naar https://cs-try.ssl.com en voor productie stelt u deze in op https://cs.ssl.com csc.url=https://cs-try.ssl.com # URL van SSL.com TSA tsa.url=http://ts.ssl.com # Poort in docker-containerserver.port=8081 # TLS instellingen voor servercertificaten. Men kan een zelfondertekend certificaat of privé gebruiken PKI of openbaar PKI certificaat server.ssl.enabled=waar server.ssl.key-store: ./server.jks server.ssl.key-password: geheim server.ssl.key-store-password: geheim
-
Open het Dockerbestand
FROM eclipse-temurin:17.0.9_9-jdk-jammy # Poort waarop de gateway voor documentondertekening zal worden uitgevoerd. Dit moet hetzelfde zijn als in het bestand 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=bestand:/app/application.properties", "-jar", "document_signing_gateway-1.0.0.jar"]
- Installeer Docker-engine op uw machine. Bouw daarna de docker-image met behulp van de volgende opdracht:
docker build -t document_signing_gateway:1.0.0 .
- Voer de container uit met de volgende opdracht. Het creëert ook volume voor Docker Signing Gateway API-logbestand en poorttoewijzing ook.
docker run -it -p 8081:8081 -v document_signing_gateway_logs:/logs document_signing_gateway:1.0.0
- Krijg toegang tot de documentondertekeningsgateway-API met behulp van een applicatie of POSTMAN-tool.
