Formats, profils et résultats
Choisir le bon conteneur et distinguer B-B, B-T, B-LT et B-LTA.
Le format détermine la structure du résultat ; le profil détermine les éléments de preuve ajoutés. Le niveau juridique dépend du certificat, du dispositif et du processus utilisés. Ces trois dimensions se choisissent séparément.
Formats de l’API v1
| Format | Usage | Résultat selon le packaging |
|---|---|---|
| PAdES | PDF cacheté ; en mode digest, conteneur CMS à incorporer dans un PDF préparé | |
| XAdES | XML ou référence à des données externes | XML contenant la signature |
| CAdES | Données de tout type | Signature détachée .p7s ou conteneur avec contenu .p7m |
| JAdES | Écosystèmes JWS/JAdES | Objet JWS/JAdES avec sérialisation JSON aplatie |
JAdES exige de confirmer les conditions commerciales de l’offre. XAdES, CAdES et les opérations de digest relèvent de Premium ; voir Licences.
Profils effectivement disponibles
| Format / mode | B-B | B-T | B-LT | B-LTA |
|---|---|---|---|---|
| PAdES document complet | Oui | Oui | Oui | Oui |
| PAdES digest | Oui | Oui | — | — |
| XAdES document | Oui | Oui | Oui | — |
| XAdES digest détaché | Oui | Oui | Oui | — |
| CAdES document ou digest | Oui | Oui | Oui | — |
| JAdES document ou digest | Oui | Oui | Oui | — |
Ne généralisez pas B-LTA à tous les formats. Pour PAdES, B-LT et B-LTA nécessitent le document PDF complet dans cette API.
Lire les profils
| Profil | Éléments apportés |
|---|---|
B-B | Structure de signature de base et informations de certificat prévues par le format |
B-T | B-B complété par un horodatage de la valeur de signature |
B-LT | B-T complété par les certificats et données de révocation nécessaires à la validation à long terme |
B-LTA | Pour PAdES document : protection d’archive supplémentaire sur le document enrichi |
La date déclarative d’une signature B-B n’a pas le rôle d’un horodatage de confiance. B-LT facilite une validation ultérieure grâce aux éléments incorporés. B-LTA ajoute une protection d’archive ; il ne signifie pas une conservation ou un renouvellement automatique et perpétuel par le service.
Document ou empreinte ?
Avec /document/{format}/sign, vous envoyez les octets du document en Base64 et recevez le résultat en Base64. Avec /digest/{format}/sign, vous envoyez l’empreinte binaire encodée en Base64 et recevez une signature ou un conteneur détaché. L’application cliente conserve les données et assure, si nécessaire, l’assemblage final.
Pour un PDF, le digest doit être celui du ByteRange préparé pour la signature ; le SHA-256 ordinaire du fichier original ne suffit pas à fabriquer un PDF PAdES valide.
Signature brute et conteneur normalisé
Les anciennes API hash/new et file/new renvoient une signature RSA PKCS#1 encodée en Base64. Elles ne renvoient pas un conteneur CAdES, un PDF final ou une signature XML. Choisissez le contrat de sortie attendu par le système destinataire avant l’endpoint. Guide digest et legacy.
Updated about 1 hour ago