Les Passerelle de signature de documents eSigner L'API est distribuée sous forme d'image Docker et installée chez le client. Il effectue les actions suivantes :
- L'application envoie le document PDF non signé à l'API de la passerelle de signature de documents
- L'application de passerelle de signature de documents calcule le hachage PDF et l'envoie à l'API eSigner CSC pour la signature du hachage.
- Le hachage signé est ensuite intégré dans le document PDF dans le cadre de l'opération de signature du document PDF.
- Le document PDF signé est horodaté à l'aide de SSL.com TSA
- La révocation basée sur la CRL de la chaîne de certificats est récupérée et intégrée dans le document PDF pour le rendre compatible LTV.
Exigences
Demander:-
URL : - /v1/pdf/eseal
Un jeton d'accès valide est requis pour accéder à l'API. Un guide sur la façon de récupérer le jeton d'accès peut être trouvé dans cet article : Signature de documents à distance avec l'API eSigner CSC
{ "credential_id": "db1653b7-6135-4a10-809b-e29a25d3bb7b", "page_number": 0, "signing_reason": "", "signing_location": "", "contact_Info": "", "sig_field_position":{ " x": 160, "y":245, "largeur":250, "hauteur": 150 }, "hand_signature": " ", "pdf": "" }
Légende:
- identifiant_identifiant – ID d’identification obligatoire du certificat eSeal. Pour savoir comment identifier l'identifiant de votre certificat, veuillez vous référer à ce guide : https://www.ssl.com/guide/esigner-signing-credential-guide/#ftoc-heading-2
- numéro de page – Uniquement requis pour les signatures visibles. Ça commence par 0
- signature_raison – Raison de signature facultative
- emplacement_signature – Emplacement de signature facultatif
- Informations de contact – Coordonnées facultatives
- sig_field_position – x, y, largeur et hauteur de la position du champ de signature. Il n'est requis que pour les signatures visibles
- signature_main – Image de signature manuelle PNG codée en base64. Il n'est requis que pour les signatures visibles et pour ajouter une signature manuscrite dans le cadre de l'apparence de la signature.
- pdf – Document PDF encodé en Base64 à signer
Réponse:-
{ "signed_pdf": "" }
- signé_pdf – Document PDF signé encodé en Base64 et compatible LTV
instructions d'installation
- Décompressez la version de la passerelle de signature de documents
- Ouvrez les fichiers application.properties et modifiez-les en conséquence
# Pour les tests sandbox, définissez le CSR URL vers https://cs-try.ssl.com et pour la production, définissez-la sur https://cs.ssl.com csc.url=https://cs-try.ssl.com # URL de SSL.com TSA tsa.url=http://ts.ssl.com # Port dans le conteneur Docker server.port=8081 # TLS paramètres du certificat du serveur. On peut utiliser un certificat auto-signé ou privé PKI ou publique PKI certificat server.ssl.enabled=true server.ssl.key-store : ./server.jks server.ssl.key-password : secret server.ssl.key-store-password : secret
-
Ouvrez le fichier Docker
FROM Eclipse-temurin:17.0.9_9-jdk-jammy # Port sur lequel la passerelle de signature de documents sera exécutée. Cela doit être le même que dans le fichier 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"]
- Installer le moteur Docker sur votre machine. Ensuite, créez l'image Docker à l'aide de la commande suivante :
docker build -t document_signing_gateway:1.0.0 .
- Exécutez le conteneur à l'aide de la commande suivante. Cela crée également du volume pour Fichier journal de l'API de la passerelle de signature Docker et mappage des ports également.
docker run -it -p 8081:8081 -v document_signing_gateway_logs:/logs document_signing_gateway:1.0.0
- Accédez à l'API de la passerelle de signature de documents à l'aide d'une application ou de l'outil POSTMAN.
