Grafik Gerbang penandatanganan dokumen eSigner API didistribusikan sebagai gambar buruh pelabuhan dan dipasang di lokasi pelanggan. Ia melakukan tindakan berikut:
- Aplikasi mengirimkan dokumen PDF yang tidak ditandatangani ke API gateway penandatanganan dokumen
- Aplikasi gerbang penandatanganan dokumen menghitung hash PDF dan mengirimkannya ke API CSC eSigner untuk penandatanganan hash
- Hash yang ditandatangani kemudian disematkan di dalam dokumen PDF sebagai bagian dari operasi penandatanganan dokumen PDF
- Dokumen PDF yang ditandatangani diberi stempel waktu menggunakan SSL.com TSA
- Pencabutan rantai sertifikat berbasis CRL diambil dan disematkan di dalam dokumen PDF untuk mengaktifkan LTV
Persyaratan
Meminta:-
URL:- /v1/pdf/esal Token akses yang valid diperlukan untuk mengakses API. Panduan tentang cara mengambil Token Akses dapat ditemukan di artikel ini: Penandatanganan Dokumen Jarak Jauh dengan 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, "lebar":250, "tinggi": 150 }, "tanda tangan_tangan": " ", "pdf": "" }
Legenda:
- kredensial_id – ID kredensial wajib dari sertifikat eSeal. Untuk mengetahui cara mengidentifikasi ID kredensial sertifikat Anda, silakan merujuk ke panduan ini: https://www.ssl.com/guide/esigner-signing-credential-guide/#ftoc-heading-2
- nomor halaman – Hanya diperlukan untuk tanda tangan yang terlihat. Ini dimulai dengan 0
- penandatanganan_alasan – Alasan penandatanganan opsional
- penandatanganan_lokasi – Lokasi penandatanganan opsional
- Info kontak – Informasi kontak opsional
- sig_field_position – x, y, lebar dan tinggi posisi bidang tanda tangan. Ini hanya diperlukan untuk tanda tangan yang terlihat
- tanda tangan_tangan – Gambar tanda tangan PNG yang dikodekan Base64. Ini hanya diperlukan untuk tanda tangan yang terlihat dan untuk menambahkan tanda tangan tangan sebagai bagian dari tampilan tanda tangan
- pdf – Dokumen PDF berkode Base64 untuk ditandatangani
Tanggapan:-
{ "signed_pdf": "" }
- ditandatangani_pdf – Dokumen PDF berkemampuan LTV yang ditandatangani dengan kode Base64
Instalasi Instruksi
- Buka zip rilis gateway penandatanganan dokumen
- Buka file application.properties dan ubah sesuai kebutuhan
# Untuk pengujian sandbox, atur CSR URL ke https://cs-try.ssl.com dan untuk produksi setel ke https://cs.ssl.com csc.url=https://cs-try.ssl.com # URL SSL.com TSA tsa.url=http://ts.ssl.com # Port di server kontainer buruh pelabuhan.port=8081 # TLS pengaturan sertifikat server. Seseorang dapat menggunakan sertifikat yang ditandatangani sendiri atau pribadi PKI atau publik PKI sertifikat server.ssl.enabled=true server.ssl.key-store: ./server.jks server.ssl.key-password: server rahasia.ssl.key-store-password: rahasia
-
Buka file Docker
DARI Eclipse-temurin:17.0.9_9-jdk-jammy # Port tempat gateway penandatanganan dokumen akan dijalankan. Ini harus sama seperti di file 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"]
- Instal Mesin Docker di mesin Anda. Setelah itu, buat image buruh pelabuhan menggunakan perintah berikut:
buruh pelabuhan membangun -t document_signing_gateway:1.0.0 .
- Jalankan kontainer menggunakan perintah berikut. Ini juga menciptakan volume untuk file log API gateway penandatanganan buruh pelabuhan dan pemetaan port juga.
menjalankan buruh pelabuhan -it -p 8081:8081 -v document_signing_gateway_logs:/logs document_signing_gateway:1.0.0
- Akses API gateway penandatanganan dokumen menggunakan aplikasi atau alat POSTMAN.