Signer plusieurs hachages dans Postman avec un seul jeu de données d’activation de signature
Ce guide utilise la méthode d’authentification par flux d’informations d’identification client. Il explique quels appels d’API doivent être exécutés et le nombre d’exécutions nécessaires pour signer plusieurs hachages avec un jeu SAD (Signature Activation Data).
Note
Dans cette méthode, vous devez précalculer le nombre de hachages souhaité en exécutant les appels d’API « 3 - PDF Service : Enregistrer document » et « 4 – PDF Service Créer hachage » avant d’exécuter « 6 - DTM : Étendre transaction » et « 7 - DTM : Signatures CSC Signer hachage ».
La signature dans la réponse « 7 - DTM : Signatures CSC Signer hachage » correspond à l’ordre dans lequel les hachages sont envoyés dans la requête d’appel d’API.
Vous pouvez exécuter l’appel d’API « 8 - PDF Service : Incorporer signature » de façon répétée jusqu’à 200 fois par cycle pour incorporer des signatures dans des documents.
Pour signer un hachage, exécutez les appels d’API individuels ci-dessous :
Note
Le jeton d’accès est valide pendant une heure, mais DigiCert® peut le prolonger jusqu’à 24 heures.
Dans la fenêtre Postman, sélectionnez Collections (Collections) dans le menu de gauche > PDF Service 2.0 > DTM CSC Credential List (Liste des informations d’identification DTM CSC).
Dans la fenêtre de droite, basculez sur l’onglet Authorization (Autorisation).
Sélectionnez Get New Access Token (Obtenir un nouveau jeton d’accès).
Dans la nouvelle fenêtre contextuelle, sélectionnez Continue (Continuer).
Pour appliquer le jeton d’accès, sélectionnez Use Token (Utiliser le jeton).
Pour obtenir la liste des informations d’identification (certificats) stockées dans votre compte DigiCert ONE :
Ouvrez la collection PDFService-2-0-SealSign CADES - Flux Jeton API - Signatures visibles.
Sélectionnez 1 - Liste Informations d’identification DTM CSC > Envoyer.
Les ID des informations d’identification DigiCert ONE (certificats) utilisés sont affichés dans le corps de la requête.
Pour obtenir un aperçu des fonctions utilisées dans DigiCert ONE :
Sélectionnez 2 - Informations d’identification DTM CSC > Envoyer.
Vous pouvez voir les fonctions utilisées dans DigiCert ONE.
Pour enregistrer un document :
Sélectionnez 3 - PDF Service : Enregistrer document.
Configurez la valeur de la variable « tsa_url » en saisissant l’URL de l’autorité d’horodatage que vous utiliserez pour signer les documents.
Sélectionnez Envoyer.
Pour modifier l’apparence de la signature, utilisez les configurations ci-dessous :
Configuration | Description |
|---|---|
type (facultatif) | En fonction du type défini, vous pouvez créer un document MDP (modification, détection et prévention) certifié. La valeur par défaut est « Non certifié » et représentée par une coche verte. La valeur « Certifié » est représentée par un ruban et un cachet. Exemples : NOT_CERTIFIED CERTIFIED_NO_CHANGES_ALLOWED CERTIFIED_FORM_FILLING CERTIFIED_FORM_FILLING_AND_ANNOTATIONS |
preservation_size (facultatif) | Saisissez la taille de préservation de l’espace d’incorporation de la signature en octets. La valeur doit être un multiple de 1024. (Format : int32). |
signature_rectangle (facultatif) | Définissez la position et la taille de l’annotation de la signature numérique. La valeur par défaut est une signature invisible. La position est définie par quatre valeurs pour le coin inférieur gauche (x,y) et les dimensions (l, h) du rectangle. Les unités sont des points PDF (1 point = 1/72 pouce, A4 = 595 x 842 points, lettre = 612 x 792 points, 1 cm = 28,3465 points) mesurés à partir du coin inférieur gauche de la page. Si la largeur ou la hauteur est égale à zéro ou négative, une signature invisible est créée, c.-à-d. que la signature est créée sans aucune apparence visuelle. (Format : int32). page : Saisissez la page sur laquelle la signature doit être ajoutée. x : Saisissez la valeur x du coin inférieur gauche. y : Saisissez la valeur y du coin inférieur gauche. l : Saisissez la largeur du rectangle. h : Saisissez la hauteur du rectangle. |
signature_text1 (facultatif) | Saisissez un texte de signature spécifique à la place du texte standard. (Exemple : nom du signataire). |
motif (facultatif) | Saisissez un motif. |
contact (facultatif) | Saisissez un contact. |
font_text1 (facultatif) | Saisissez le nom de la police. |
font_size_text1 (facultatif) | Saisissez la taille de la police du texte de signature 1. Si l’attribut est absent, la valeur 16pt est utilisée par défaut. (Format : int32). |
signature_text2 (facultatif) | Saisissez un texte de signature spécifique à la place du texte standard. (Exemple : nom du signataire, motif et/ou heure de la signature). |
font_text2 (facultatif) | Saisissez le nom de la police. |
font_size_text2 (facultatif) | Saisissez la taille de la police du texte de signature 2. Si l’attribut est absent, la valeur 8pt est utilisée par défaut. (Format : int32). |
signature_fill_color (facultatif) | Saisissez la couleur d’arrière-plan sous forme de valeur RVB. La valeur par défaut est 16761024 (rouge = 192, vert = 192, bleu = 255). La valeur des couleurs est calculée comme suit : couleur rouge + vert * 256 + bleu * 256 * 256. Pour laisser le rectangle transparent, définissez la valeur sur -1. (Format : int32). |
signature_stroke_color (facultatif) | Saisissez la couleur de la ligne de bordure de la signature sous forme de valeur RVB. La valeur par défaut est 8405056 (rouge = 64, vert = 64, bleu = 128). La valeur des couleurs est calculée comme suit : couleur rouge + vert * 256 + bleu * 256 * 256. Pour laisser la bordure transparente, définissez la valeur sur -1. (Format : int32). |
signature_line_width (facultatif) | Saisissez l’épaisseur de la ligne encadrant la signature visuelle en points. (Format : int32). |
background_image (facultatif) | Insérez l’image à incorporer dans le champ de signature. (encodée en base 64). (Exemple : « dGVzdA== »). |
Pour créer un hachage :
Joignez un document.
Sélectionnez 4 - PDF Service : Créer hachage > Envoyer.
Répétez l’étape 3. Enregistrer un document et l’étape 4. Créer un hachage de manière consécutive jusqu’à ce que vous ayez atteint le nombre de hachages que vous souhaitez calculer.
Vous recevrez les ID de document et leur hachage correspondant.
Astuce
Téléversez différents documents PDF après chaque exécution de l’appel de l’étape 3 « Enregistrer un document » pour calculer les hachages et tester le processus avec différents documents.
Pour générer des données d’activation de signature (SAD) et commencer l’autorisation via l’application Go>Sign Mobile :
Sélectionnez 5 - DTM : Autoriser les informations d’identification CSC > Envoyer.
Accédez à Application Go>Sign Mobile > Demande d’autorisation > Autoriser.
Vous recevrez les données SAD requises pour signer le hachage. Vous en aurez besoin à l’étape « Incorporer la signature ».
Note
Dans l’environnement DigiCert ONE de démonstration, les valeurs par défaut d’une nouvelle autorisation via l’application Go>Sign Mobile sont définies sur « 250 000 hachages ou 30 jours ».
Dans l’environnement DigiCert ONE de production, les valeurs par défaut d’une nouvelle autorisation via l’application Go>Sign Mobile sont définies sur « 1 million de hachages ou 95 jours ».
Pour signer le hachage :
Sélectionnez 7 - DTM : CSC Signatures SignHash > Envoyer.
Vous recevez une signature par hachage envoyé.
Pour signer un nouveau hachage :
Sélectionnez 8 - PDF Service : Incorporer signature.
Les données SAD créées à l’étape « Autoriser les informations d’identification » seront automatiquement mises à jour.
Sélectionnez Envoyer.
Répétez cette étape pour chaque signature individuelle en respectant l’ordre dans lequel vous les avez reçues en exécutant « 4 - PDF Service : Créer hachage ».
Pour télécharger le PDF et vérifier la validité de la signature :
Sélectionnez Enregistrer en tant qu’exemple (en bas à droite) > Enregistrer la réponse sur fichier.