Signer des hachages de PDF lors de la première exécution des appels d’API
Pour signer un hachage, exécutez les appels d’API individuels ci-dessous :
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.
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 d’incorporation de 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.
Dans le corps de la requête, vous recevrez une signature valide à incorporer au document.
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.
Vous recevrez votre document avec la signature incorporée.
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.
Ouvrez le PDF dans Adobe Acrobat Reader pour vérifier la validité de la signature.
Note
Les PDF créés dans l’environnement DigiCert ONE de démonstration afficheront une signature non valide parce que le certificat utilisé est un certificat de démonstration non fiable. Vous pouvez toutefois classer le certificat racine comme fiable dans Adobe Acrobat Reader pour afficher une coche verte.