Signature et cachet XML ou fichiers : XAdES et CAdES
Click&Cert : Signature et cachet XML ou fichiers : XAdES et CAdES, 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.
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.
Updated 20 days ago

