Apparence et placement de la signature ou du cachet PDF

Click&Cert : Apparence et placement de la signature ou du cachet PDF, avec Identity+ et Enterprise+.

Click&Cert permet d’intégrer un certificat Cloud durable Identity+ (QCP-n-QSCD) pour la signature qualifiée d’une personne physique, ou Enterprise+ pour le cachet qualifié d’une organisation. Avec Identity+, l’application cliente recueille le TOTP du signataire et le transmet selon la route utilisée. Présentation et intégration dans un parapheur.

Une signature ou un cachet peut être cryptographiquement valide sans représentation visible sur la page. L’apparence sert à informer le lecteur ; elle ne remplace pas le contrôle de signature du PDF.

Objet v1 visible_signature

{
  "enabled": true,
  "type": "box",
  "page": -1,
  "x": 36,
  "y": 36,
  "width": 180,
  "height": 60,
  "signing_reason": "Document émis par l’organisation",
  "logo_opacity": 0.3
}

Ajoutez cet objet sous la clé visible_signature d’une requête PAdES document v1. Il ne s’agit pas d’un endpoint autonome.

Coordonnées et dimensions

ParamètreRègle
enabledActive l’apparence ; absent ou faux : pas d’apparence visible demandée
typebox ou inline
pageNuméro à partir de 1 ; -1 désigne la dernière page
x, yCoordonnées en points PDF, depuis l’origine inférieure gauche ; valeurs positives ou nulles
width, heightDimensions en points, au moins 1 ; rectangle contenu dans la page
logoImage PNG/JPEG encodée en Base64, facultative
signing_reasonTexte visible facultatif, 100 caractères maximum
logo_opacityNombre entre 0 et 1

Une unité PDF usuelle vaut 1/72 de pouce. Les pages recadrées ou tournées nécessitent une recette visuelle avec le document réel. Le moteur vérifie que le rectangle tient dans les limites de la page ; une géométrie invalide est refusée.

Les valeurs par défaut du placement sont page 1, x=36, y=36, largeur 180 et hauteur 60. Pour un rendu inline, les dimensions omises peuvent suivre les dimensions propres à ce style ; transmettez des valeurs explicites si votre modèle dépend d’un placement précis.

Logo et contenu visible

Le logo personnalisé et le logo d’abonnement sont exploités selon le style de rendu. Le style box permet notamment la personnalisation par logo et texte. L’API limite la longueur du champ Base64 du logo à 2 097 152 caractères ; ce nombre n’est pas une garantie de taille binaire après décodage.

Préparez une image lisible et légère, sans informations sensibles inutiles. Contrôlez le contraste et le chevauchement avec le texte du document. N’utilisez pas l’apparence comme seule indication de validité dans votre interface.

Compatibilité legacy

L’ancienne API multipart utilise visible_seal et impose d’autres règles : x, y, page et type sont requis lorsqu’un objet de placement est fourni ; largeur et hauteur ont des bornes spécifiques. Les noms des niveaux de certification PDF diffèrent aussi. Correspondance complète.


Did this page help you?