eSigner Gateway-handleiding voor documentondertekening

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

  1. Pak de release van de gateway voor documentondertekening uit
  2. 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
  3. 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"]
  4. 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 .
  5. 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
  6. Krijg toegang tot de documentondertekeningsgateway-API met behulp van een applicatie of POSTMAN-tool.

Abonneer u op de nieuwsbrief van SSL.com

Mis geen nieuwe artikelen en updates van SSL.com

Blijf geïnformeerd en veilig

SSL.com is een wereldleider op het gebied van cyberbeveiliging, PKI en digitale certificaten. Meld u aan om het laatste branchenieuws, tips en productaankondigingen te ontvangen van SSL.com.

We willen graag uw feedback

Vul onze enquête in en laat ons uw mening over uw recente aankoop weten.