Démarrage rapide : signature et cachet
Click&Cert : Démarrage rapide : signature et cachet, 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.
Ce parcours utilise l’API v1 PAdES avec un document complet. Il montre un profil B-B. Pour un profil B-T, B-LT ou B-LTA, vérifiez l’activation de votre licence Premium.
Prérequis
Préparez un compte API Click&Cert, un abonnement actif, un certificat Cloud durable valide (Identity+ ou Enterprise+) et son certificate_uid. L’utilisateur doit être explicitement habilité sur ce certificat. Utilisez un PDF de test et l’environnement remis à l’activation.
L’exemple Python ci-dessous construit la requête JSON à partir des octets du PDF. Pour Identity+, ajoutez le code TOTP recueilli auprès du signataire avant la sérialisation, comme indiqué dans le commentaire de l’exemple. Conservez ce code sous forme de chaîne pour préserver les zéros initiaux.
import base64
import json
from pathlib import Path
payload = {
"certificate_uid": "REMPLACER_PAR_UID_CERTIFICAT",
"document_base64": base64.b64encode(
Path("document.pdf").read_bytes()
).decode("ascii"),
"filename": "document.pdf",
"signature_level": "B-B",
"digest_algorithm": "sha256",
}
# Avec Identity+, recueillir le TOTP du signataire avant la sérialisation :
# from getpass import getpass
# payload["totp"] = getpass("TOTP du signataire (6 chiffres) : ")
Path("demande-cachet.json").write_text(
json.dumps(payload), encoding="utf-8"
)Appeler l’API
curl --fail-with-body --silent --show-error \
--user 'UTILISATEUR_API' \
--header 'Content-Type: application/json' \
--header 'Accept: application/json' \
--data @demande-cachet.json \
--output resultat-cachet.json \
'https://my.datasure.net/api/clickncert/v1/document/pades/sign'cURL demande le mot de passe de manière interactive. En automatisation, utilisez un gestionnaire de secrets et un mécanisme d’injection adapté. Vérifiez le code de sortie et le statut HTTP avant la suite.
Récupérer le PDF
La réponse v1 réussie est un JSON sans enveloppe data. Le champ document_base64 contient le document signé ou le conteneur détaché selon l’endpoint.
import base64
import json
from pathlib import Path
result = json.loads(Path("resultat-cachet.json").read_text("utf-8"))
if result.get("format") != "pades" or result.get("mime_type") != "application/pdf":
raise ValueError("La réponse ne contient pas un PDF PAdES")
content = base64.b64decode(result["document_base64"], validate=True)
if not content.startswith(b"%PDF-"):
raise ValueError("Contenu PDF absent")
Path("document-cachete.pdf").write_bytes(content)
print("Référence de signature :", result["signature_uid"])Ce contrôle de format ne remplace pas la validation du cachet. Conservez le PDF final, le signature_uid, le certificat utilisé, le profil et votre référence métier. Le nom de fichier fourni dans la réponse doit être traité comme une donnée, pas comme un chemin de destination de confiance.
En cas de refus
Un 403 peut signaler un abonnement inactif ou une habilitation manquante. Un 422 peut indiquer un certificat indisponible, un document invalide ou une option non prise en charge. Voir Authentification et Erreurs.
Étape suivante : ajouter le profil et les options de PAdES adaptés à votre besoin.
Updated 20 days ago

