Accueil » Formations » Hygiène numérique » Gestion des mots de passe avec Vaultwarden

Gestion des mots de passe avec Vaultwarden

Les mots de passe restent la porte d’entrée la plus utilisée par les attaquants : réutilisation d’un même secret sur plusieurs services, mots de passe devinables, identifiants volés par hameçonnage puis rejoués ailleurs. Ce cours montre comment une PME ou une équipe technique peut reprendre la main avec un gestionnaire de mots de passe auto-hébergé : Vaultwarden, une implémentation libre du serveur Bitwarden, utilisée avec les clients officiels Bitwarden (extension de navigateur, applications, ligne de commande).

À qui s’adresse ce cours ? Administrateurs systèmes, techniciens et responsables informatiques de PME qui veulent déployer, sécuriser et exploiter un coffre-fort de mots de passe partagé. Prérequis : bases de Linux, de Docker et de HTTPS.

1. Pourquoi les mots de passe restent le maillon faible

Un mot de passe n’est qu’un secret partagé entre l’utilisateur et le service. Il est perdu dès qu’il est deviné, réutilisé, intercepté ou volé dans une base de données compromise. Trois scénarios reviennent dans la quasi-totalité des incidents :

  • Le bourrage d’identifiants (credential stuffing) : des couples identifiant / mot de passe issus d’une fuite sont rejoués automatiquement sur d’autres sites. Un salarié qui utilise le même mot de passe pour un forum et pour la messagerie de l’entreprise ouvre la porte à l’attaquant.
  • L’attaque par dictionnaire ou par force brute : les mots de passe courts ou construits sur des schémas prévisibles (prénom + année, saison + point d’exclamation) tombent en quelques secondes hors ligne.
  • L’hameçonnage : l’utilisateur saisit lui-même son mot de passe sur une fausse page de connexion.

Demander aux utilisateurs de retenir des dizaines de mots de passe longs, uniques et aléatoires est irréaliste. Le gestionnaire de mots de passe résout ce problème : l’utilisateur ne retient qu’un seul secret fort (le mot de passe maître), et l’outil génère, stocke et remplit tous les autres.

2. Ce que disent les recommandations

En France, la CNIL a publié en 2022 une recommandation relative aux mots de passe. Elle raisonne en entropie, c’est-à-dire en nombre de combinaisons qu’un attaquant doit tester, plutôt qu’en règles de complexité figées. Pour un mot de passe utilisé seul, elle fixe un minimum de 80 bits et donne des exemples équivalents :

  • 12 caractères minimum mêlant majuscules, minuscules, chiffres et caractères spéciaux ;
  • 14 caractères minimum mêlant majuscules, minuscules et chiffres, sans caractère spécial obligatoire ;
  • une phrase de passe d’au moins 7 mots.

Lorsque l’accès est complété par des mesures de restriction (blocage temporaire après plusieurs échecs, limitation du nombre de tentatives), le seuil descend à 50 bits. La même recommandation n’impose plus le renouvellement périodique pour les comptes standards, mais le maintient pour les comptes à privilèges, et rappelle que les mots de passe ne doivent jamais être stockés en clair : ils doivent être transformés par une fonction non réversible, salée, comme scrypt ou Argon2.

Bonne pratique : pour le mot de passe maître, privilégiez une phrase de passe d’au moins 7 mots tirés au hasard. Elle est plus facile à mémoriser qu’une suite de caractères aléatoires et offre une entropie élevée. Pour tous les autres comptes, laissez le générateur du gestionnaire produire des mots de passe longs et uniques.

3. Le gestionnaire de mots de passe : principe et modèle de menace

Un gestionnaire de mots de passe sérieux repose sur le chiffrement de bout en bout : le coffre est chiffré et déchiffré sur le poste de l’utilisateur, à partir d’une clé dérivée de son mot de passe maître. Le serveur ne stocke que des données chiffrées et ne connaît jamais ce mot de passe maître. C’est le modèle de Bitwarden : le chiffrement est réalisé par les clients, le serveur synchronise des données qu’il ne peut pas lire.

Ce modèle a trois conséquences pratiques :

  • une fuite de la base du serveur n’expose pas directement les mots de passe, à condition que les mots de passe maîtres soient robustes ;
  • un mot de passe maître oublié ne peut pas être « réinitialisé » par l’administrateur comme un compte classique : sans mécanisme prévu à l’avance (accès d’urgence, réinitialisation par l’organisation), le coffre personnel est perdu ;
  • le poste client reste un point critique : un poste compromis par un logiciel espion peut capturer le mot de passe maître lors de sa saisie. Le gestionnaire ne remplace pas l’hygiène du poste (mises à jour, antivirus, droits limités).

Le gestionnaire aide aussi contre l’hameçonnage : l’extension de navigateur ne propose le remplissage automatique que si l’adresse du site correspond à celle enregistrée. Si l’extension ne propose rien sur une page de connexion qui ressemble à celle de votre banque, c’est un signal d’alerte.

4. Bitwarden et Vaultwarden : qui fait quoi

Bitwarden est un gestionnaire de mots de passe open source, disponible en service hébergé ou en auto-hébergement. Vaultwarden est une implémentation alternative et non officielle de l’API du serveur Bitwarden, écrite en Rust et beaucoup plus légère que le serveur officiel : un seul conteneur, une base SQLite par défaut, quelques dizaines de mégaoctets de mémoire. Le projet précise lui-même qu’il n’est pas associé à Bitwarden, Inc. Au moment de la rédaction, la branche maintenue est la 1.37 (version 1.37.4 publiée en octobre 2026) ; vérifiez toujours la dernière version sur la page des publications du projet.

Vaultwarden prend en charge la quasi-totalité des fonctionnalités utiles à une PME :

  • coffres personnels, pièces jointes, Send (partage temporaire de texte ou de fichiers), icônes de sites ;
  • organisations avec collections, partage de mots de passe, rôles des membres, groupes, journaux d’événements, politiques ;
  • double authentification : application d’authentification (TOTP), e-mail, FIDO2 WebAuthn, YubiKey, Duo ;
  • accès d’urgence et page d’administration propre à Vaultwarden.

Les utilisateurs se servent des clients officiels Bitwarden : extension de navigateur, application de bureau, application mobile, coffre web (embarqué dans l’image Vaultwarden) et interface en ligne de commande bw. Il suffit de leur indiquer l’adresse du serveur auto-hébergé.

Pour un usage strictement individuel et hors ligne, un gestionnaire local comme KeePassXC reste une excellente option. Vaultwarden prend l’avantage dès qu’il faut synchroniser plusieurs appareils et partager des secrets au sein d’une équipe, avec des droits différenciés.

5. Architecture de référence

L’architecture retenue dans ce cours est volontairement simple et reproductible :

  • Clients (navigateur, extension, application, bw) : ils se connectent en HTTPS sur le port 443 au nom du service, par exemple vault.lab.test en laboratoire.
  • Proxy inverse Caddy : il termine le TLS, obtient ou génère le certificat et transmet les requêtes au conteneur Vaultwarden en ajoutant l’en-tête X-Real-IP qui porte l’adresse réelle du client.
  • Conteneur Vaultwarden : il écoute en HTTP sur le port 80, uniquement sur le réseau interne de Docker, sans port publié sur l’hôte.
  • Volume de données /data : base SQLite, pièces jointes, clés de signature, configuration et journaux.

Schéma décrit : à gauche les postes clients ; une flèche « HTTPS 443 » mène au conteneur Caddy ; une flèche « HTTP 80, réseau Docker interne » relie Caddy au conteneur Vaultwarden ; sous Vaultwarden, un cylindre « vw-data » représente le volume persistant, lui-même copié vers une cible de sauvegarde.

Pourquoi HTTPS est indispensable : le coffre web de Bitwarden utilise les API de cryptographie du navigateur (Web Crypto), que la plupart des navigateurs ne rendent disponibles que dans un contexte sécurisé, c’est-à-dire en HTTPS. Sans HTTPS, la connexion au coffre web échoue. La documentation de Vaultwarden déconseille de confier le TLS au serveur lui-même (option ROCKET_TLS) et recommande un proxy inverse.

En production, Caddy obtient automatiquement un certificat public (ACME) pour un nom de domaine réel. En laboratoire, la directive tls internal lui fait utiliser sa propre autorité de certification locale ; il faut alors installer le certificat racine de cette autorité sur les postes clients.

6. Déploiement avec Docker Compose

La documentation de Vaultwarden fournit des modèles Docker Compose. L’image officielle est vaultwarden/server. Voici la base utilisée dans les TP, avec Caddy en frontal :

services:
  vaultwarden:
    image: vaultwarden/server:latest
    container_name: vaultwarden
    restart: always
    environment:
      DOMAIN: "https://vault.lab.test"
      SIGNUPS_ALLOWED: "true"
    volumes:
      - ./vw-data:/data

  caddy:
    image: caddy:2
    container_name: caddy
    restart: always
    ports:
      - 80:80
      - 443:443
    volumes:
      - ./Caddyfile:/etc/caddy/Caddyfile:ro
      - ./caddy-config:/config
      - ./caddy-data:/data

Les variables d’environnement essentielles :

  • DOMAIN : l’URL publique complète, en https://. Elle est requise derrière un proxy inverse ; Vaultwarden en a besoin notamment pour les pièces jointes et les liens envoyés par e-mail.
  • SIGNUPS_ALLOWED : par défaut, toute personne qui atteint l’instance peut créer un compte. On le laisse à true le temps de créer le premier compte, puis on le passe à false.
  • SIGNUPS_DOMAINS_WHITELIST : limite les inscriptions à certains domaines de messagerie (par exemple example.com). Si elle est renseignée, SIGNUPS_ALLOWED est ignorée ; on l’associe à SIGNUPS_VERIFY=true pour imposer la vérification de l’adresse e-mail.
  • ADMIN_TOKEN : active la page d’administration (chapitre 7).
  • LOG_FILE : écrit les journaux dans un fichier, en plus de la sortie standard (chapitre 10).

Attention à config.json : les réglages enregistrés depuis la page d’administration sont écrits dans /data/config.json et prennent le pas sur les variables d’environnement correspondantes. Si une variable modifiée dans le fichier Compose semble sans effet, vérifiez d’abord ce fichier.

Pour appliquer une modification du fichier Compose, il suffit de relancer docker compose up -d : Docker Compose recrée les conteneurs dont la configuration a changé.

7. Page d’administration et ADMIN_TOKEN

Vaultwarden propose une page d’administration à l’adresse /admin : liste des utilisateurs, invitations, désactivation de comptes, diagnostic, réglages. Elle n’est active que si la variable ADMIN_TOKEN est définie. Ce jeton doit être traité comme un mot de passe d’administrateur.

Un jeton en clair fonctionne mais déclenche l’avertissement « You are using a plain text ADMIN_TOKEN which is insecure ». La bonne pratique est de stocker un hachage Argon2 au format PHC, généré par la commande intégrée :

docker compose exec vaultwarden /vaultwarden hash --preset owasp

La commande demande deux fois le mot de passe choisi et affiche une chaîne commençant par $argon2id$. L’option --preset owasp applique les paramètres minimaux recommandés par l’OWASP ; sans elle, les paramètres par défaut de Bitwarden sont utilisés.

Cette chaîne contient des caractères $ que Docker Compose interprète comme des variables. Deux solutions documentées : doubler chaque $ ($$) si la valeur est écrite dans la section environment, ou la placer entre apostrophes simples, sans doublement, dans un fichier .env. Les TP utilisent la seconde méthode, plus lisible.

Bonne pratique : ne publiez pas /admin sur Internet si ce n’est pas nécessaire. Restreignez-le au réseau d’administration au niveau du proxy inverse, protégez-le par Fail2ban (chapitre 10) et conservez le mot de passe d’administration hors de Vaultwarden, par exemple dans un gestionnaire hors ligne réservé aux administrateurs.

8. Organisations, collections et partage

Le partage de secrets est la principale raison de déployer Vaultwarden en entreprise. Il repose sur trois notions :

  • Organisation : l’entité qui possède les éléments partagés (par exemple « Azur Lab »). Un utilisateur peut appartenir à plusieurs organisations, en plus de son coffre personnel.
  • Collection : un dossier partagé au sein de l’organisation (« Infrastructure », « Comptabilité », « Réseaux sociaux »). Les droits sont attribués par collection : lecture seule, masquage des mots de passe, modification.
  • Rôles des membres : propriétaire, administrateur, gestionnaire, utilisateur. On réserve les rôles élevés à deux ou trois personnes.

L’entrée dans une organisation suit un circuit en trois temps : invitation, acceptation par l’utilisateur, puis confirmation par un administrateur de l’organisation. Cette dernière étape échange les clés de chiffrement : tant qu’elle n’est pas faite, le membre ne voit pas les éléments partagés.

Avec SIGNUPS_ALLOWED=false, les propriétaires et administrateurs d’organisation peuvent toujours inviter de nouveaux utilisateurs, et la page d’administration peut inviter n’importe quelle adresse. Sans serveur SMTP configuré, aucun e-mail n’est envoyé : l’utilisateur invité crée alors son compte avec l’adresse invitée depuis la page d’inscription du coffre web.

Bonne pratique : structurez les collections par usage et par équipe, pas par personne. Un départ de salarié se traite alors en retirant le membre de l’organisation, puis en changeant les mots de passe des collections auxquelles il avait accès.

9. Double authentification et récupération

Le coffre concentre tous les secrets : il doit être protégé par une authentification multifacteur. Vaultwarden prend en charge plusieurs méthodes de connexion en deux étapes, activées par chaque utilisateur dans Paramètres → Sécurité → Connexion en deux étapes :

  • Application d’authentification (TOTP) : codes à 6 chiffres générés par une application sur smartphone ; c’est la méthode la plus simple à généraliser.
  • FIDO2 WebAuthn et YubiKey : clés de sécurité matérielles, résistantes à l’hameçonnage ; à privilégier pour les administrateurs.
  • E-mail et Duo : utiles dans certains contextes, l’e-mail nécessite un serveur SMTP configuré.

À l’activation, le coffre web fournit un code de récupération. Il permet de désactiver la double authentification si le second facteur est perdu. Il doit être imprimé ou conservé hors du coffre, sinon il est inutile au moment où on en a besoin.

Pour les situations de départ ou d’indisponibilité, l’accès d’urgence permet de désigner un contact de confiance qui pourra, après un délai d’attente que le titulaire peut refuser, consulter ou reprendre le coffre. Au niveau de l’organisation, les politiques permettent notamment d’exiger la connexion en deux étapes pour tous les membres.

10. Exploitation : journaux, Fail2ban et mises à jour

Vaultwarden écrit ses journaux sur la sortie standard (docker compose logs vaultwarden). La variable LOG_FILE=/data/vaultwarden.log ajoute une copie dans un fichier du volume, ce qui permet à un outil comme Fail2ban de les analyser depuis l’hôte. Le niveau de détail se règle avec LOG_LEVEL (valeurs trace, debug, info, warn, error, off), qui nécessite EXTENDED_LOGGING=true.

Chaque échec de connexion produit une ligne contenant « Username or password is incorrect. Try again. IP: … » et chaque jeton d’administration invalide une ligne « Invalid admin token. IP: … ». Fail2ban s’appuie sur ces messages pour bannir les adresses qui multiplient les échecs. Deux points de vigilance :

  • l’adresse journalisée doit être celle du client réel : c’est le rôle de l’en-tête X-Real-IP ajouté par Caddy ;
  • le trafic à destination d’un conteneur traverse la chaîne FORWARD du pare-feu et non INPUT : la règle de bannissement doit cibler cette chaîne, comme l’indique la documentation de Vaultwarden.

Les mises à jour se font en deux commandes, après une sauvegarde : docker compose pull puis docker compose up -d. Lisez les notes de version avant chaque montée de version : les clients Bitwarden évoluent vite, et une version récente des clients peut exiger une version récente du serveur.

11. Sauvegarde et restauration

Tout l’état de Vaultwarden se trouve dans le répertoire de données. La documentation du projet classe ses éléments par importance :

  • db.sqlite3 (indispensable) : la base principale, qui contient la quasi-totalité des données ; sauvegardez aussi db.sqlite3-wal s’il existe ;
  • attachments/ (indispensable) : les pièces jointes des éléments du coffre ;
  • config.json (recommandé) : la configuration saisie dans la page d’administration ; il contient des secrets en clair ;
  • rsa_key* (recommandé) : les clés qui signent les jetons de connexion ; les perdre déconnecte tous les utilisateurs ;
  • sends/ et icon_cache/ (facultatifs).

Copier db.sqlite3 pendant que le service écrit peut produire une copie incohérente. On utilise l’API de sauvegarde en ligne de SQLite :

sqlite3 vw-data/db.sqlite3 ".backup '/srv/backup/db-$(date '+%Y%m%d-%H%M').sqlite3'"

Pour restaurer : arrêter Vaultwarden, remplacer les fichiers par leur copie de sauvegarde, supprimer un éventuel db.sqlite3-wal résiduel si l’on restaure un fichier produit par .backup, puis redémarrer. Les sauvegardes, qui contiennent des secrets, doivent être chiffrées et suivre la règle 3-2-1 : un outil comme Restic convient parfaitement pour les envoyer hors site.

Bonne pratique : une sauvegarde qui n’a jamais été restaurée n’est qu’une hypothèse. Planifiez un test de restauration sur une machine isolée au moins une fois par trimestre, et documentez la procédure.

12. Déployer en PME : politique d’usage et check-list

La technique ne suffit pas : l’adoption dépend d’une politique claire et d’un accompagnement des utilisateurs. Points à formaliser :

  • le gestionnaire est l’outil obligatoire pour les mots de passe professionnels ; les tableurs et carnets sont proscrits ;
  • le mot de passe maître est une phrase de passe d’au moins 7 mots, jamais réutilisée ailleurs ;
  • la double authentification est obligatoire, avec une clé de sécurité pour les administrateurs ;
  • les mots de passe partagés sont rangés dans les collections prévues, jamais envoyés par e-mail ou messagerie ;
  • la procédure de départ prévoit le retrait de l’organisation et le renouvellement des secrets exposés.

Le déploiement se conduit comme un petit projet de changement. Commencez par un groupe pilote de quelques volontaires, idéalement l’équipe informatique et un service métier, pendant deux à quatre semaines. Ce pilote permet de valider l’architecture, de rédiger un guide d’utilisation d’une page et de repérer les sites ou applications qui posent problème au remplissage automatique. Prévoyez ensuite une courte session de prise en main par service : installation de l’extension, choix de la phrase de passe maître, activation de la double authentification, import des mots de passe existants depuis le navigateur, puis suppression de ces mots de passe du navigateur.

Mesurez l’adoption plutôt que de la supposer : nombre de comptes actifs dans la page d’administration, nombre d’éléments dans les collections partagées, part des utilisateurs ayant activé la double authentification. Enfin, faites vivre le dispositif : rappel annuel des bonnes pratiques, revue des membres de chaque collection à chaque départ ou changement de poste, et exercice de restauration consigné.

Check-list technique avant la mise en production :

  1. HTTPS avec un certificat valide et DOMAIN renseigné ;
  2. inscriptions fermées (SIGNUPS_ALLOWED=false) ou limitées à votre domaine ;
  3. ADMIN_TOKEN haché en Argon2, page /admin restreinte ;
  4. SMTP configuré pour les invitations et les alertes ;
  5. journaux dans un fichier et Fail2ban actif sur le coffre et sur /admin ;
  6. sauvegarde quotidienne chiffrée, copie hors site, test de restauration réalisé ;
  7. procédure de mise à jour et veille sur les publications du projet.

Les travaux pratiques ci-dessous déroulent cette check-list pas à pas dans un laboratoire, du déploiement initial jusqu’à l’exercice de restauration.

Évaluation : Gestion des mots de passe avec Vaultwarden

Répondez aux questions puis vérifiez votre score. Une seule bonne réponse par question.

1. Dans le modèle de Bitwarden utilisé par Vaultwarden, où les données du coffre sont-elles chiffrées ?
2. Pourquoi HTTPS est-il indispensable pour utiliser le coffre web ?
3. Quel réglage empêche un inconnu de créer un compte sur votre instance ?
4. Comment stocker correctement la valeur de ADMIN_TOKEN ?
5. Vous avez modifié un réglage depuis la page /admin. La variable d’environnement correspondante n’a plus d’effet. Pourquoi ?
6. Un technicien a rejoint l’organisation mais ne voit aucun élément partagé. Quelle étape manque le plus probablement ?
7. Fail2ban détecte bien les échecs, mais l’attaquant accède toujours au coffre servi par des conteneurs. Quelle est la cause la plus probable ?
8. Quelle méthode permet de sauvegarder db.sqlite3 de façon cohérente pendant que Vaultwarden fonctionne ?

Pour aller plus loin sur le blog : Vaultwarden : le gestionnaire de mots de passe auto-hébergé · KeePass et KeePassXC : deux gardiens de vos mots de passe · L’authentification multifacteur : renforcez la sécurité

Défiler vers le haut