JAdES : conteneurs JWS et données JSON

La référence Click&Cert v1 expose JAdES pour la création à partir d’un document et d’un digest. Confirmez l’ouverture et les droits commerciaux de JAdES dans votre commande : les conditions de l’offre Premium ne doivent pas être déduites de la seule présence de ces routes.

Routes et profils

Méthode et chemin	Données envoyées
`POST /api/clickncert/v1/document/jades/sign`	`certificate_uid`, `document_base64` et options
`POST /api/clickncert/v1/digest/jades/sign`	`certificate_uid`, `digest_base64` et référence aux données

Les profils pris en charge sont B-B, B-T et B-LT. Le service documenté utilise sha256, une signature RSA-SHA256 et la sérialisation flattened_json. B-LTA n’est pas pris en charge ici.

Paramètres spécifiques

Champ	Document	Digest
`packaging`	`enveloping` par défaut ou `detached`	`detached` uniquement
`serialization`	`flattened_json`	`flattened_json`
`content_type`	Type du contenu porté par le résultat, facultatif	Type du contenu référencé, facultatif
`filename`	Nom métier facultatif	Obligatoire si `reference_uri` absent
`reference_uri`	Référence utile pour le mode détaché	Obligatoire si `filename` absent

L’API document reçoit les octets en Base64 ; elle ne reçoit pas directement un objet JSON comme charge utile à signer. Si votre document métier est JSON, fixez son encodage et sa sérialisation avant de calculer son empreinte ou de l’envoyer. Deux représentations JSON sémantiquement proches peuvent avoir des octets différents.

Enveloppe de réponse et contenu JAdES

La réponse HTTP est le contrat JSON commun v1 : format, signature_level, filename, mime_type, signature_uid, document_base64, metadata. Après décodage de document_base64, vous obtenez le résultat JAdES/JWS en JSON aplati.

Ne confondez pas le Base64 de transport de l’API et le Base64URL utilisé dans les éléments JWS. Ne réencodez pas manuellement les éléments du conteneur retourné.

Mode détaché et validation

Le mode détaché exige de conserver les données d’origine. Les références et les informations d’empreinte doivent être interprétées par un validateur compatible JAdES. Un validateur JWS générique ne contrôle pas nécessairement les propriétés d’horodatage et de validation à long terme ajoutées par JAdES.

Prévoyez une recette avec le système destinataire sur le packaging, le profil, les références et la confiance dans le certificat. Référence document · Référence digest.