So verhindern Sie, dass Home-Assistant-Geheimnisse in Compose-Dateien oder Backups gelangen

Eva Wong ist die technische Redakteurin und begeisterte Tüftlerin bei ZimaSpace. Als lebenslanger Geek mit einer Leidenschaft für Homelabs und Open-Source-Softwarehat sie sich darauf spezialisiert, komplexe technische Konzepte in verständliche, praxisnahe Anleitungenzu übersetzen. Eva ist überzeugt, dass Self-Hosting Spaß machen sollte und nicht einschüchternd sein darf. Mit ihren Tutorials hilft sie der Community dabei, Hardware-Setups zu durchschauen, vom Bau des ersten NAS bis zum sicheren Umgang mit Docker-Containern.

Verhindere das Offenlegen von Geheimnissen, indem du Werte aus freigebbaren Compose-Definitionen heraushältst und jedes Backup sowie jeden Diagnoseexport als sensibel behandelst, bis eine Inhaltsprüfung abgeschlossen ist.

Home Assistant benötigt Zugangsdaten zur Laufzeit. Daher kann kein lokales Verzeichnislayout sie vor Administratoren mit vollständigem Hostzugriff verbergen. Das praktische Ziel ist enger gefasst: versehentliche Commits, Uploads für den Support, umfangreiche Sicherungskopien und unnötigen Containerzugriff verhindern. Erfasse, wo jeder Wert in den Stack gelangt, ersetze Klartextwerte durch eine kontrollierte Geheimnisquelle und teste die exportierten Artefakte, ohne die Geheimnisse selbst auszugeben.

Alle möglichen Wege eines Geheimnisses nach außen erfassen

Führe API-Tokens, Datenbankpasswörter, MQTT-Zugangsdaten, Webhook-URLs, Verschlüsselungsschlüssel, private Zertifikate und Wiederherstellungsschlüssel auf. Halte für jedes Element den Laufzeitnutzer, den Speicherpfad, den Dateieigentümer, die Aufnahme in Backups, den Repository-Status, die Offenlegung in Protokollen und das Rotationsverfahren fest. Kopiere die Werte nicht in die Bestandsliste.

Geheimnisdateien strukturieren Werte, bleiben aber für jedes Konto lesbar, das auf den Host zugreifen kann. Diese Zugriffsgrenze für Klartext bedeutet, dass die Trennung vor allem versehentliche Offenlegungen reduziert, aber keinen vollständig privilegierten Angreifer abwehrt.

Ein Fehler liegt vor, wenn Compose-YAML, eine versionierte Umgebungsdatei, ein allgemein lesbares Konfigurationsverzeichnis oder ein Export mit unbekanntem Inhalt einen Klartextwert enthält. Setze Freigaben und Repository-Pushes aus, bis für jeden Offenlegungsweg eine zuständige Person und eine Korrektur festgelegt sind.

Laufzeitgeheimnisse von Bereitstellungsdefinitionen trennen

Ersetze Klartextwerte in Compose durch eng begrenzte dateibasierte Geheimnisse oder eine andere von der Bereitstellung unterstützte Geheimnisquelle. Gib jedem Dienst nur die Werte, die er benötigt, binde sie nach Möglichkeit schreibgeschützt ein und beschränke die Host-Berechtigungen auf die Laufzeitidentität und Administratoren.

Umgebungswerte können bei Inspektionen, im Prozesskontext oder in Protokollen sichtbar werden, während das dateibasierte Einbinden von Geheimnissen einschränken kann, welche Container Zugangsdaten erhalten. Für lokale Geheimnisdateien müssen weiterhin die Berechtigungen kontrolliert werden.

Prüfe zuerst mit Platzhaltern, untersuche die gerenderte Compose-Konfiguration auf versehentlich eingefügte Klartextwerte und starte dann einen Dienst, um zu bestätigen, dass er nur auf das ihm zugewiesene Geheimnis zugreifen kann. Rolle die Änderung zurück, wenn sie dazu führt, dass eine Anwendung Werte ausgibt oder weitreichende Verzeichnisberechtigungen erfordert.

Inhalte von Backups und Supportpaketen kontrollieren

Gehe davon aus, dass Backups Zugangsdaten enthalten, sofern nicht nachweislich etwas anderes gilt. Verschlüssele Kopien, die den vertrauenswürdigen Speicherbereich verlassen, bewahre Wiederherstellungsschlüssel getrennt auf, beschränke Aufbewahrungsdauer und Zugriff und hänge niemals ein vollständiges Konfigurationsarchiv an, wenn ein geschwärzter Logauszug die Supportfrage beantwortet.

Verwende den Workflow zum Schutz der Konfiguration, um die Wiederherstellbarkeit zu gewährleisten und zugleich sichere Speicherorte von freigabefähigem Bereitstellungsmaterial zu trennen.

Scanne vor der Freigabe Dateinamen und extrahierten Text nach bekannten Schlüsselnamen, Token-Präfixen, privaten URLs, E-Mail-Adressen, Zertifikaten und den exakten Hashes kontrollierter Testmarker. Ein unauffälliger Scan ist eine Freigabebedingung, aber kein Beweis dafür, dass kein unbekanntes Geheimnisformat vorhanden ist.

Offenlegung rotieren und den Präventionspfad nachweisen

Ist ein verwendbarer Wert in ein Repository, Ticket, einen Chat, einen öffentlichen Link oder ein nicht vertrauenswürdiges Backup gelangt, widerrufe oder rotiere ihn zuerst. Das Löschen der sichtbaren Kopie macht Kopien oder den Verlauf nicht ungültig. Halte den betroffenen Dienst und den Zeitpunkt der Rotation fest, ohne den alten Wert aufzubewahren.

Erstelle ein harmloses Canary-Geheimnis, stelle es über den neuen Pfad bereit, erzeuge die reguläre Compose-Darstellung, das Backup und das Diagnosepaket und durchsuche anschließend diese Artefakte. Die Laufzeitumgebung sollte das Canary-Geheimnis erhalten, während es in freigabefähigen Artefakten außerhalb der ausdrücklich geschützten Backup-Grenze nicht offengelegt wird.

Beende den Vorgang, wenn keine echten Geheimnisse mehr in Bereitstellungsdefinitionen und Repositories enthalten sind, geschützte Backups über einen separaten Wiederherstellungspfad verfügen, Artefaktprüfungen bestanden werden und offengelegte Zugangsdaten rotiert wurden. Eskaliere, wenn eine Drittanbieterintegration Geheimniswerte protokolliert oder eine eng begrenzte Geheimnisquelle nicht ohne umfassenderen Hostzugriff nutzen kann.

Support und Tipps

Mehr zum Lesen

Get More Builds Like This

Stay in the Loop

Get updates from Zima - new products, exclusive deals, and real builds from the community.

Stay in the Loop preferences

We respect your inbox. Unsubscribe anytime.