The eSigner belge imzalama ağ geçidi API, liman işçisi görüntüsü olarak dağıtılır ve müşterinin tesisine yüklenir. Aşağıdaki eylemleri gerçekleştirir:
- Uygulama imzasız PDF belgesini belge imzalama ağ geçidi API'sine gönderir
- Belge imzalama ağ geçidi uygulaması, PDF karmasını hesaplar ve karma imzalama için eSigner CSC API'sine gönderir
- İmzalanan karma daha sonra PDF belgesi imzalama işleminin bir parçası olarak PDF belgesinin içine gömülür
- İmzalı PDF belgesine zaman damgası uygulanır. SSL.com TSA
- Sertifika zincirinin CRL tabanlı iptali, LTV'yi etkinleştirmek için PDF belgesinin içine getirilir ve gömülür
Yer Alan Kurallar
İstek:-
URL:- /v1/pdf/eseal
API'ye erişmek için geçerli bir erişim belirteci gereklidir. Erişim Belirtecinin nasıl alınacağına ilişkin bir kılavuzu bu makalede bulabilirsiniz: ESigner CSC API ile Uzaktan Belge İmzalama
{ "credential_id": "db1653b7-6135-4a10-809b-e29a25d3bb7b", "page_number": 0, "signing_reason": "", "signing_location": "", "contact_Info": "", "sig_field_position":{ " x": 160, "y":245, "genişlik":250, "yükseklik": 150 }, "hand_signature": " ", "pdf": "" }
Legend:
- kimlik bilgisi_kimliği – eSeal sertifikasının zorunlu kimlik bilgisi. Sertifikanızın kimlik bilgisi kimliğini nasıl tanımlayacağınızı öğrenmek için lütfen bu kılavuza bakın: https://www.ssl.com/guide/esigner-signing-credential-guide/#ftoc-heading-2
- sayfa numarası – Yalnızca görünür imzalar için gereklidir. 0 ile başlıyor
- imzalama_nedeni – İsteğe bağlı imzalama nedeni
- imza_konumu – İsteğe bağlı imzalama yeri
- iletişim bilgileri – İsteğe bağlı iletişim bilgileri
- sig_field_position – x, y, imza alanı konumunun genişliği ve yüksekliği. Yalnızca görünür imzalar için gereklidir
- el_imzası – Base64 kodlu PNG el imza görseli. Yalnızca görünür imzalar için ve imza görünümünün bir parçası olarak el imzası eklemek için gereklidir
- pdf – İmzalanacak Base64 kodlu PDF belgesi
Cevap:-
{ "imzalı_pdf": "" }
- imzalı_pdf – Base64 kodlu imzalı LTV özellikli PDF belgesi
Kurulum Talimatları
- Belge imzalama ağ geçidi sürümünün sıkıştırmasını açın
- Application.properties dosyalarını açın ve buna göre değiştirin
# Korumalı alan testi için CSR URL'yi https://cs-try.ssl.com olarak ayarlayın ve üretim için bunu https://cs.ssl.com olarak ayarlayın csc.url=https://cs-try.ssl.com # SSL.com'un URL'si TSA tsa.url=http://ts.ssl.com # Liman işçisi konteynerindeki bağlantı noktası sunucusu.port=8081 # TLS sunucu sertifikası ayarları. Kendinden imzalı sertifika veya özel sertifika kullanılabilir PKI veya halka açık PKI sertifika sunucusu.ssl.enabled=true server.ssl.key-store: ./server.jks server.ssl.key-password: gizli sunucu.ssl.key-store-password: gizli
-
Docker dosyasını açın
FROM Eclipse-temurin:17.0.9_9-jdk-jammy # Belge imzalama ağ geçidinin çalışacağı bağlantı noktası. Bu, application.properties dosyasındaki ile aynı olmalıdır 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=dosya:/app/application.properties", "-jar", "document_signing_gateway-1.0.0.jar"]
- Docker Engine'i yükleyin makinenizde. Daha sonra aşağıdaki komutu kullanarak docker imajını oluşturun:
docker build -t document_signing_gateway:1.0.0 .
- Aşağıdaki komutu kullanarak kapsayıcıyı çalıştırın. Aynı zamanda hacim yaratır docker imzalama ağ geçidi API günlük dosyası ve bağlantı noktası eşlemesini de içerir.
docker run -it -p 8081:8081 -v document_signing_gateway_logs:/logs document_signing_gateway:1.0.0
- Bir uygulamayı veya POSTMAN aracını kullanarak belge imzalama ağ geçidi API'sine erişin.