- Conformité et preuve juridique — prouver qui a signé quoi, quand et depuis où
- Débogage des problèmes de signataires — voir exactement ce qu’un destinataire a fait pendant sa session de signature
- Reporting interne — suivre les actions administratives comme la création, les modifications et les annulations
- Événements signataire — affichages de document, interactions avec les champs, signature, refus, téléchargements de certificat
- Événements administrateur — création, modifications, envoi, annulation, renvoi (via le tableau de bord ou l’API)
Consulter la piste d’audit dans le tableau de bord
Ouvrez n’importe quelle demande de signature dans le tableau de bord Firma et cliquez sur l’onglet Piste d’Audit. Vous verrez une chronologie de tous les événements, avec les actions des signataires et des administrateurs visuellement distinguées. Les événements répétitifs consécutifs (comme le défilement ou les interactions répétées avec un champ) sont automatiquement condensés avec un indicateur de nombre.Authentification sur le certificat de finalisation
Chaque ligne de signataire du certificat de finalisation comporte une ligneAuthentification: qui indique Lien par courrier électronique ou Lien par courrier électronique + code à usage unique. Pour un signataire par code, la ligne se termine par (code vérifié le <heure>), l’heure à laquelle le signataire a saisi le code. La ligne Identité: en haut du certificat affiche la méthode commune, ou Mixte (voir signataires) lorsque les signataires diffèrent. L’heure du code peut précéder l’heure Consulté imprimée au-dessus, car le signataire saisit le code avant le chargement du document.
Récupérer la piste d’audit via l’API
Utilisez le endpoint audit pour récupérer l’historique complet des événements d’une demande de signature :curl
Node.js
Python
Exemple de réponse
Champs de la réponse
Comprendre les sources d’événements
Le champsource indique si un événement provient d’un signataire ou d’un administrateur, et le champ actor a une forme différente selon le cas.
Événements signataire
Les événements avecsource: "signer" sont des actions effectuées par les destinataires pendant le flux de signature. L’objet actor contient le name et l’email du signataire. Le champ ip_address est renseigné.
organization_seal_*) utilisent source: "signer" avec actor et ip_address à null. Firma.dev les enregistre lorsqu’il applique, met en pause, échange ou épingle de nouveau un cachet, et details contient les données du cachet.
Événements administrateur
Les événements avecsource: "admin" sont des actions effectuées via le tableau de bord ou l’API. L’objet actor contient un champ type ("api_key" ou "user") et éventuellement un user_id. Le champ ip_address est null.
- Annulation depuis le tableau de bord :
Signing Request Cancellation requested - Suppression depuis le tableau de bord :
Signing Request Deletion requested - Nouvelle tentative de certificat :
Certificate regeneration requested
Signing Request Cancelled / Signing Request Deleted).
Suivi en temps réel via les webhooks
Si vous avez besoin d’une notification en temps réel des événements signataire plutôt que d’interroger le endpoint audit, Firma prend en charge les webhooks. Consultez le guide Webhooks pour les instructions de configuration.Référence des événements
Cycle de vie du document
Signature et vérification
Deux événements identifient le code à usage unique vérifié par l’ID de son enregistrement (
otp_code_id) dans details ; le code lui-même n’est pas inclus :
otp_verified:{"channel": "email", "otp_code_id": "<uuid>"}document_finished:{"otp_code_id": "<uuid>"}, présent lorsque la session qui a terminé le document était liée à un code vérifié
Interactions avec les champs
Les interactions avec les champs sont suivies comme des événementsfield_interaction. L’objet details contient l’action spécifique et les métadonnées du champ.
L’objet
details pour les interactions avec les champs inclut :
Navigation
Cachets d’organisation
Firma.dev enregistre ces événements pour un cachet d’organisation de la demande lorsqu’il est appliqué, mis en pause, échangé ou épinglé de nouveau.Activité administrateur
Les événements administrateur utilisentevent: "activity" avec un champ description lisible par un humain qui décrit l’action effectuée (par exemple, “Created signing request via API”, “Sent signing request”, “Cancelled signing request”).