Sản phẩm Cổng ký tài liệu eSigner API phân phối dưới dạng hình ảnh docker và cài đặt tại cơ sở của khách hàng. Nó thực hiện các hành động sau:
- Ứng dụng gửi tài liệu PDF chưa được ký tới API cổng ký tài liệu
- Ứng dụng cổng ký tài liệu tính toán hàm băm PDF và gửi tới API CSC eSigner để ký băm
- Sau đó, hàm băm đã ký được nhúng vào bên trong tài liệu PDF như một phần của hoạt động ký tài liệu PDF
- Tài liệu PDF đã ký được đánh dấu thời gian bằng cách sử dụng SSL.com TSA
- Việc thu hồi chuỗi chứng chỉ dựa trên CRL được tìm nạp và nhúng bên trong tài liệu PDF để kích hoạt LTV
Yêu cầu
Yêu cầu:-
URL:- /v1/pdf/eseal Cần có mã thông báo truy cập hợp lệ để truy cập API. Bạn có thể tìm thấy hướng dẫn về cách lấy Access Token trong bài viết này: Ký tài liệu từ xa với 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": "" }
Chú thích:
- thông tin xác thực_id – ID thông tin bắt buộc của chứng chỉ eSeal. Để biết cách xác định ID thông tin xác thực của chứng chỉ của bạn, vui lòng tham khảo hướng dẫn này: https://www.ssl.com/guide/esigner-signing-credential-guide/#ftoc-heading-2
- số trang – Chỉ yêu cầu đối với chữ ký có thể nhìn thấy được. Nó bắt đầu bằng 0
- ký_lý do – Lý do ký tùy chọn
- ký_location – Vị trí ký tùy chọn
- thông tin liên lạc – Thông tin liên hệ tùy chọn
- sig_field_position – x, y, chiều rộng và chiều cao của vị trí trường chữ ký. Nó chỉ được yêu cầu cho chữ ký có thể nhìn thấy
- chữ ký tay – Hình ảnh chữ ký tay PNG được mã hóa Base64. Nó chỉ được yêu cầu đối với chữ ký hiển thị và thêm chữ ký tay như một phần của hình thức chữ ký
- pdf – Tài liệu PDF được mã hóa Base64 để ký
Phản ứng:-
{ "đã ký_pdf": "" }
- đã ký_pdf – Tài liệu PDF hỗ trợ LTV được mã hóa Base64
Hướng dẫn cài đặt
- Giải nén bản phát hành cổng ký tài liệu
- Mở tệp application.properties và thay đổi tương ứng
# Để kiểm tra hộp cát, hãy đặt CSR URL tới https://cs-try.ssl.com và để sản xuất, đặt nó thành https://cs.ssl.com csc.url=https://cs-try.ssl.com # URL của SSL.com TSA tsa.url=http://ts.ssl.com # Cổng trong docker container server.port=8081 # TLS cài đặt chứng chỉ máy chủ. Người ta có thể sử dụng chứng chỉ tự ký hoặc riêng tư PKI hoặc công khai PKI chứng chỉ server.ssl.enabled=true server.ssl.key-store: ./server.jks server.ssl.key-password: máy chủ bí mật.ssl.key-store-password: bí mật
-
Mở tệp Docker
TỪ Eclipse-temurin:17.0.9_9-jdk-jammy # Cổng mà cổng ký tài liệu sẽ chạy. Điều này phải giống như trong tệp 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"]
- Cài đặt Docker Engine trên máy của bạn. Sau đó, xây dựng hình ảnh docker bằng lệnh sau:
docker build -t document_signing_gateway:1.0.0 .
- Chạy vùng chứa bằng lệnh sau. Nó cũng tạo ra khối lượng cho docker ký tệp nhật ký API cổng và ánh xạ cổng.
docker run -it -p 8081:8081 -v document_signing_gateway_logs:/logs document_signing_gateway:1.0.0
- Truy cập API cổng ký tài liệu bằng ứng dụng hoặc công cụ POSTMAN.
