Połączenia Bramka do podpisywania dokumentów eSigner API jest dystrybuowane jako obraz dokera i instalowane u klienta. Wykonuje następujące czynności:
- Aplikacja wysyła niepodpisany dokument PDF do interfejsu API bramy podpisywania dokumentów
- Aplikacja bramki do podpisywania dokumentów oblicza skrót pliku PDF i wysyła go do interfejsu API eSigner CSC w celu podpisania skrótu
- Podpisany skrót jest następnie osadzany w dokumencie PDF w ramach operacji podpisywania dokumentu PDF
- Podpisany dokument PDF jest oznaczony znacznikiem czasu za pomocą SSL.com TSA
- Odwołanie łańcucha certyfikatów w oparciu o listę CRL jest pobierane i osadzane w dokumencie PDF, aby umożliwić włączenie funkcji LTV
wymagania
Wniosek:-
Adres URL:- /v1/pdf/eseal
Aby uzyskać dostęp do interfejsu API, wymagany jest ważny token dostępu. Poradnik dotyczący odzyskania tokenu dostępu można znaleźć w tym artykule: Zdalne podpisywanie dokumentów za pomocą 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, "szerokość": 250, "wysokość": 150 }, "podpis_ręczny": " ", "pdf": "" }
Legenda:
- identyfikator_poświadczenia – Obowiązkowy identyfikator uwierzytelniający certyfikatu eSeal. Aby dowiedzieć się, jak zidentyfikować identyfikator uwierzytelniający certyfikatu, zapoznaj się z tym przewodnikiem: https://www.ssl.com/guide/esigner-signing-credential-guide/#ftoc-heading-2
- numer strony – Wymagane tylko w przypadku widocznych podpisów. Zaczyna się od 0
- powód_podpisania – Opcjonalny powód podpisania
- lokalizacja_podpisywania – Opcjonalna lokalizacja podpisu
- informacje kontaktowe – Opcjonalne dane kontaktowe
- pozycja_pola sig – x, y, szerokość i wysokość położenia pola podpisu. Jest to wymagane tylko w przypadku podpisów widocznych
- podpis_ręczny – Obraz podpisu ręcznego w formacie PNG zakodowany w formacie Base64. Jest to wymagane tylko w przypadku podpisów widocznych i dodania podpisu ręcznego w ramach wyglądu podpisu
- pdf – Dokument PDF zakodowany w formacie Base64 do podpisania
Odpowiedź:-
{ "podpisany_pdf": "" }
- podpisany_pdf – Dokument PDF z podpisem i kodowaniem Base64, z obsługą LTV
Instrukcja instalacji
- Rozpakuj wersję bramy podpisywania dokumentów
- Otwórz pliki application.properties i odpowiednio je zmień
# Do testowania w piaskownicy ustaw CSR Adres URL do https://cs-try.ssl.com i dla produkcji ustaw go na https://cs.ssl.com csc.url=https://cs-try.ssl.com # Adres URL SSL.com TSA tsa.url=http://ts.ssl.com # Port w kontenerze dokowanym server.port=8081 # TLS ustawienia certyfikatu serwera. Można użyć certyfikatu z podpisem własnym lub prywatnego PKI lub publiczne PKI certyfikat server.ssl.enabled=true server.ssl.key-store: ./server.jks server.ssl.key-password: tajne serwer.ssl.key-store-password: tajne
-
Otwórz plik Docker
Z Eclipse-temurin:17.0.9_9-jdk-jammy # Port, na którym będzie uruchomiona bramka do podpisywania dokumentów. Musi być taki sam jak w pliku 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"]
- Zainstaluj silnik Dockera na Twojej maszynie. Następnie zbuduj obraz okna dokowanego za pomocą następującego polecenia:
docker build -t document_signing_gateway:1.0.0 .
- Uruchom kontener za pomocą następującego polecenia. Tworzy również objętość plik dziennika API bramy podpisywania platformy dokowanej i mapowanie portów.
docker run -it -p 8081:8081 -v document_signing_gateway_logs:/logs document_signing_gateway:1.0.0
- Uzyskaj dostęp do interfejsu API bramy podpisywania dokumentów za pomocą aplikacji lub narzędzia POSTMAN.
