L’emplacement réservé à une signature
Réserver sur la page l’endroit où une signature électronique viendra se poser, avec son nom et son encadrement.
Le résultat dans un vrai PDF
Un contrat reçu, complété sans déplacer un octet
Un contrat de maintenance reçu d’un tiers. Sur sa dernière page s’ajoutent un emplacement de signature, une date et une ligne de texte ; après elle, une annexe ; sur l’emplacement de signature, un espace vide où signer. Chaque octet du contrat reste à sa place.
Ouvrir le PDF Voir l’exemple complet
Également dans les exemples : Un contrat de prestation de deux pages · Un formulaire interactif
Résumé
Au bas d’un contrat, une place nommée est réservée et encadrée, prête pour le sceau qui viendra s’y poser plus tard. Cette place est tout ce que cet élément dessine, et c’est déjà ce qu’un expéditeur cherche le plus souvent : un contrat prêt à signer, envoyé à un client qui le scelle avec le logiciel dont il se sert tous les jours. Sceller est l’étape d’après, et ce qu’une signature prouve — de même que la question de savoir qui détient la clé de signature qui la fabrique — a une page à part.
Techniquement
Demandé avec
"type": "signature_field"
Le champ est un champ /FT /Sig vide et son annotation /Widget, nommé, sa valeur laissée à qui signera, posé par-dessus ce que les autres éléments ont dessiné. Le dictionnaire du formulaire contient /SigFlags réglé sur SignaturesExist, ce par quoi un logiciel de lecture annonce un document qui réserve une place à signer, et le rendu dessine du widget ce que la bordure demande. La requête donne son nom, son rectangle et les réglages communs à tous les champs ; le certificat, l’horodatage et l’apparence signée arrivent dans le fichier ensuite, posés par ce qui le scelle.
Schéma de la requête
Clés obligatoires : name, une chaîne ; rect. Facultatives : locks, ce que la signature fige : fields, valant soit all, tous les champs du formulaire et la valeur par défaut, soit un ensemble de noms écrit {"only": […]} ou {"all_but": […]} ; et permits, ce qui reste permis une fois la signature posée, valant no_changes, form_filling (le formulaire peut encore être rempli) ou annotating, entrée arrivée avec le PDF 2.0 et qui demande donc "version": "2.0". Facultatives communes à tous les champs : read_only, required, no_export, booléens à false ; background, la couleur derrière lui ; border, un objet avec un width obligatoire, une color (noir par défaut, donnée en lumière) et un style parmi "solid" (par défaut), {"dashed": {"lengths": …}}, "beveled", "inset" ou "underline" ; tooltip et description, des chaînes, absentes n’écrivant aucune entrée de ce genre ; mapping_name, une chaîne, le nom sous lequel un formulaire envoyé rapporte le champ ; flags, les indicateurs décrits sur la page du champ de saisie, leur absence imprimant le champ sans rien dire d’autre ; triggers, une action par moment, les dix étant énumérés sur la page du champ de saisie ; pages, un tableau d’entiers comptés à partir de 1, vide par défaut ; relative_to. Refus croisé : une couleur CMJN ou d’un espace nommé dans border.color. seeds, un objet, dit ce que le champ demande à qui le signe, chaque entrée écrite {"value": …, "constraint": …}, constraint valant required, à respecter faute de quoi rien n’est signé, ou optional, la valeur par défaut, à suivre quand c’est possible : filter, le module de signature, sous le nom qu’il a déposé ; sub_filters, les encodages, le premier acceptable d’abord, parmi adbe_pkcs7_detached et etsi_cades_detached ; digest_methods, parmi sha256, sha384, sha512 et les quatre de l’ISO/TS 32001, sha3_256, sha3_384, sha3_512 et shake256, qui écrivent le document en PDF 2.0 avec cette extension déclarée ; reasons, les motifs de signature proposés ; legal_attestations, les attestations légales proposées ; revocation_info, true quand le signataire vérifie la révocation de ses certificats et joint ce qu’il a trouvé ; lock_document, lock, leave ou choose, si la fenêtre de signature verrouille le document, PDF 2.0 ; appearance_filter, le nom de l’apparence avec laquelle signer, PDF 2.0 ; timestamp, l’adresse du serveur auquel un horodatage est demandé ; certificate, les conditions que doit remplir le certificat de signature, dont les entrées s’écrivent de la même façon : subject_names, des ensembles d’attributs que le titulaire doit avoir, désignés par leur nom court, comme CN et O, key_usages, chaque usage accepté, avec les bits qu’il exige (required) et ceux qu’il interdit (forbidden), choisis parmi digital_signature, non_repudiation, key_encipherment, data_encipherment, key_agreement, key_cert_sign, crl_sign, encipher_only et decipher_only, puis url, l’adresse vers laquelle est renvoyé le signataire qui n’a aucun certificat de ce type, accompagnée de url_type. À côté d’elles, kind ne prend pas de contrainte : "approval", une signature qui ne certifie rien, ou {"certifies": …}, une certification qui permet ce que dit l’un des mots de permits. Chaque champ prend aussi mark, l’étiquette sous laquelle l’arbre de structure le réclame, par les annotations d’un nœud.
Une requête entière qui crée un PDF
{
"version": "2.0",
"items": [
{
"type": "signature_field",
"name": "signature",
"locks": { "fields": "all", "permits": "no_changes" },
"rect": {"llx": 72, "lly": 120, "urx": 272, "ury": 180},
"border": {"width": 0.75}
}
]
}
Champs de formulaire
Un champ que le lecteur remplit Une case que le lecteur coche Une liste dans laquelle le lecteur choisit Plusieurs boutons, une seule réponse Un bouton sur lequel le lecteur appuie
Où aller ensuite
Toutes les clés JSON d’une requête, en une page Les vingt-deux autres choses que l’on peut dessiner