Accueil » Actualités » Identités & accès » Vaultwarden : le gestionnaire de mots de passe auto-hébergé compatible Bitwarden
Logo de Vaultwarden — Vaultwarden : un gestionnaire de mots de passe auto-hébergé compatible Bitwarden

Vaultwarden : le gestionnaire de mots de passe auto-hébergé compatible Bitwarden

Pourquoi auto-héberger son gestionnaire de mots de passe ?

Comptes d’administration partagés dans un tableur, mots de passe de routeurs notés dans un wiki, accès fournisseurs transmis par messagerie : dans beaucoup de PME et d’équipes IT, la gestion des secrets reste artisanale. Les coffres individuels comme KeePass et KeePassXC règlent le problème pour une personne, mais deviennent vite inadaptés dès qu’il faut partager des accès, révoquer un collaborateur ou synchroniser plusieurs appareils.

Les gestionnaires en SaaS répondent à ce besoin, mais certaines organisations préfèrent garder la maîtrise de l’hébergement : exigences de souveraineté, politique interne, réseau isolé ou simple volonté de ne pas dépendre d’un tiers. C’est précisément le créneau de Vaultwarden.

Qu’est-ce que Vaultwarden ?

Vaultwarden est un serveur non officiel compatible avec l’API de Bitwarden, écrit en Rust et publié sous licence AGPL-3.0. Connu à l’origine sous le nom de bitwarden_rs, il réimplémente l’API utilisée par les clients Bitwarden : vous continuez donc à utiliser les applications officielles (extensions de navigateur, applications mobiles et de bureau, CLI), mais elles se connectent à votre propre serveur. Le projet, maintenu sur GitHub par Daniel García et sa communauté, dépasse les 70 000 étoiles.

Point important : le projet précise explicitement qu’il n’est pas associé à Bitwarden, Inc. Les bugs doivent donc être remontés aux mainteneurs de Vaultwarden, jamais au support de Bitwarden.

Les fonctionnalités prises en charge sont larges :

  • coffre personnel, Send (partage temporaire), pièces jointes, icônes de sites et clé d’API personnelle ;

  • organisations : collections, partage de mots de passe, rôles des membres, groupes, journaux d’événements, réinitialisation du mot de passe par un administrateur, politiques et Directory Connector ;

  • authentification multifacteur : application TOTP, e-mail, FIDO2 WebAuthn, YubiKey et Duo ;

  • accès d’urgence, page d’administration dédiée et client web (web vault) intégré aux images Docker.

Architecture et fonctionnement

Vaultwarden se présente sous la forme d’un binaire unique qui sert à la fois l’API et le web vault. Sa sobriété en ressources est son principal argument : là où le déploiement standard de Bitwarden auto-hébergé repose sur plusieurs conteneurs, Vaultwarden tourne confortablement sur un petit serveur, une VM modeste ou un NAS.

Côté stockage, il utilise par défaut SQLite et sait aussi s’appuyer sur MariaDB/MySQL ou PostgreSQL. Toutes les données persistantes (base, pièces jointes, Sends, clés RSA, fichier config.json) se trouvent dans le répertoire /data du conteneur.

Comme avec Bitwarden, le chiffrement est réalisé côté client : le serveur ne stocke que des données chiffrées à partir du mot de passe maître de l’utilisateur. Conséquence pratique : le web vault exige un contexte sécurisé HTTPS pour accéder à l’API Web Crypto du navigateur. Un reverse proxy avec certificat TLS est donc indispensable, même en interne.

Installation avec Docker

La méthode recommandée par le projet repose sur Docker et l’image officielle vaultwarden/server. Voici la commande de démarrage donnée dans la documentation, suivie de la génération d’un jeton d’administration haché en Argon2 :

docker pull vaultwarden/server:latest

docker run --detach --name vaultwarden \
  --env DOMAIN="https://vw.domain.tld" \
  --volume /vw-data/:/data/ \
  --restart unless-stopped \
  --publish 127.0.0.1:8000:80 \
  vaultwarden/server:latest

# Générer le hash Argon2 du jeton d'administration
docker exec -it vaultwarden /vaultwarden hash
# Variante avec les paramètres minimaux recommandés par l'OWASP
docker exec -it vaultwarden /vaultwarden hash --preset owasp

Le service n’écoute ici que sur 127.0.0.1:8000 : c’est volontaire, l’exposition doit passer par un reverse proxy qui termine le TLS (Nginx, Caddy ou Traefik par exemple). La variable DOMAIN doit correspondre exactement à l’URL publique, schéma https:// compris.

Configuration et sécurisation de l’instance

La page /admin n’est active que si la variable ADMIN_TOKEN est définie. Depuis plusieurs versions, Vaultwarden accepte une chaîne PHC Argon2 ($argon2id$v=19$...) plutôt qu’un jeton en clair : vous vous connectez ensuite avec le mot de passe qui a été haché, jamais avec la chaîne elle-même. Avec Docker Compose, deux pièges classiques : placer la valeur entre guillemets simples dans un fichier .env, ou doubler chaque $ si elle est écrite directement dans le fichier compose. Notez aussi qu’une configuration enregistrée depuis l’interface d’administration (config.json) prime sur les variables d’environnement.

Les autres réglages essentiels :

  • SIGNUPS_ALLOWED=false pour fermer les inscriptions libres une fois les comptes créés, puis inviter les utilisateurs depuis la page d’administration ou une organisation ;

  • une configuration SMTP pour les invitations, les codes 2FA par e-mail et les notifications ;

  • une protection contre la force brute, par exemple avec Fail2Ban (documenté dans le wiki) ou CrowdSec ;

  • la durée de session admin (ADMIN_SESSION_LIFETIME, 20 minutes par défaut).

Authentification unique (SSO) via OpenID Connect

Vaultwarden prend en charge le SSO OpenID Connect avec les variables SSO_ENABLED, SSO_AUTHORITY, SSO_CLIENT_ID et SSO_CLIENT_SECRET, et SSO_ONLY pour désactiver la connexion par e-mail. Le wiki fournit des exemples pour authentik, Keycloak, Authelia, Kanidm, Zitadel ou Microsoft Entra ID. Attention à une nuance de taille : le SSO authentifie l’utilisateur, mais le mot de passe maître reste obligatoire pour déchiffrer le coffre et n’est pas contrôlé par le fournisseur d’identité. Les versions 1.37.x ont continué à faire évoluer cette fonctionnalité, avec par exemple SSO_SIGNUPS_ALLOWED en 1.37.3.

Pour un déploiement durable, privilégiez un fichier Docker Compose avec les secrets dans un .env, et prévoyez dès le départ la sauvegarde du répertoire de données :

# docker-compose.yml
services:
  vaultwarden:
    image: vaultwarden/server:latest
    container_name: vaultwarden
    restart: unless-stopped
    environment:
      DOMAIN: "https://vault.example.fr"
      SIGNUPS_ALLOWED: "false"
      ADMIN_TOKEN: ${VAULTWARDEN_ADMIN_TOKEN}
    volumes:
      - ./vw-data/:/data/
    ports:
      - 127.0.0.1:8000:80

# .env (guillemets simples obligatoires)
# VAULTWARDEN_ADMIN_TOKEN='$argon2id$v=19$m=65540,t=3,p=4$...'

# Sauvegarde cohérente de la base SQLite
sqlite3 ./vw-data/db.sqlite3 ".backup './backup/db-$(date +%F).sqlite3'"

Utilisation au quotidien

Une fois l’instance en ligne, chaque utilisateur crée son compte (ou accepte son invitation), puis renseigne l’URL du serveur auto-hébergé dans les paramètres de connexion des clients Bitwarden. Pour les équipes, la logique repose sur les organisations et les collections : une collection « Infrastructure » pour les accès hyperviseurs et équipements réseau, une autre pour les comptes fournisseurs, avec des droits par groupe. Les journaux d’événements permettent de savoir qui a consulté ou modifié une entrée, un élément utile lors d’un audit ou d’un départ de collaborateur.

Un point de vigilance opérationnel : les clients Bitwarden évoluent vite, et certaines versions de Vaultwarden sont nécessaires pour les clients récents (la 1.37.0 pour les clients 2026.7.0 et suivants, la 1.37.2 pour les clients 2026.8.0 et suivants). Une instance non mise à jour finit donc par poser des problèmes de compatibilité, en plus des risques de sécurité. La version 1.37.4, publiée en octobre 2026, corrige d’ailleurs plusieurs vulnérabilités, dont une jugée élevée sur la révocation des membres d’organisation.

Vaultwarden face aux alternatives

  • Bitwarden auto-hébergé (officiel) : bénéficie du support de l’éditeur et des audits du produit, mais son déploiement standard est plus lourd et certaines fonctions entreprise nécessitent une licence payante.

  • Passbolt : gestionnaire open source pensé pour le travail en équipe, fondé sur OpenPGP, avec une approche différente du partage.

  • KeePassXC : idéal pour un usage individuel hors ligne, sans serveur, mais le partage et la révocation d’accès reposent sur la gestion du fichier.

  • Vaultwarden : très léger, compatible avec l’écosystème de clients Bitwarden, riche fonctionnellement, mais sans support commercial ni lien avec l’éditeur.

Bonnes pratiques

  • Exposez l’instance uniquement en HTTPS, idéalement derrière un VPN ou une liste d’adresses autorisées pour la page /admin.

  • Imposez l’authentification multifacteur via les politiques d’organisation, en privilégiant FIDO2 WebAuthn.

  • Désactivez les inscriptions publiques et utilisez un jeton d’administration haché en Argon2.

  • Sauvegardez régulièrement l’ensemble du répertoire /data (base, pièces jointes, clés RSA, config.json) avec un outil chiffré comme Restic, et testez la restauration.

  • Suivez les publications GitHub du projet et appliquez rapidement les correctifs de sécurité.

  • Préparez une procédure d’urgence : comptes de secours, accès d’urgence et export chiffré hors ligne.

Cas d’usage et points de vigilance

Vaultwarden trouve naturellement sa place dans plusieurs contextes : une PME qui veut remplacer un fichier partagé de mots de passe, une équipe d’infogérance qui gère les accès de nombreux clients dans des organisations séparées, un laboratoire ou un homelab qui souhaite tester l’écosystème Bitwarden sans abonnement. Dans un environnement soumis à des exigences de conformité, la maîtrise de l’hébergement et des journaux d’événements facilite aussi la démonstration du contrôle des accès privilégiés.

Il faut toutefois garder en tête quelques limites. Vaultwarden étant un projet communautaire, il n’existe ni contrat de support ni engagement de délai de correction. La compatibilité avec les clients dépend de la réactivité des mainteneurs face aux évolutions de Bitwarden. Enfin, le serveur devient une cible de grande valeur : si les données sont chiffrées côté client, une compromission du serveur ou du web vault servi aux utilisateurs reste un scénario à prendre au sérieux. Traitez donc cette instance comme un composant critique : système durci, accès d’administration restreint, supervision des journaux et plan de reprise documenté.

Conclusion

Vaultwarden offre une voie simple et économe pour disposer d’un coffre de mots de passe d’équipe sous votre contrôle, tout en conservant l’ergonomie des clients Bitwarden. Ce choix implique en revanche d’assumer l’exploitation : TLS, mises à jour, sauvegardes et surveillance. Bien administré et couplé à votre fournisseur d’identité, il devient une brique solide de votre politique d’identités et d’accès.

À lire aussi : FreeIPA : l’Active Directory du monde Linux · Zero Trust : repenser la sécurité des réseaux

Partagez cet article !
Défiler vers le haut