Skip to main content

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 :

  1. Ouvrez la collection PDFService-2-0-SealSign CADES - Flux Jeton API - Signatures visibles.

  2. 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.

PDF document

To register a PDF document:

  1. Select 3 - Content Signing Service: Register Document.

  2. Configure "tsa_url" variable value by entering the URL of the timestamp authority you use to sign documents.

  3. Select Send.

To change signature appearance, use the following configurations:

Configuration

Description

type (optional)

Depending on the type, you’re able to create a certified MDP (document modification detection and prevention) document. Default isn’t certified and shows a green tick. Certified shows a ribbon with a seal.

Examples:

NOT_CERTIFIED

CERTIFIED_NO_CHANGES_ALLOWED

CERTIFIED_FORM_FILLING

CERTIFIED_FORM_FILLING_AND_ANNOTATIONS

preservation_size (optional)

Enter preservation size of the space for embedding the signature in bytes. Value should be a multiple of 1024. (Format: int32).

signature_rectangle (optional)

Set the position and size of the digital signature annotation. The default is an invisible signature. The position is defined by four values for the lower-left corner (x, y) and dimensions (w, h) of the rectangle. The units are document points (1 point = 1/72 inch, A4 = 595 x 842 points, letter = 612 x 792 points, 1cm = 28.3465 points) measured from the lower left corner of the page. If either the width or height is zero or negative, an invisible signature is created, that is, no visible appearance is created for the signature.

(Format: int32).

page: Enter page on which the signature is added.

x: Enter x value of lower-left corner.

y: Enter y value of lower-left corner.

w: Enter width dimension of rectangle.

h: Enter height dimension of rectangle.

signature_text1 (optional)

Enter specific signature text instead of standard. (Example: signer's name).

reason (optional)

Enter reason.

contact (optional)

Enter contact.

font_text1 (optional)

Enter name of the font.

font_size_text1 (optional)

Enter font size of signature text 1. If attribute isn’t present default of 16pt is used. (Format: int32).

signature_text2 (optional)

Enter specific signature text instead of standard. (Example: signer’s name, reason and/or signing time).

font_text2 (optional)

Enter name of the font.

font_size_text2 (optional)

Enter font size of signature text 2. If attribute isn’t present default of 8pt is used. (Format: int32).

signature_fill_color (optional)

Enter background color in RGB. The default is 16761024 (red = 192, green = 192, blue = 255).

Color value is calculated as follows:

color red + green * 256 + blue * 256 * 256. To keep the rectangle transparent, set the value to -1. (Format: int32).

signature_stroke_color (optional)

Enter the color of the signature’s border line as RGB value. The default is 8405056 (red = 64, green = 64, blue = 128).

Color value is calculated as follows:

color red + green * 256 + blue * 256 * 256. To keep it transparent, set the value to -1. (Format: int32).

signature_line_width (optional)

Enter the thickness of the line surrounding the visual signature in points. (Format: int32).

background_image (optional)

Insert the image to be embedded in the signature field. (Base64 encoded). (Example: "dGVzdA==”).

XML document

To register an XML document:

  1. Select 3 - Content Signing Service: Register Document.

  2. Configure "tsa_url" variable value by entering the URL of the timestamp authority you use to sign documents.

  3. Select Send.

Use the following configurations:

Configuration

Description

canonicalization_method

Enter the canonicalization method for XML signing.

Examples:

INCLUSIVE or EXCLUSIVE

signature_type

Enter signature type of the XML document to be signed.

Examples:

XAdES.enveloped/  or XAdES.enveloping

Pour créer un hachage :

  1. Joignez un document.

  2. 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 :

  1. Sélectionnez 5 - DTM : Autoriser les informations d’identification CSC > Envoyer.

  2. 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 :

  1. Sélectionnez 8 - PDF Service : Incorporer signature.

  2. Les données SAD créées à l’étape « Autoriser les informations d’identification » seront automatiquement mises à jour.

  3. 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 :

  1. Sélectionnez Enregistrer en tant qu’exemple (en bas à droite) > Enregistrer la réponse sur fichier.

  2. 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.

Et ensuite ?

Signer des PDF consécutifs