พื้นที่ เกตเวย์การลงนามเอกสาร 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": "" }
คำอธิบาย:
- หนังสือรับรอง_id – รหัสประจำตัวบังคับของใบรับรอง eSeal หากต้องการทราบวิธีระบุรหัสประจำตัวของใบรับรองของคุณ โปรดดูคำแนะนำนี้: https://www.ssl.com/guide/esigner-signing-credential-guide/#ftoc-heading-2
- เลขหน้า – จำเป็นสำหรับลายเซ็นที่มองเห็นได้เท่านั้น มันเริ่มต้นด้วย 0
- การลงนาม_เหตุผล – เหตุผลในการลงนามเพิ่มเติม
- การเซ็นชื่อ_ตำแหน่ง – สถานที่ลงนามเพิ่มเติม
- ข้อมูลติดต่อ – ข้อมูลการติดต่อเพิ่มเติม
- sig_field_position – x, y, ความกว้างและความสูงของตำแหน่งฟิลด์ลายเซ็น จำเป็นสำหรับลายเซ็นที่มองเห็นได้เท่านั้น
- hand_signature – ภาพลายเซ็นมือ PNG ที่เข้ารหัส Base64 จำเป็นสำหรับลายเซ็นที่มองเห็นได้เท่านั้น และเพื่อเพิ่มลายเซ็นมือเป็นส่วนหนึ่งของลักษณะลายเซ็น
- รูปแบบไฟล์ PDF – เอกสาร PDF ที่เข้ารหัส Base64 เพื่อลงนาม
การตอบสนอง:-
{ "signed_pdf": "" }
- signed_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"]
- ติดตั้งเครื่องยนต์นักเทียบท่า บนเครื่องของคุณ หลังจากนั้นให้สร้างอิมเมจนักเทียบท่าโดยใช้คำสั่งต่อไปนี้:
นักเทียบท่า build -t document_signing_gateway:1.0.0
- รันคอนเทนเนอร์โดยใช้คำสั่งต่อไปนี้ อีกทั้งยังสร้างวอลลุ่มให้กับ ไฟล์บันทึก API ของเกตเวย์การลงนามนักเทียบท่าและการแมปพอร์ตเช่นกัน
นักเทียบท่าทำงาน -it -p 8081:8081 -v document_signing_gateway_logs:/logs document_signing_gateway:1.0.0
- เข้าถึง API เกตเวย์การลงนามเอกสารโดยใช้แอปพลิเคชันหรือเครื่องมือ POSTMAN
