Η Πύλη υπογραφής εγγράφων eSigner Το API διανέμεται ως εικόνα docker και εγκαθίσταται στις εγκαταστάσεις του πελάτη. Εκτελεί τις ακόλουθες ενέργειες:
- Η εφαρμογή στέλνει το ανυπόγραφο έγγραφο PDF στο API της πύλης υπογραφής εγγράφων
- Η εφαρμογή πύλης υπογραφής εγγράφων υπολογίζει τον κατακερματισμό PDF και αποστέλλει στο eSigner CSC API για υπογραφή κατακερματισμού
- Στη συνέχεια, ο υπογεγραμμένος κατακερματισμός ενσωματώνεται στο έγγραφο PDF ως μέρος της λειτουργίας υπογραφής εγγράφου PDF
- Το υπογεγραμμένο έγγραφο PDF έχει χρονοσήμανση χρησιμοποιώντας SSL.com TSA
- Η ανάκληση της αλυσίδας πιστοποιητικών βάσει CRL ανακτάται και ενσωματώνεται στο έγγραφο PDF για να ενεργοποιηθεί το LTV
απαιτήσεις
Αίτηση:-
URL: - /v1/pdf/eseal Απαιτείται ένα έγκυρο διακριτικό πρόσβασης για πρόσβαση στο API. Ένας οδηγός σχετικά με τον τρόπο ανάκτησης του Access Token μπορείτε να βρείτε σε αυτό το άρθρο: Απομακρυσμένη υπογραφή εγγράφων με eSigner CSC API{ "credential_id": "db1653b7-6135-4a10-809b-e29a25d3bb7b", "page_number": 0, "signing_reason": "", "signing_location": "", "contact_Info": "", "sig_field" x": 160, "y":245, "width":250, "height": 150 }, "hand_signature": " ", "pdf": "" }
Υπόμνημα:
- credential_id – Υποχρεωτική ταυτότητα διαπιστευτηρίου του πιστοποιητικού eSeal. Για να μάθετε πώς να προσδιορίσετε το αναγνωριστικό διαπιστευτηρίων του πιστοποιητικού σας, ανατρέξτε σε αυτόν τον οδηγό: https://www.ssl.com/guide/esigner-signing-credential-guide/#ftoc-heading-2
- αριθμός σελίδας – Απαιτείται μόνο για εμφανείς υπογραφές. Ξεκινά με 0
- signing_reason – Προαιρετικός λόγος υπογραφής
- signing_location – Προαιρετική θέση υπογραφής
- πληροφορίες επαφής – Προαιρετικά στοιχεία επικοινωνίας
- sig_field_position – x, y, πλάτος και ύψος της θέσης του πεδίου υπογραφής. Απαιτείται μόνο για ορατές υπογραφές
- hand_signature – Εικόνα υπογραφής χεριού με κωδικοποίηση Base64 PNG. Απαιτείται μόνο για ορατές υπογραφές και για προσθήκη υπογραφής στο χέρι ως μέρος της εμφάνισης της υπογραφής
- pdf – Έγγραφο PDF με κωδικοποίηση Base64 για υπογραφή
Απάντηση:-
{ "signed_pdf": "" }
- signed_pdf – Έγγραφο PDF με δυνατότητα κωδικοποίησης Base64 με υπογραφή LTV
Οδηγίες Εγκατάστασης
- Αποσυμπιέστε την έκδοση της πύλης υπογραφής εγγράφου
- Ανοίξτε τα αρχεία application.properties και αλλάξτε ανάλογα
# Για τη δοκιμή του sandbox, ορίστε το 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 # Port in docker container server.port=8081 # TLS ρυθμίσεις πιστοποιητικού διακομιστή. Κάποιος μπορεί να χρησιμοποιήσει αυτο-υπογεγραμμένο πιστοποιητικό ή ιδιωτικό PKI ή δημόσια PKI Certificate server.ssl.enabled=true server.ssl.key-store: ./server.jks server.ssl.key-password: secret server.ssl.key-store-password: μυστικό
-
Ανοίξτε το αρχείο Docker
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 Engine στο μηχάνημά σας. Στη συνέχεια, δημιουργήστε την εικόνα docker χρησιμοποιώντας την ακόλουθη εντολή:
docker build -t document_signing_gateway:1.0.0.
- Εκτελέστε το κοντέινερ χρησιμοποιώντας την ακόλουθη εντολή. Δημιουργεί επίσης όγκο για Docker signing gateway αρχείο καταγραφής API και χαρτογράφηση θυρών επίσης.
docker run -it -p 8081:8081 -v document_signing_gateway_logs:/logs document_signing_gateway:1.0.0
- Αποκτήστε πρόσβαση στο API της πύλης υπογραφής εγγράφων χρησιμοποιώντας μια εφαρμογή ή ένα εργαλείο POSTMAN.
