- Шлюз за подписване на документи eSigner API се разпространява като докер изображение и се инсталира на място на клиента. Той изпълнява следните действия:
- Приложението изпраща неподписания PDF документ към API на шлюза за подписване на документи
- Приложението за шлюз за подписване на документи изчислява PDF хеша и го изпраща към eSigner CSC API за хеш подписване
- След това подписаният хеш се вгражда в PDF документа като част от операцията за подписване на PDF документ
- Подписаният PDF документ е маркиран с дата и час с помощта на SSL.com TSA
- Базираното на CRL анулиране на веригата от сертификати се извлича и вгражда в PDF документа, за да се активира LTV
Изисквания
Заявка: -
URL:- /v1/pdf/eseal За достъп до API е необходим валиден токен за достъп. Ръководство за това как да извлечете токена за достъп можете да намерите в тази статия: Отдалечено подписване на документи с 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": "" }
Legend:
- credential_id – Задължителен идентификационен номер на сертификата eSeal. За да разберете как да идентифицирате идентификационния номер на вашия сертификат, моля, вижте това ръководство: https://www.ssl.com/guide/esigner-signing-credential-guide/#ftoc-heading-2
- номер на страницата – Изисква се само за видими подписи. Започва с 0
- подписване_причина – Незадължителна причина за подписване
- местоположение_за_подписване – Незадължително място за подписване
- Информация за контакт – Незадължителна информация за контакт
- sig_field_position – x, y, ширина и височина на позицията на полето за подпис. Изисква се само за видими подписи
- собствен_подпис – Кодирано в Base64 PNG изображение на ръчен подпис. Изисква се само за видими подписи и за добавяне на ръчен подпис като част от външния вид на подписа
- PDF – Base64 кодиран PDF документ за подписване
Отговор: -
{ "подписан_pdf": "" }
- signed_pdf – Base64 кодиран подписан LTV активиран PDF документ
Инструкции за инсталиране
- Разархивирайте изданието на шлюза за подписване на документи
- Отворете файловете application.properties и променете съответно
# За тестване в пясъчник, задайте CSR URL към https://cs-try.ssl.com и за производство го задайте на https://cs.ssl.com csc.url=https://cs-try.ssl.com # URL на SSL.com TSA tsa.url=http://ts.ssl.com # Порт в докер контейнер server.port=8081 # TLS настройки на сървърния сертификат. Човек може да използва самоподписан сертификат или частен PKI или публичен PKI сертификат server.ssl.enabled=true server.ssl.key-store: ./server.jks server.ssl.key-password: тайна server.ssl.key-store-password: секретна
-
Отворете Dockerfile
ОТ eclipse-temurin:17.0.9_9-jdk-jammy # Порт, на който ще работи шлюзът за подписване на документи. Това трябва да е същото като във файла 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"]
- Инсталирайте Docker Engine на вашата машина. След това изградете докер изображението, като използвате следната команда:
docker build -t document_signing_gateway:1.0.0.
- Стартирайте контейнера, като използвате следната команда. Създава и обем за докер подписващ шлюз API регистрационен файл и картографиране на портове също.
docker run -it -p 8081:8081 -v document_signing_gateway_logs:/logs document_signing_gateway:1.0.0
- Осъществете достъп до API на шлюза за подписване на документи, като използвате приложение или инструмент POSTMAN.