Accueil » Formations » Hygiène numérique » Authentification multifacteur : TOTP, FIDO2 et bonnes pratiques » TP02 – Gérer codes TOTP et codes de secours avec KeePassXC

TP02 – Gérer codes TOTP et codes de secours avec KeePassXC

← Authentification multifacteur : TOTP, FIDO2 et bonnes pratiques

// travaux pratiques · Hygiène numérique

TP02 - Gérer codes TOTP et codes de secours avec KeePassXC

  • TP 2 / 6
  • 7 étapes
  • ≈ 45 min
  • Accès libre

Objectif : organiser proprement ses secrets TOTP et ses codes de secours dans KeePassXC, dans une base distincte de celle des mots de passe, générer les codes depuis le poste, exporter un secret vers le téléphone par QR code et sauvegarder l’ensemble.

Contexte

Dans une PME, les comptes partagés de l’équipe informatique (console d’un hébergeur, portail d’un éditeur, compte d’administration d’un service en ligne) ont souvent un TOTP enregistré sur le téléphone d’une seule personne. Le jour où elle est absente ou change de téléphone, l’équipe est bloquée, et la « solution » improvisée consiste trop souvent à désactiver la MFA. Un coffre TOTP maîtrisé, sauvegardé et accessible aux bonnes personnes évite ce scénario.

KeePassXC, gestionnaire de mots de passe libre et hors ligne, sait générer des codes TOTP. Sa documentation avertit pourtant que stocker le TOTP dans la même base que le mot de passe annule l’intérêt du second facteur et recommande une base séparée pour une sécurité maximale. C’est l’organisation que vous mettrez en place. À la fin du TP, vous saurez configurer, utiliser, exporter et sauvegarder des secrets TOTP et des codes de secours.

Prérequis : TP01 terminé (secret de laboratoire « Lab » enregistré sur le téléphone) ; un poste de travail Linux, Windows ou macOS sur lequel installer KeePassXC. Les libellés de menus cités sont ceux de l’interface anglaise de KeePassXC 2.7 et 2.8 ; l’interface française propose les équivalents.

Durée estimée : 45 minutes.

Actions à réaliser

1. Installer KeePassXC

Sous Debian ou Ubuntu, le paquet est dans les dépôts ; pour Windows et macOS, utilisez l’installateur publié sur keepassxc.org, et uniquement ce site.

sudo apt install keepassxc
keepassxc-cli --version

Résultat attendu : la commande affiche le numéro de version installé. Notez-le : les fonctions TOTP décrites ici sont présentes dans les versions 2.7 et 2.8.

2. Créer une base dédiée aux seconds facteurs

Créez une nouvelle base (Database > New Database…) nommée par exemple mfa-equipe.kdbx, distincte de la base des mots de passe. Choisissez une phrase de passe différente de celle de la base principale et laissez les paramètres de chiffrement par défaut.

Pourquoi deux bases : si la base des mots de passe fuit (poste volé déverrouillé, sauvegarde mal protégée), l’attaquant n’obtient pas les seconds facteurs. Résultat attendu : un fichier mfa-equipe.kdbx ouvert, vide, avec son propre mot de passe maître.

3. Ajouter l’entrée et configurer le TOTP

Créez une entrée « Lab – alice » sans mot de passe. Puis, clic droit sur l’entrée : TOTP > Set up TOTP…. Collez le secret base32 du TP01 (affiché par echo "$SECRET" dans la VM) et validez avec les paramètres par défaut.

Les paramètres personnalisés (nombre de chiffres, période, algorithme) ne servent que pour les rares services qui s’écartent du standard ; un mauvais réglage produit des codes faux en permanence. Résultat attendu : une icône d’horloge apparaît sur l’entrée et la colonne TOTP affiche un code de 6 chiffres.

4. Utiliser les codes

Sélectionnez l’entrée et utilisez les raccourcis documentés :

Ctrl+T          copier le code TOTP
Ctrl+Shift+T    afficher le code TOTP dans une fenêtre
Ctrl+Y          copier le mot de passe puis le code TOTP

Comparez le code affiché avec celui du téléphone et avec oathtool --totp -b "$SECRET" dans la VM. Résultat attendu : les trois sources donnent le même code dans la même tranche de 30 secondes. Le presse-papiers est vidé automatiquement après le délai réglé dans les paramètres de KeePassXC.

5. Exporter un secret vers un téléphone

Le menu TOTP de l’entrée permet d’afficher le secret et sa configuration sous forme de QR code, pour l’ajouter à l’application d’un second administrateur. Supprimez d’abord l’entrée « Lab » du téléphone, puis rescannez le QR code affiché par KeePassXC.

Résultat attendu : l’entrée réapparaît dans l’application et ses codes concordent avec ceux de KeePassXC. Cette opération recopie le secret : elle ne se fait que pour une personne habilitée, face à l’écran, jamais par capture d’écran envoyée.

6. Ranger les codes de secours

Lors de l’activation de la MFA, la plupart des services fournissent des codes de secours à usage unique. Créez une entrée « Lab – alice – codes de secours » et collez-les dans le champ Notes, un par ligne, avec la date de génération. Ajoutez un attribut personnalisé (onglet Advanced) utilises où vous barrerez chaque code consommé.

Résultat attendu : chaque compte MFA de l’équipe possède deux entrées : le TOTP et ses codes de secours, et l’on sait combien de codes restent.

7. Sauvegarder et vérifier la base

Une base TOTP perdue bloque l’accès aux comptes. Copiez le fichier sur un support chiffré hors ligne et vérifiez qu’il s’ouvre ailleurs, en ligne de commande :

keepassxc-cli ls mfa-equipe.kdbx
keepassxc-cli show -t mfa-equipe.kdbx "Lab - alice"

ls liste les entrées après saisie du mot de passe maître ; show -t affiche le code TOTP courant de l’entrée. Résultat attendu : les deux entrées sont listées et le code affiché correspond à celui de l’interface graphique.

Vérification

  • Deux bases distinctes existent, avec deux mots de passe maîtres différents.
  • Le code de l’entrée « Lab – alice » est identique dans KeePassXC, l’application mobile, oathtool et keepassxc-cli show -t.
  • La copie de sauvegarde s’ouvre depuis un autre emplacement et les codes de secours y figurent avec leur date.

Problèmes fréquents

  • Le code KeePassXC est toujours faux. Cause : horloge du poste décalée, ou paramètres personnalisés modifiés par erreur. Correction : resynchroniser l’heure du poste et reconfigurer le TOTP avec les paramètres par défaut.
  • Le menu TOTP n’apparaît pas. Cause : aucune entrée sélectionnée, ou version ancienne. Correction : sélectionner l’entrée avant le clic droit, mettre à jour KeePassXC.
  • keepassxc-cli show -t ne trouve pas l’entrée. Cause : nom ou chemin de groupe inexact (sensible à la casse). Correction : relever le chemin exact avec keepassxc-cli ls.
  • Codes de secours refusés par le service. Cause : codes déjà utilisés ou régénérés depuis. Correction : se connecter avec le TOTP, régénérer les codes et remplacer l’entrée.

Bonnes pratiques et sécurité

  • Séparez la base des seconds facteurs de celle des mots de passe, avec des mots de passe maîtres différents.
  • Pour les comptes d’équipe, au moins deux personnes habilitées doivent pouvoir produire le code, sans partage par messagerie.
  • Sauvegardez la base TOTP hors ligne et testez la restauration à chaque changement important.
  • Régénérez les codes de secours dès qu’un code a été utilisé ou exposé.
  • Activez le verrouillage automatique de KeePassXC après une courte inactivité.

Questions de contrôle

1. Pourquoi ne pas mettre le TOTP dans la même entrée que le mot de passe ?

Voir la réponse

Parce qu’un attaquant qui ouvre la base obtiendrait les deux facteurs en même temps ; la MFA ne protégerait plus contre la compromission du coffre.

2. Que contient réellement le QR code exporté par KeePassXC ?

Voir la réponse

Le secret partagé et ses paramètres : quiconque le scanne peut générer les codes. Il doit être traité comme un mot de passe.

3. Que faire après avoir utilisé un code de secours ?

Voir la réponse

Le marquer comme utilisé, comprendre pourquoi le facteur principal n’était pas disponible, et régénérer les codes s’il en reste peu.

Pour aller plus loin

Conservez la base mfa-equipe.kdbx : vous y rangerez au TP03 les codes d’urgence du serveur SSH.

// formation sur mesure

Former votre équipe sur ce sujet ?

Azur Secure anime des sessions intra-entreprise, à distance ou dans vos locaux sur la Côte d'Azur, adaptées au niveau de vos équipes.

Demander un programme
Défiler vers le haut