Ассоциация шлюз для подписи документов eSigner API распространяется в виде образа Docker и устанавливается у клиента. Он выполняет следующие действия:
- Приложение отправляет неподписанный PDF-документ в API шлюза подписи документов.
- Приложение шлюза для подписи документов вычисляет хэш PDF и отправляет его в API eSigner CSC для хэш-подписи.
- Подписанный хеш затем встраивается в документ PDF как часть операции подписания документа PDF.
- Подписанный PDF-документ имеет временную метку с использованием SSL.com TSA
- Отзыв цепочки сертификатов на основе CRL извлекается и встраивается в документ PDF, чтобы включить LTV.
Требования
Запрос:-
URL:-/v1/pdf/seal
Для доступа к 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, "ширина":250, "высота": 150 }, "hand_signature": " ", "pdf": "" }
Легенда:
- credential_id – Обязательный идентификационный номер сертификата eSeal. Чтобы узнать, как определить идентификатор учетных данных вашего сертификата, обратитесь к этому руководству: https://www.ssl.com/guide/esigner-signing-credential-guide/#ftoc-heading-2
- номер страницы – Требуется только для видимых подписей. Он начинается с 0
- подписывание_причина – Необязательная причина подписания
- подпись_местоположение – Дополнительное место для подписания
- Контактная информация – Дополнительная контактная информация
- sig_field_position – x, y, ширина и высота положения поля подписи. Требуется только для видимых подписей.
- рука_подпись – Изображение ручной подписи PNG в кодировке Base64. Это требуется только для видимых подписей и для добавления собственноручной подписи как части внешнего вида подписи.
- PDF – PDF-документ в кодировке Base64 для подписи
Ответ:-
{ "signed_pdf": "" }
- подписанный_pdf – Подписанный PDF-документ с поддержкой LTV в кодировке Base64
Инструкция по установке
- Разархивируйте выпуск шлюза подписи документов.
- Откройте файлы 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: секретный
-
Откройте Докер-файл
FROM 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 на вашей машине. После этого создайте образ Docker, используя следующую команду:
docker build -t document_signing_gateway:1.0.0 .
- Запустите контейнер, используя следующую команду. Это также создает объем для Файл журнала API шлюза подписи Docker, а также сопоставление портов.
docker run -it -p 8081:8081 -v document_signing_gateway_logs:/logs document_signing_gateway:1.0.0
- Получите доступ к API шлюза подписи документов с помощью приложения или инструмента POSTMAN.
