Documentation KSIDol > Modules KSIDol > OTP par SMS
Notice du module OTP par SMS
Guide d'utilisation non technique : à quoi sert le module, comment l'utiliser et comment il s'articule avec Dolibarr.
Signature en lignePar code SMS (OTP)
Documents concernésDevis et contrats
CompatibilitéDolibarr 18 à 24
Dossier de preuvePDF, archive ZIP et journal chaîné
1. Présentation du module
Le module OTP par SMS (Signature OTP) ajoute à Dolibarr une signature électronique renforcée. Lorsqu'un client ouvre le lien de signature en ligne d'un devis ou d'un contrat, il n'arrive plus directement sur la zone de signature : le module lui demande d'abord un code à usage unique, envoyé par SMS sur le numéro de mobile enregistré dans Dolibarr pour ce document. Le code saisi est vérifié par le serveur, puis le signataire ouvre le document et confirme explicitement son consentement. La zone de signature n'apparaît qu'ensuite. La signature ne peut donc être apposée que par une personne qui tient le téléphone attendu, ce qui renforce la valeur de l'accord recueilli à distance.
À chaque signature, le module constitue un dossier de preuve : le document exact présenté au signataire, son empreinte SHA-256, un PDF de preuve reprenant la chronologie et les éléments techniques, un fichier de preuves détaillé, un manifeste d'empreintes et le journal d'audit du parcours. Le tout est rangé dans une archive datée et numérotée qui n'est jamais réécrite, et chaque étape est inscrite dans un journal d'événements chaînés consultable depuis l'écran du module. Le module s'appuie sur la signature en ligne native de Dolibarr et sur ses objets standard, sans modifier le cœur de l'application : il remplace seulement l'adresse du lien de signature et garde la zone de signature fermée jusqu'à la validation du code et du consentement.
Envoie un code de vérification à usage unique par SMS, avec un compte OVH SMS, avant toute signature en ligne
Garde la zone de signature fermée tant que le code n'est pas validé et le consentement non confirmé
Fige le document présenté au signataire et son empreinte SHA-256, pour démontrer qu'il n'a pas changé
Produit un PDF de preuve et une archive de preuves téléchargeable pour chaque signature
Tient un journal d'événements chaîné, consultable, filtrable et imprimable en PDF
Se règle type de document par type de document : chacun reste en signature native ou passe par le code SMS
N'apporte aucune modification au cœur de Dolibarr : désactivé, le parcours natif reprend tel quel
2. La signature en ligne devient une signature vérifiée par SMS
C'est la fonction centrale du module : conserver la signature en ligne de Dolibarr, mais la faire précéder d'une vérification par SMS. Un seul réglage commande l'ensemble, et il est actif dès l'installation du module.
« Actif » fait passer les liens de signature par la page du module ; « Inactif » les laisse sur la page de signature native de Dolibarr
Dans les écrans de Dolibarr, les liens de signature affichés sur les fiches sont réécrits vers la page du module, sauf pour les types laissés en signature native
Dans les courriels envoyés aux clients, le lien de signature d'un devis pointe directement sur le parcours avec code SMS
Un signataire qui arrive malgré tout sur la page de signature native est amené au parcours avec code SMS
Si le module ou son intégration est désactivé, un lien déjà envoyé reste utilisable : il ramène simplement le signataire sur la page native de Dolibarr
Aucun code n'est envoyé automatiquement à la création ou à l'envoi du document : c'est le signataire qui demande le sien depuis la page de signature
3. Le parcours du signataire, étape par étape
Le signataire n'a rien à installer et reste dans son navigateur. La page lui présente une étape à la fois et ne découvre la suivante que lorsque la précédente est franchie.
Il ouvre le lien reçu : la page rappelle le document concerné et le numéro de mobile qui recevra le code, masqué à l'exception des quatre derniers chiffres
Il demande l'envoi du code d'un seul bouton ; si un code est encore valable, la page le lui signale au lieu d'en émettre un autre
Il saisit le code reçu puis le valide ; le champ est prévu pour la saisie automatique du code proposée par les téléphones
Une fois le code validé, il peut ouvrir dans un nouvel onglet le document qui sera réellement pris en compte
Il coche alors la mention de consentement et la confirme ; la zone de signature n'apparaît qu'après cette confirmation
Il signe comme sur la page de signature habituelle de Dolibarr, et un message confirme que la signature et son dossier de preuve sont enregistrés
S'il rouvre le lien après la signature, la page indique que la signature est déjà enregistrée et n'en accepte pas de nouvelle
4. Le code SMS : destinataire, durée de validité et nombre d'essais
Un code ne prouve quelque chose que s'il part vers un numéro que le signataire n'a pas choisi lui-même. Le module prend donc le numéro enregistré dans Dolibarr et interdit sa modification depuis la page publique.
Le code part vers le numéro de mobile du document, repris de la fiche du tiers lorsque le document n'en porte pas
Le signataire ne peut ni saisir ni corriger ce numéro : la page le lui rappelle masqué et lui indique de contacter l'émetteur du document en cas d'erreur
Un numéro corrigé dans Dolibarr est repris à la réouverture du lien, et le code resté en attente sur l'ancien numéro est invalidé pour qu'un nouveau code puisse partir sans délai
Si aucun numéro de mobile n'est enregistré, la page l'explique au signataire et aucun code n'est émis
La longueur du code, de quatre à dix chiffres, sa durée de validité, de une à soixante minutes, et le nombre de renvois autorisés se règlent dans la configuration
Un code expiré est refusé, et au-delà du nombre de saisies incorrectes autorisé la vérification est bloquée jusqu'à l'envoi d'un nouveau code
Le texte du SMS est personnalisable : le code et le délai d'expiration y sont insérés automatiquement
5. Le consentement explicite avant la zone de signature
La validation du code ouvre une étape de consentement, destinée à établir que le signataire a bien eu le document sous les yeux et qu'il a voulu le signer.
Le document réellement pris en compte s'ouvre d'un bouton ; il est servi par le module et jamais pris ailleurs que dans les répertoires de documents de Dolibarr
La mention présentée au signataire est un texte libre, défini dans la configuration du coffre-fort
Le consentement doit être coché puis confirmé : sans cette confirmation, la zone de signature reste masquée
La page annonce au signataire ce que sa confirmation enregistre : la date, l'adresse IP, le navigateur, l'empreinte du document présenté et le numéro de mobile utilisé
Le consentement n'est enregistrable qu'après la validation du code : l'ordre des étapes ne peut pas être inversé
6. Les verrous qui empêchent de contourner le code
Les contrôles ne reposent pas sur ce qui est affiché : ils sont refaits par le serveur au moment où la signature est soumise.
Sur la page de signature native, la zone de signature, le bouton d'effacement et le bouton de signature sont masqués, et le champ du nom est désactivé tant que le code n'est pas validé
Un bouton d'accès au parcours avec code SMS y est ajouté, pour amener le signataire au bon endroit
Toute tentative d'enregistrement d'une signature sans code validé ni consentement confirmé est refusée par le serveur
Les autorisations obtenues ne servent qu'une fois : elles sont consommées à l'enregistrement, et le même lien ne permet pas de signer une seconde fois
Un lien dont la clé de sécurité est invalide, ou qui désigne un document introuvable, reçoit exactement la même réponse de refus : la page ne révèle pas quelles références de documents existent
Les envois de formulaire de la page publique sont protégés par un jeton et par un contrôle de provenance
7. Le dossier de preuve constitué à chaque signature
À la signature d'un devis ou d'un contrat, le module rassemble automatiquement les pièces qui permettront de défendre l'accord en cas de contestation.
Le document exact présenté au signataire est recopié tel quel dans l'archive, sous un nom explicite
Un PDF de preuve y est produit, accompagné d'un fichier de preuves détaillé, d'un manifeste d'empreintes et du journal d'audit de la signature
L'archive porte l'identifiant de la signature et se range par entité, par année et par mois dans les données de Dolibarr
Chaque archive est numérotée : une archive existante n'est jamais réécrite silencieusement
La copie du document est refusée si son empreinte ne correspond pas à celle figée à l'ouverture du lien, et l'archive n'est alors pas déclarée valide
L'archive complète se télécharge en un seul fichier ZIP depuis le journal des signatures
8. Le contrôle d'intégrité du document
Toute la valeur du dossier tient à une question : le document signé est-il bien celui qui a été montré ? Le module y répond par des empreintes SHA-256 calculées puis recomparées.
L'empreinte du document est calculée à l'ouverture du lien, avant tout envoi de code
Elle est verrouillée dès que le code est validé : une régénération du document ne peut plus remplacer l'empreinte de référence
À chaque édition du PDF de preuve, les empreintes des fichiers archivés sont recalculées et comparées au manifeste, ligne par ligne
Le résultat est présenté élément par élément avec un état lisible : document présenté, PDF de preuve, fichier de preuves, manifeste d'empreintes et répertoire d'archive
Le parcours ne va pas plus loin si l'empreinte du document n'a pas pu être calculée : la signature est bloquée plutôt que mal prouvée
9. Le PDF de preuve
Le PDF de preuve est la pièce que l'on remet ou que l'on produit. Il est généré dans l'archive au moment de la signature, et peut être réédité à la demande depuis le journal.
En-tête portant l'identifiant de signature et la référence du document, puis les coordonnées de la société émettrice et celles du client
Résumé de la signature : événement, date, état, date de validation du code, date du consentement, mobile utilisé, signataire, courriel, téléphone et compte connecté
Adresse IP et navigateur du signataire, lorsque leur collecte est activée
Tableau de contrôle d'intégrité des fichiers archivés, avec l'empreinte attendue et l'empreinte constatée
Empreintes et chaînage de l'événement : empreinte du document source, empreinte de l'événement et empreinte de l'événement précédent
Liste des pièces archivées et liste des éléments de preuve collectés tout au long du parcours
10. Le document signé et son cartouche de preuve
Le document signé reste un PDF ordinaire, lisible partout, mais il porte une marque discrète qui renvoie à son dossier de preuve.
Un cartouche est apposé sur le document signé : il annonce le dossier de preuve et rappelle l'identifiant de la signature
Il figure sur la première page, ou sur toutes les pages lorsque l'option de signature sur toutes les pages est activée pour les devis et les contrats
Le document signé se télécharge depuis le journal des signatures, et il est reconstitué à la demande s'il n'a pas encore été produit
Un document que le composant d'impression ne sait pas relire n'est pas estampillé : la signature et son enregistrement se poursuivent, et le motif est consigné côté serveur
11. Le journal des signatures
Un onglet dédié présente tous les événements de signature. Rien n'y est modifiable : les enregistrements s'ajoutent les uns aux autres et chacun porte l'empreinte du précédent.
Une ligne par étape : ouverture du lien, mobile confirmé, code envoyé, code validé, code refusé, code expiré, consentement accepté, signature capturée, archive créée, échec d'envoi du code et échec du parcours
L'ouverture de l'écran de configuration du module est elle aussi consignée
Recherche et filtres par période, identifiant de signature, tiers, type et numéro de document, événement, état, référence, adresse IP et détail
Tri sur les principales colonnes et pagination, au format habituel des listes de Dolibarr
Trois accès par ligne : éditer le PDF de preuve, télécharger le document signé et télécharger l'archive de preuves, ces deux derniers dès qu'ils existent
Une colonne donne l'identifiant de la demande de signature, qui permet de rapprocher une ligne de son archive, de son PDF de preuve et du document signé
12. Retrouver une signature depuis la fiche du document
Il n'est pas nécessaire de passer par le menu du module : les fiches concernées portent un accès direct au journal.
Un bouton d'accès au journal des signatures est ajouté aux fiches de tiers, de devis, de commande, de facture et de contrat
Ouvert depuis une fiche, le journal est déjà filtré sur ce document
Lorsque la dernière signature du document est archivée, un bandeau l'annonce sur la fiche et affiche l'identifiant de la signature
Ces ajouts n'apparaissent qu'aux utilisateurs disposant du droit de lecture du module
13. Choisir, type par type, ce qui passe par le code SMS
Tous les documents n'appellent pas le même niveau de vérification : un onglet de la configuration permet de décider type de document par type de document.
Pour chaque type proposé, un choix unique : prise en charge par le module, avec code SMS et dossier de preuve, ou signature native de Dolibarr
Un type laissé en natif n'est plus touché : le lien n'est pas réécrit, la zone de signature n'est pas verrouillée et aucun code n'est demandé
La fiche d'intervention est laissée en signature native par défaut, parce qu'elle se signe le plus souvent sur place ; les autres types sont pris en charge par le module
Le choix s'applique partout de la même façon : liens affichés dans les écrans, page de redirection et page de signature native
14. Configurer l'envoi des SMS
Le module envoie ses SMS avec un compte OVH SMS, dont les paramètres se saisissent dans l'onglet SMS / OTP. L'écran reprend la configuration d'envoi de SMS déjà en place et y ajoute les réglages propres au code de vérification.
Adresse du service, clé d'application, secret d'application et clé consommateur, avec un bouton qui ouvre le générateur de clé d'OVH en demandant d'emblée les droits nécessaires
Identifiant du service SMS et affichage du crédit disponible sur le compte
Expéditeur par défaut choisi dans la liste des expéditeurs validés sur le compte OVH : un expéditeur refusé par l'opérateur n'est pas enregistré
Gestion de l'indicatif pays : détection et ajout si besoin, ajout systématique de l'indicatif par défaut, ou aucune action
Les paramètres sont contrôlés à l'enregistrement par un appel au compte OVH, qui signale immédiatement une clé ou un service invalide
Un bouton de test vérifie l'adresse du service, les identifiants, le service, l'accès à l'interface d'OVH et la présence des tables, et affiche un état pour chacun
Un outil de réinitialisation vide le journal d'envoi des SMS, après une confirmation explicite à cocher
Les SMS de code sont toujours émis en priorité haute, en message transactionnel et sans clause de désinscription
15. Quotas et alerte de stock de SMS
Pour qu'une signature n'échoue jamais faute de SMS, le module surveille le stock disponible et le signale avant la panne.
Un tableau liste les utilisateurs actifs avec le quota de SMS attribué, le nombre utilisé et le solde disponible ; le quota se saisit utilisateur par utilisateur
Un badge rappelle le nombre de SMS encore disponibles pour l'utilisateur connecté et change de couleur lorsqu'il devient faible
Quand le stock devient faible, une pastille apparaît en haut de l'écran et une carte d'alerte en bas de page, l'une et l'autre menant au paramétrage des SMS
L'alerte s'appuie d'abord sur le crédit du compte OVH et, à défaut, sur le quota de l'utilisateur
Ces rappels ne s'affichent qu'aux utilisateurs habilités à intervenir sur la configuration des SMS
L'adresse où commander des SMS peut être enregistrée avec les paramètres ; elle n'est acceptée qu'en connexion sécurisée
16. Le coffre-fort : conservation, mention légale et données collectées
Un onglet rassemble les règles d'archivage et ce qui est collecté auprès du signataire, pour les aligner sur vos exigences de conformité.
Mode de coffre-fort, libellé de clé interne et algorithme de hachage, SHA-256 par défaut
Durée de conservation des preuves, exprimée en années
Périmètre de conformité déclaré et mention légale présentée au signataire au moment du consentement
Journal en ajout seul, pour que les enregistrements ne puissent qu'être complétés
Collecte de l'adresse IP et du navigateur du signataire, activable ou non
17. Ce qui n'est jamais conservé en clair
Un second facteur ne vaut que si l'émetteur lui-même ne peut pas le reconstituer : le module s'applique à ne pas conserver ce qui ruinerait cet argument.
Le code envoyé n'est jamais conservé en clair : seule une empreinte protégée est enregistrée, pour permettre la vérification
Le texte du SMS consigné au journal remplace le code par des caractères masqués, y compris dans le dossier de preuve remis au client
Le numéro de mobile n'apparaît jamais en entier sur la page publique : il y est seulement rappelé masqué
Le document présenté au signataire n'est servi qu'après vérification de la clé du lien, et seulement depuis les répertoires de documents autorisés
Le téléchargement du document signé et celui de l'archive de preuves exigent un compte Dolibarr disposant du droit de lecture du module
18. Liaisons avec Dolibarr
Le module ne fonctionne pas en vase clos : il s'articule avec les briques natives de Dolibarr.
Devis (propositions commerciales) et contrats : Ce sont les deux documents pour lesquels le parcours complet s'applique : le lien de signature en ligne passe par le code SMS, et le dossier de preuve est constitué puis archivé dès que le devis est signé en ligne ou que le contrat est signé. Le module se greffe sur la signature en ligne de ces fiches sans rien changer à leur cycle de vie ni à leur numérotation.
Signature en ligne native de Dolibarr : Le module réutilise le mécanisme natif et sa clé de sécurité : il remplace seulement l'adresse du lien de signature, garde la zone de signature fermée jusqu'à la validation du code et du consentement, puis laisse Dolibarr enregistrer la signature. Intégration désactivée, le parcours natif fonctionne comme avant, y compris pour les liens déjà envoyés aux clients.
Fiches d'intervention : La signature en ligne d'une fiche d'intervention reste native par défaut, parce qu'elle se signe le plus souvent sur place, devant le technicien. Elle peut être basculée sur le code SMS depuis l'onglet de choix par type de document.
Tiers et contacts : Le nom du signataire et le numéro de mobile sont repris du document, puis de la fiche du tiers lorsque le document n'en porte pas. Le numéro se corrige dans Dolibarr, sur la fiche concernée : la page publique ne permet pas au visiteur de choisir où part le code. Le nom du tiers est aussi celui qui s'affiche dans le journal et sur le PDF de preuve.
Documents (fichiers de Dolibarr) : Le document présenté est le PDF de la fiche, pris dans les répertoires de documents de Dolibarr. Le document signé est écrit à côté de lui, et l'archive de preuves est rangée dans un répertoire propre au module, au sein des données de Dolibarr. Les deux restent téléchargeables depuis le journal des signatures.
Modèles de courriel et liens envoyés au client : Dans les courriels de devis, le champ de substitution du lien de signature en ligne est remplacé par l'adresse du parcours avec code SMS : le client n'a rien de particulier à faire. Un champ de substitution propre au module fournit la même adresse, si vous préférez l'insérer explicitement dans un modèle.
Autres fiches : tiers, commandes, factures : Ces fiches reçoivent le bouton d'accès au journal des signatures, déjà filtré sur la fiche ouverte, ainsi que le bandeau de signature enregistrée. La signature en ligne, elle, ne concerne que les documents que Dolibarr sait faire signer : les commandes et les factures ne disposent pas de lien de signature en ligne.
Utilisateurs, droits et entités : Le module ajoute trois droits : lecture, écriture et administration. Les ajouts sur les fiches et les téléchargements demandent le droit de lecture, tandis que l'écran de configuration et l'édition du PDF de preuve sont réservés aux administrateurs. Les quotas de SMS s'attribuent utilisateur par utilisateur, et toutes les données du module sont rattachées à l'entité courante.
Cookies
KSIDol utilise des cookies nécessaires pour le panier, la connexion et le paiement. Les cookies non essentiels restent désactivés tant que vous ne les acceptez pas.
Bonjour, je suis KSIAssistantIA, l’assistant intégré à votre logiciel de gestion. Je peux par exemple vous faire un résumé de la situation de votre entreprise. Voulez-vous voir ce que je sais faire ?