Version de développement
Cette documentation décrit la version « next » (develop), non encore publiée. Pour la version stable, basculez sur « v5 » dans l'en-tête.
Utilisateurs

Configurer l'authentification à double facteur

Activer l'authentification à deux facteurs dans les Paramètres Système et configurer l'application OTP depuis l'écran de connexion.

Configurer l'authentification à double facteur

La double authentification ajoute une étape après le mot de passe. L'utilisateur saisit un code envoyé par e-mail, envoyé par SMS ou généré par une application d'authentification. Un mot de passe volé ne suffit plus pour se connecter.

Prérequis

  • Avoir le rôle System Manager.
  • Pour la méthode e-mail : un compte e-mail sortant par défaut.
  • Pour la méthode SMS : une passerelle configurée dans les Paramètres des SMS, et un N° mobile ou un Téléphone sur la fiche de chaque utilisateur.

Activer la double authentification

  1. Ouvrez Paramètres Système, onglet Connexion, section Authentification à Double Facteur.
  2. Cochez Autoriser l'authentification à double facteur.
  3. Dans Méthode d'Authentification à Double Facteur, choisissez Application OTP, SMS ou E-mail.
  4. Dans Nom de l'Émetteur OTP, saisissez le nom que vos utilisateurs verront dans leur application. Par défaut : « Dokos ».
  5. Enregistrez.

Si vous choisissez SMS sans passerelle configurée, Dokos refuse l'enregistrement.

Choisir les utilisateurs concernés

La double authentification s'applique aux utilisateurs dont au moins un rôle a la case Authentification à Double Facteur cochée. Quand vous l'activez, Dokos coche cette case sur le rôle « All ». Tous les utilisateurs sont donc concernés.

Pour ne viser que certains rôles :

  1. Ouvrez le rôle « All » et décochez Authentification à Double Facteur.
  2. Ouvrez chaque rôle concerné, par exemple « Accounts Manager », et cochez la case.

Options liées aux adresses IP

Ces options utilisent le champ Restreindre l'IP de la fiche utilisateur :

OptionEffet
Ignorer l'authentification à double facteur pour les utilisateurs qui se connectent à partir d'une adresse IP restreinteUn utilisateur qui se connecte depuis une de ses adresses autorisées n'a pas de code à saisir.
Ignorer la vérification des adresses IP restreintes si l'authentification à double facteur est activéeTous les utilisateurs peuvent se connecter depuis n'importe quelle adresse, avec la double authentification.

Exemple fictif : les postes du bureau ont des adresses en 192.168.10.. Vous saisissez 192.168.10. dans Restreindre l'IP des comptables et vous cochez la première option. Au bureau, les comptables se connectent avec leur seul mot de passe. Ailleurs, la connexion est refusée.

Se connecter avec chaque méthode

E-mail ou SMS

Après le mot de passe, Dokos envoie un code à l'adresse e-mail de l'utilisateur, ou par SMS à son N° mobile (à défaut son Téléphone). L'utilisateur le saisit sur l'écran de connexion. Le code expire après 5 minutes.

Application OTP : première connexion

La configuration de l'application se fait sur l'écran de connexion :

  1. Saisissez votre identifiant et votre mot de passe.
  2. Dokos envoie un code à votre adresse e-mail. Saisissez ce code.
  3. L'écran affiche un QR code et une clé de configuration.
  4. Scannez le QR code avec votre application d'authentification. Si vous ne pouvez pas le scanner, saisissez la clé de configuration dans l'application.
  5. Saisissez le code affiché par l'application.

Le code e-mail prouve que vous avez accès à l'adresse enregistrée. Le mot de passe seul ne suffit donc pas pour configurer une application. Terminez la configuration avant l'expiration de ce code (5 minutes). Sinon, reconnectez-vous pour recommencer.

Les applications compatibles avec les codes TOTP conviennent, par exemple FreeOTP, Google Authenticator, Authy, Duo Mobile ou Bitwarden Authenticator.

Application OTP : connexions suivantes

Saisissez votre identifiant, votre mot de passe, puis le code de l'application. Le QR code et la clé ne s'affichent qu'à la configuration.

Si un utilisateur change de téléphone, utilisez Mot de passe > Réinitialiser le secret d'OTP sur sa fiche. Il refait la configuration à la connexion suivante.

Sécurité

  • Un code faux compte comme une tentative de connexion échouée. Un mot de passe correct ne remet pas le compteur à zéro tant que le code n'est pas validé.
  • Si vous perdez l'accès à votre application, contactez votre administrateur.

Différences avec la version 5

  • La page /qrcode et l'e-mail qui contenait son lien n'existent plus. La configuration se fait sur l'écran de connexion.
  • Le paramètre Heure d'expiration de l'image du QR Code n'existe plus. Les QR codes ne sont plus enregistrés sur le serveur.
  • À la mise à jour, un correctif supprime les anciennes images de QR code du dossier Barcodes, car elles contiennent le secret OTP. Seuls les fichiers joints à un utilisateur avec un nom généré (20 caractères hexadécimaux suivis de .png) sont supprimés.