Sécuriser Vaultwarden : suppression des configurations obsolètes et protection de l'accès administrateur
Une revue technique de Vaultwarden 1.37.5 révèle des paramètres WebSocket dépassés, des pièges critiques dans la configuration nginx et des risques liés à la sécurité des jetons d'administration pour les auto-hébergeurs.
Traduit automatiquement depuis l’original en anglais.
L'auto-hébergement d'un gestionnaire de mots de passe nécessite plus que le simple lancement d'un conteneur. Une analyse approfondie récente de Vaultwarden version 1.37.5, publiée le 1er novembre 2026, met en évidence la manière dont les configurations par défaut et les guides obsolètes peuvent laisser des failles de sécurité critiques. L'analyse se concentre sur la suppression des variables d'environnement dépréciées, l'application stricte des exigences HTTPS et la gestion correcte des jetons d'accès administratifs.
Ce qui s'est passé
L'article examine l'état actuel de Vaultwarden, une implémentation indépendante en Rust de l'API serveur Bitwarden. Bien qu'il soit souvent comparé à la solution officielle d'auto-hébergement de Bitwarden, le paysage a évolué. Bitwarden Lite propose désormais un déploiement en conteneur unique, remettant en question l'argument historique selon lequel Vaultwarden serait supérieur uniquement grâce à son empreinte réduite. Cependant, Vaultwarden reste distinct par l'absence de serveurs de licences et de restrictions fonctionnelles (feature gates), s'exécutant comme un binaire statique sur une base Debian légère.
Le problème central abordé est la persistance de conseils de configuration obsolètes dans les tutoriels communautaires. De nombreux guides recommandent encore d'activer des ports WebSocket séparés et d'utiliser des préréglages faibles pour les jetons d'administration. L'auteur vérifie ces paramètres contre le code source réel du tag 1.37.5, démontrant que plusieurs recommandations populaires sont non seulement inutiles mais potentiellement nuisibles. Par exemple, le serveur WebSocket séparé a été supprimé dans la version 1.31.0, pourtant de nombreux fichiers compose exposent toujours le port 3012.
De plus, l'article détaille comment les mises à jour des clients dépassent celles des serveurs, entraînant des échecs silencieux de fonctionnalités. La version 1.37.5 est désormais requise pour certaines fonctionnalités d'accès d'urgence et les bascules de connexion à deux étapes dans les nouveaux coffres-forts web. Cette course aux versions signifie que retarder les mises à jour du serveur peut casser la fonctionnalité des clients mobiles et bureautiques à mise à jour automatique, sans messages d'erreur clairs indiquant une incompatibilité de version serveur.
Détails clés
- Le port WebSocket séparé (3012) a été supprimé dans la version 1.31.0 ; la synchronisation en temps réel utilise désormais le port HTTP principal.
- Les configurations Nginx doivent gérer des tailles de corps importantes pour les imports de coffres-forts, nécessitant l'augmentation de
client_max_body_sizeau-delà de la valeur par défaut de 1 Mo. - Les jetons d'administration doivent être générés en utilisant le préréglage par défaut
bitwarden, qui est plus robuste que le préréglageowaspsouvent recommandé dans les anciens guides. - Le paramètre
SIGNUPS_DOMAINS_WHITELISTremplaceSIGNUPS_ALLOWED=false, réouvrant effectivement l'inscription pour les domaines spécifiés. - HTTPS est strictement appliqué par les API Web Crypto des navigateurs et les clients Bitwarden, rendant les déploiements en HTTP simple non fonctionnels pour l'accès à distance.
- Les tentatives incomplètes d'authentification à deux facteurs déclenchent des notifications par e-mail après trois minutes par défaut, un indicateur clé de compromission des identifiants.
Contexte
Vaultwarden agit comme backend pour les clients officiels Bitwarden, gérant le stockage des données tandis que le chiffrement s'effectue localement sur l'appareil de l'utilisateur. Cela signifie que le serveur ne stocke que du texte chiffré, donc une compromission du serveur ne révèle pas directement les mots de passe. Cependant, les métadonnées et l'accès administrateur restent vulnérables. Le système repose sur un proxy inverse, généralement Nginx, pour gérer la terminaison TLS car l'application elle-même ne gère pas les certificats.
La configuration est gérée via des variables d'environnement ou un fichier config.json. Un piège courant est que les valeurs enregistrées dans le panneau d'administration écrivent dans config.json, qui remplace ensuite les variables d'environnement dans le fichier Docker compose. Cela crée de la confusion lorsque les administrateurs mettent à jour leurs fichiers compose sans voir de changements, car le fichier de configuration local a la priorité. Comprendre cette hiérarchie est essentiel pour maintenir un déploiement prévisible et sécurisé.
Pourquoi c'est important
Pour les équipes exécutant leur propre logiciel, les erreurs de configuration de sécurité peuvent mener à des accès non autorisés ou à des interruptions de service. L'utilisation de paramètres WebSocket obsolètes expose des ports inutiles, augmentant la surface d'attaque. De même, une mauvaise configuration de Nginx peut empêcher les utilisateurs d'importer des coffres-forts existants, causant frustration et perte de données potentielle. L'exigence stricte d'HTTPS signifie que toute négligence dans la gestion des certificats cassera immédiatement l'accès pour tous les utilisateurs, car les clients modernes refusent de se connecter via des canaux non chiffrés.
La sécurité administrative est tout aussi critique. Le panneau d'administration offre un contrôle total sur l'instance, y compris la gestion des utilisateurs et les paramètres d'organisation. Si le jeton d'administration est faible ou mal haché, les attaquants pourraient prendre le contrôle total. L'article souligne que l'utilisation du préréglage de hachage plus faible owasp réduit le coût computationnel pour les attaquants tentant de forcer le jeton par brute-force. De plus, une mauvaise compréhension des listes blanches d'inscription peut permettre involontairement l'inscription publique, transformant une instance privée en cible publique.
Que pouvez-vous faire
- Supprimez
WEBSOCKET_ENABLEDetWEBSOCKET_PORTde votre fichier Docker compose, car ils sont dépréciés. - Générez des jetons d'administration en utilisant le préréglage par défaut
bitwardenvia l'outil en ligne de commande pour garantir une force de hachage maximale. - Configurez Nginx avec
client_max_body_size 128Mpour supporter les gros imports de coffres-forts et éviter les échecs silencieux d'upload. - Vérifiez votre version de Nginx avant d'utiliser
http2 on; utilisezlisten 443 ssl http2;pour les versions antérieures à 1.25.1 afin d'éviter les erreurs de démarrage. - Définissez
SIGNUPS_ALLOWEDsurfalseet évitez d'utiliserSIGNUPS_DOMAINS_WHITELISTsauf si vous avez spécifiquement l'intention d'autoriser l'inscription ouverte pour ces domaines. - Surveillez les e-mails d'authentification à deux facteurs incomplètes comme signe potentiel d'attaques par stuffing d'identifiants contre vos utilisateurs.


