Authentification et droits Click&Cert
Comprendre les contrôles de compte, d’abonnement, de certificat et de TOTP.
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.
Les endpoints Click&Cert utilisent HTTP Basic sur HTTPS. Les identifiants sont ceux du compte API autorisé. L’abonnement, la licence et les habilitations sur le certificat sont des contrôles complémentaires.
flowchart TD
A["Requête HTTPS avec Basic"] --> B{"Compte authentifié ?"}
B -->|Oui| C{"Abonnement actif ?"}
C -->|Oui| D{"Débit autorisé ?"}
D -->|Oui| E{"Certificat accessible et disponible ?"}
E -->|Oui| F["Contrôle d’activation du certificat"]
F --> G["Création du résultat"]
B -->|Non| H["401"]
C -->|Non| I["403"]
D -->|Non| J["429"]
E -->|Non| K["403 ou 422"]
classDef default fill:#EDF4FF,stroke:#2B61B5,color:#172F55
Habilitation et licence
Un utilisateur authentifié peut être refusé s’il n’est pas rattaché à l’organisation ou autorisé sur le certificat. À l’inverse, une réponse techniquement acceptée ne remplace pas les droits commerciaux de votre contrat. Vérifiez les conditions Premium avant d’utiliser un profil ou un format avancé.
Quand fournir un TOTP ?
Pour Identity+ (QCP-n-QSCD), l’application cliente présente les documents à signer et recueille le TOTP fourni par le signataire. Le moyen d’authentification doit avoir été enrôlé. L’API v1 attend le code à six chiffres sous forme de chaîne dans le paramètre totp ; ce contrôle est propre au profil de certificat concerné.
Le parapheur associe l’autorisation du signataire, le document ou son empreinte et le certificate_uid de son certificat nominatif dans la demande API. Une fois l’opération réalisée, le résultat est réintégré au circuit métier.
Pour un certificat de personne morale, respectez le moyen d’activation et les autorisations remis lors de la délivrance. Ne réutilisez pas les règles d’un certificat de personne physique pour déduire le processus d’un cachet. Les politiques de certification définissent les conditions applicables.
Les erreurs v1 TotpRequiredException, TotpEnrollmentRequiredException et InvalidTotpException sont renvoyées en 422. Le code TOTP doit rester une chaîne afin de préserver un éventuel zéro initial.
Secrets et environnements
Stockez les identifiants dans un gestionnaire de secrets, utilisez une connexion TLS vérifiée et évitez de journaliser Authorization, mots de passe, codes TOTP et documents. Ne partagez pas un accès de production dans un exemple de code ou dans le navigateur d’un utilisateur final.
La préproduction emploie les accès et certificats de test convenus à l’activation. Un certificat de test peut provoquer un résultat « chaîne non reconnue » dans un validateur public. Ce constat ne doit pas être masqué et ne démontre pas la qualification du résultat.
Suite : Certificats et erreurs d’intégration.
Updated 20 days ago

