Projekt Brána pro podepisování dokumentů eSigner Rozhraní API se distribuuje jako docker image a instaluje se v místě zákazníka. Provádí následující akce:
- Aplikace odešle nepodepsaný dokument PDF do rozhraní API brány pro podepisování dokumentů
- Aplikace brány pro podepisování dokumentů vypočítá hash PDF a odešle jej do eSigner CSC API pro podepsání hash
- Podepsaný hash je pak vložen do dokumentu PDF jako součást operace podepisování dokumentu PDF
- Podepsaný dokument PDF je opatřen časovým razítkem pomocí SSL.com TSA
- Zrušení řetězce certifikátů na základě CRL je načteno a vloženo do dokumentu PDF, aby bylo povoleno LTV
požadavky
Žádost:-
URL:- /v1/pdf/eseal Pro přístup k API je vyžadován platný přístupový token. Návod, jak získat přístupový token, naleznete v tomto článku: Vzdálené podepisování dokumentů pomocí eSigner CSC API{ "id_pověření": "db1653b7-6135-4a10-809b-e29a25d3bb7b", "číslo_stránky": 0, "důvod_podpisu": "", "umístění_podpisu": "", "kontaktní_informace": "", "sig_field_position":{ " x": 160, "y":245, "width":250, "height": 150 }, "hand_signature": " ", "pdf": "" }
Legenda:
- credential_id – Povinné identifikační číslo certifikátu eSeal. Chcete-li zjistit, jak identifikovat ID pověření vašeho certifikátu, přečtěte si prosím tuto příručku: https://www.ssl.com/guide/esigner-signing-credential-guide/#ftoc-heading-2
- číslo stránky – Vyžaduje se pouze pro viditelné podpisy. Začíná to 0
- důvod_podpisu – Volitelný důvod podpisu
- umístění_podpisu – Volitelné místo podpisu
- kontaktní informace – Volitelné kontaktní informace
- sig_field_position – x, y, šířka a výška pozice pole podpisu. Vyžaduje se pouze pro viditelné podpisy
- ruční_podpis – Obrázek vlastnoručního podpisu PNG kódovaný Base64. Je vyžadován pouze pro viditelné podpisy a pro přidání vlastnoručního podpisu jako součást vzhledu podpisu
- pdf – Base64 kódovaný PDF dokument k podepsání
Odezva:-
{ "signed_pdf": "" }
- podepsané_pdf – Base64 zakódovaný podepsaný dokument PDF s povolenou LTV
Návod k instalaci
- Rozbalte vydání brány pro podepisování dokumentů
- Otevřete soubory application.properties a podle toho je změňte
# Pro testování sandboxu nastavte CSR Adresa URL na https://cs-try.ssl.com a pro produkci ji nastavte na https://www.ssl.com/cs csc.url=https://cs-try.ssl.com # URL adresy SSL.com TSA tsa.url=http://ts.ssl.com # Port v kontejneru dockeru server.port=8081 # TLS nastavení certifikátu serveru. Lze použít certifikát s vlastním podpisem nebo soukromý PKI nebo veřejné PKI certifikát server.ssl.enabled=true server.ssl.key-store: ./server.jks server.ssl.key-password: tajný server.ssl.key-store-password: tajný
-
Otevřete soubor Dockerfile
FROM eclipse-temurin:17.0.9_9-jdk-jammy # Port, na kterém bude spuštěna brána pro podepisování dokumentů. Musí to být stejné jako v souboru 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"]
- Nainstalujte Docker Engine na vašem stroji. Poté vytvořte obraz dockeru pomocí následujícího příkazu:
docker build -t document_signing_gateway:1.0.0 .
- Spusťte kontejner pomocí následujícího příkazu. Vytváří také objem pro docker signing gateway API log soubor a také mapování portů.
docker run -it -p 8081:8081 -v document_signing_gateway_logs:/logs document_signing_gateway:1.0.0
- Získejte přístup k rozhraní API brány pro podepisování dokumentů pomocí aplikace nebo nástroje POSTMAN.