Härtung von Vaultwarden: Entfernen veralteter Konfigurationen und Absicherung des Admin-Zugriffs
Eine technische Überprüfung von Vaultwarden 1.37.5 deckt veraltete WebSocket-Einstellungen, kritische Fehler in der nginx-Konfiguration sowie Sicherheitsrisiken bei Admin-Tokens für Self-Hoster auf.
Automatisch aus dem englischen Original übersetzt.
Das Selbsthosting eines Passwortmanagers erfordert mehr als nur das Starten eines Containers. Eine aktuelle tiefgehende Analyse von Vaultwarden Version 1.37.5, veröffentlicht am 1. November 2026, zeigt, wie Standardkonfigurationen und veraltete Anleitungen zu kritischen Sicherheitslücken führen können. Die Untersuchung konzentriert sich auf die Entfernung missbilligter Umgebungsvariablen, die Durchsetzung strenger HTTPS-Anforderungen und die korrekte Verwaltung administrativer Zugriffstoken.
Was passiert ist
Der Artikel untersucht den aktuellen Stand von Vaultwarden, einer unabhängigen Rust-Implementierung der Bitwarden-Server-API. Obwohl es oft mit der offiziellen Bitwarden-Self-Hosting-Lösung verglichen wird, hat sich die Landschaft verändert. Bitwarden Lite bietet nun eine Einzelcontainer-Bereitstellung an und stellt damit das historische Argument infrage, dass Vaultwarden allein aufgrund seiner kleineren Ressourcenanforderungen überlegen sei. Dennoch bleibt Vaultwarden einzigartig durch den Verzicht auf Lizenzserver und Feature-Gates; es läuft als statische Binärdatei auf einer schlanken Debian-Basis.
Das Kernproblem betrifft die Beharrlichkeit veralteter Konfigurationsratschläge in Community-Tutorials. Viele Anleitungen empfehlen weiterhin, separate WebSocket-Ports zu aktivieren und schwache Voreinstellungen für Admin-Token zu verwenden. Der Autor überprüft diese Einstellungen anhand des tatsächlichen Quellcodes des Tags 1.37.5 und zeigt, dass mehrere populäre Empfehlungen nicht nur unnötig, sondern potenziell schädlich sind. Beispielsweise wurde der separate WebSocket-Server in Version 1.31.0 entfernt, dennoch exponieren viele Compose-Dateien weiterhin Port 3012.
Darüber hinaus erläutert der Artikel, wie Client-Updates Server-Updates überholen, was zu stillschweigenden Funktionsausfällen führt. Version 1.37.5 ist nun für bestimmte Notfallzugriffs-Funktionen und Zwei-Stufen-Login-Umschalter in neueren Web-Vaults erforderlich. Dieser Versionslauf bedeutet, dass das Zurückhalten von Server-Updates die Funktionalität in automatisch aktualisierten mobilen und Desktop-Clients brechen kann, ohne dass klare Fehlermeldungen auf die Versionsinkonsistenz des Servers hinweisen.
Wichtige Details
- Der separate WebSocket-Port (3012) wurde in Version 1.31.0 entfernt; die Echtzeitsynchronisierung nutzt nun den Haupt-HTTP-Port.
- Nginx-Konfigurationen müssen große Body-Größen für Vault-Importe verarbeiten, wobei
client_max_body_sizevom Standardwert von 1 MB erhöht werden muss. - Admin-Token sollten unter Verwendung der Standardvoreinstellung
bitwardengeneriert werden, die stärker ist als die in älteren Anleitungen oft empfohlene Voreinstellungowasp. - Die Einstellung
SIGNUPS_DOMAINS_WHITELISTüberschreibtSIGNUPS_ALLOWED=falseund öffnet die Registrierung für angegebene Domains effektiv wieder. - HTTPS wird streng von den Browser-Web-Crypto-APIs und Bitwarden-Clients erzwungen, wodurch Plain-HTTP-Bereitstellungen für den Fernzugriff funktionsunfähig sind.
- Unvollständige Zwei-Faktor-Authentifizierungsversuche lösen standardmäßig nach drei Minuten E-Mail-Benachrichtigungen aus, ein wichtiger Indikator für kompromittierte Zugangsdaten.
Hintergrund
Vaultwarden fungiert als Backend für offizielle Bitwarden-Clients und verwaltet die Datenspeicherung, während die Verschlüsselung lokal auf dem Gerät des Benutzers erfolgt. Das bedeutet, dass der Server nur Chiffretext speichert, sodass ein Serverkompromittierung keine Passwörter direkt offenlegt. Metadaten und der Admin-Zugriff bleiben jedoch anfällig. Das System verlässt sich auf einen Reverse Proxy, typischerweise Nginx, um die TLS-Beendigung zu handhaben, da die Anwendung selbst keine Zertifikate verwaltet.
Die Konfiguration erfolgt über Umgebungsvariablen oder eine config.json-Datei. Ein häufiger Stolperstein besteht darin, dass im Admin-Panel gespeicherte Werte in config.json geschrieben werden, welche dann die Umgebungsvariablen in der Docker-Compose-Datei überschreiben. Dies führt zu Verwirrung, wenn Administratoren ihre Compose-Dateien aktualisieren, aber keine Änderungen feststellen, da die lokale Konfigurationsdatei Vorrang hat. Das Verständnis dieser Hierarchie ist entscheidend für die Aufrechterhaltung einer vorhersagbaren und sicheren Bereitstellung.
Warum es wichtig ist
Für Teams, die ihre eigene Software betreiben, können Sicherheitsfehikonfigurationen zu unbefugtem Zugriff oder Dienstunterbrechungen führen. Die Verwendung veralteter WebSocket-Einstellungen exponiert unnötige Ports und erhöht die Angriffsfläche. Ebenso kann eine fehlerhafte Nginx-Konfiguration verhindern, dass Benutzer bestehende Vaults importieren, was zu Frustration wegen Datenverlust führt. Die strenge Anforderung für HTTPS bedeutet, dass jede Lücke im Zertifikatsmanagement sofort den Zugang für alle Benutzer bricht, da moderne Clients ablehnen, sich über unverschlüsselte Kanäle zu verbinden.
Die administrative Sicherheit ist ebenso kritisch. Das Admin-Panel bietet volle Kontrolle über die Instanz, einschließlich Benutzerverwaltung und Organisationseinstellungen. Wenn das Admin-Token schwach oder unsachgemäß gehasht ist, könnten Angreifer die volle Kontrolle erlangen. Der Artikel hebt hervor, dass die Verwendung der schwächeren Hash-Voreinstellung owasp die Rechenkosten für Angreifer senkt, die versuchen, das Token per Brute-Force zu knacken. Darüber hinaus kann ein Missverständnis bezüglich der Whitelists für Registrierungen unbeabsichtigt öffentliche Registrierungen ermöglichen und eine private Instanz in ein öffentliches Ziel verwandeln.
Was Sie tun können
- Entfernen Sie
WEBSOCKET_ENABLEDundWEBSOCKET_PORTaus Ihrer Docker-Compose-Datei, da diese missbilligt sind. - Generieren Sie Admin-Token über das Befehlszeilentool unter Verwendung der Standardvoreinstellung
bitwarden, um maximale Hash-Stärke zu gewährleisten. - Konfigurieren Sie Nginx mit
client_max_body_size 128M, um große Vault-Importe zu unterstützen und stille Upload-Fehler zu vermeiden. - Überprüfen Sie Ihre Nginx-Version vor der Verwendung von
http2 on; nutzen Sielisten 443 ssl http2;für Versionen älter als 1.25.1, um Startfehler zu vermeiden. - Setzen Sie
SIGNUPS_ALLOWEDauffalseund vermeiden Sie die Nutzung vonSIGNUPS_DOMAINS_WHITELIST, es sei denn, Sie beabsichtigen ausdrücklich, offene Registrierungen für diese Domains zu erlauben. - Überwachen Sie E-Mails über unvollständige Zwei-Faktor-Authentifizierungen als Zeichen möglicher Credential-Stuffing-Angriffe gegen Ihre Benutzer.


