Cacheter du XML ou des fichiers : XAdES et CAdES

XAdES et CAdES sont disponibles via les routes v1 pour les documents et les empreintes. Leur utilisation API nécessite la licence Click&Cert Premium. Chaque format accepte B-B, B-T et B-LT dans le périmètre décrit ici.

XAdES : structure XML

POST /api/clickncert/v1/document/xades/sign reçoit un document XML valide, non vide, encodé dans document_base64, avec certificate_uid. Le résultat est un document XML contenant la signature.

Paramètre XAdES	Valeurs / rôle
`signature_level`	`B-B` par défaut, `B-T`, `B-LT`
`packaging`	`enveloped` par défaut ; `enveloping`, `detached`, `internally_detached`
`digest_algorithm`	`sha256` par défaut ; `sha384`, `sha512`
`canonicalization_method`	`http://www.w3.org/2001/10/xml-exc-c14n#`
`reference_uri`	Référence aux données, notamment en mode détaché
`signature_id`, `reference_id`, `signed_properties_id`, `qualifying_properties_id`	Identifiants XML facultatifs, 128 caractères maximum et syntaxe XML attendue
`claimed_roles`	Tableau facultatif, au plus 10 chaînes de 120 caractères
`data_object_format`	Objet facultatif : `mime_type` et `description`

Le calcul d’empreinte et la canonicalisation XML jouent des rôles différents. Les algorithmes de digest proposés ne signifient pas que tous les algorithmes de signature sont configurables : le service documenté utilise RSA-SHA256 pour la signature.

Comprendre le packaging XAdES

Packaging	Organisation du résultat
`enveloped`	La signature est insérée dans le document XML
`enveloping`	Les données sont portées par la structure de signature
`detached`	La signature référence des données séparées
`internally_detached`	Signature et données sont distinctes dans un même document XML

En mode digest, le service prend uniquement en charge detached. Ne choisissez pas un autre packaging parce qu’il figure dans une énumération de schéma : le contrôle métier du moteur reste applicable.

Pour une signature détachée, conservez les données exactes et une convention stable de résolution de reference_uri. Modifier la sérialisation XML, les espaces ou l’encodage après signature doit être évalué avec la méthode de validation retenue.

CAdES : conteneur CMS

POST /api/clickncert/v1/document/cades/sign accepte les octets d’un document quelconque dans document_base64. Le format CAdES n’exige pas que le contenu soit un PDF ou un XML.

Packaging	Résultat	À conserver
`detached` par défaut	Signature `.p7s`	Signature et fichier original
`enveloping`	Conteneur `.p7m` incluant le contenu	Conteneur complet

Le digest est sha256. Les profils sont B-B, B-T et B-LT. La réponse v1 encode le résultat dans document_base64, même lorsqu’il s’agit d’une signature détachée et non du document original.

Exemple CAdES

{
  "certificate_uid": "REMPLACER_PAR_UID_CERTIFICAT",
  "document_base64": "REMPLACER_PAR_BASE64_DU_FICHIER",
  "filename": "donnees.csv",
  "signature_level": "B-T",
  "packaging": "detached",
  "digest_algorithm": "sha256"
}

Pour un document gardé côté client, utilisez le mode digest. Pour B-LT, la collecte des éléments de confiance fait partie du traitement ; une indisponibilité empêchant de constituer le résultat peut faire échouer l’opération.

Référence XAdES document · CAdES document · Validation.