Passer au contenu principal
Chaque demande de signature dans Firma dispose d’une piste d’audit complète. Chaque affichage de document, interaction avec un champ, signature, refus et action administrative est enregistré avec horodatage, identité de l’acteur et adresses IP. Cas d’usage courants :
  • 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
La piste d’audit capture deux catégories d’événements :
  • É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)
Chaque événement inclut un horodatage, une description lisible par un humain, l’identité de l’acteur et (pour les événements signataire) l’adresse IP du signataire.

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 ligne Authentification: 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 champ source 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 avec source: "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é.
Les événements de cachet d’organisation (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 avec source: "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.
Trois actions d’administrateur écrivent ces descriptions, que l’API renvoie en anglais dans toutes les langues :
  • 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
Firma.dev écrit chaque ligne avant le changement, de sorte que la ligne reste lorsque l’action échoue ensuite ou perd une course. « Requested » enregistre la demande ; il ne confirme pas que l’action est terminée. Les lignes écrites avant l’API v1.40.3 conservent l’ancienne formulation (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énements field_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 :

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 utilisent event: "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”).