Guide de la passerelle de signature de documents eSigner

La 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

  1. Décompressez la version de la passerelle de signature de documents
  2. 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
  3. 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"]
  4. 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 .
  5. 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
  6. Accédez à l'API de la passerelle de signature de documents à l'aide d'une application ou de l'outil POSTMAN.

Abonnez-vous à la newsletter de SSL.com

Ne manquez pas les nouveaux articles et mises à jour de SSL.com

Restez informé et en sécurité

SSL.com est un leader mondial de la cybersécurité, PKI et les certificats numériques. Inscrivez-vous pour recevoir les dernières nouvelles de l'industrie, des conseils et des annonces de produits de SSL.com.

Nous aimerions recevoir vos commentaires

Répondez à notre enquête et faites-nous part de votre avis sur votre récent achat.