Eine einzige Zeile db_url: mysql://homeassistant:password@core-mariadb oder ein einziges WLAN-Passwort in einer ESPHome-Datei reicht aus, damit Ihre Passwörter beim Hochladen Ihrer Konfiguration auf GitHub offengelegt werden. Und trusted_proxies: 0.0.0.0/0 erlaubt jedem im Internet, die IP-Adresse zu bestimmen, die Home Assistant sieht. Dadurch schützen IP-Sperren und auf das lokale Netz beschränkte Webhooks Sie nicht mehr. Dieser Skill findet diese und neun weitere Konfigurationsfehler in Home Assistant, bevor Sie Ihre Einrichtung teilen, committen oder zugänglich machen, und erklärt, wie Sie jeden davon beheben.

Ihr Agent führt einen Scanner für Ihren Home-Assistant-Konfigurationsordner aus: configuration.yaml, automations.yaml, Skripte, Pakete, Blueprints, per !include und !include_dir_* eingebundene Dateien sowie daneben gespeicherte ESPHome-Gerätedateien. Er erkennt !secret, !include, !env_var und !input als Verweise statt als Werte, versteht beide Trigger-Schreibweisen (trigger: webhook und platform: webhook), liest eingebundene Dateien, die nur einen http:-Block, eine Liste von Authentifizierungsanbietern oder eine Plattformliste enthalten, und überspringt YAML, das nicht zu Home Assistant gehört (CI-Workflows, Docker Compose, Kubernetes). Er prüft .gitignore-Regeln selbst, einschließlich der verbreiteten Variante „alles ignorieren, dann *.yaml zulassen“. Er startet niemals Home Assistant, ruft dessen API nicht auf und stellt keine Verbindungen her. Er liefert BLOCK, REVIEW oder NOT FLAGGED mit Datei, Zeile, Begründung und einem sichereren Vorgehen. Geheimnisse werden niemals ausgegeben.

Was geprüft wird

BLOCK (vor der Auslieferung beheben)

• H01: direkt statt über !secret eingetragene Passwörter, Tokens und Schlüssel: Schlüssel mit auf Geheimnisse hinweisenden Namen, Passwörter in db_url und rtsp://-Kamera-URLs, Authorization-Header, Tokens in URLs, langlebige Zugriffstokens und ESPHome-API-Verschlüsselungsschlüssel

• H02: secrets.yaml, .storage oder .cloud in einem git-Repository ohne passende .gitignore-Regel

• H03: use_x_forwarded_for mit für das gesamte Internet offenen trusted_proxies (0.0.0.0/0, ::/0)

• H04: ein trusted_networks-Anmeldeanbieter, der dem gesamten Internet vertraut

REVIEW (vor der Veröffentlichung prüfen)

• H11: allow_bypass_login: true oder öffentliche Adressen in trusted_networks

• H12: external_url mit unverschlüsseltem http:// für einen Host im Internet

• H13: ip_ban_enabled: false, login_attempts_threshold: -1 oder fehlender Schwellenwert hinter einem Reverse-Proxy oder bei TLS

• H14: Vorlagen innerhalb von shell_command- und command_line-Befehlen

• H15: Webhook-Trigger mit local_only: false

• H16: allowlist_external_dirs mit Zugriff auf /, /config, /etc, /root oder /home

• H17: verify_ssl: false für HTTPS-Hosts im Internet

Lieferumfang

• Der Scanner (Python 3.9+, ausschließlich Standardbibliothek)

• Ein Regelleitfaden mit Begründung und sichererem Vorgehen für jede Regel

• Ein riskanter und ein sicherer Beispiel-Konfigurationsordner (configuration.yaml, secrets.yaml, automations.yaml, ein Paket, ein ESPHome-Gerät und .gitignore) sowie der tatsächliche Scannerbericht zum riskanten Beispiel

Grenzen

Der Scanner liest jede YAML-Datei so, wie sie vorliegt, führt !include-Dateien nicht zusammen und löst !secret-Werte nicht auf. Über die Benutzeroberfläche vorgenommene Einstellungen liegen in .storage und werden nicht gelesen; seit Home Assistant 2026.8 gilt dies auch für die http:-Einstellungen, die einmalig aus YAML nach Einstellungen > System > Netzwerk importiert werden. Prüfen Sie sie daher auch dort. Benutzer, MFA, Portweiterleitungen und Add-ons werden nicht geprüft. NOT FLAGGED ist keine Garantie.

Inhalt

Eine ZIP-Datei mit 21 Dateien: SKILL.md, der Scanner in scripts/ (5 Python-Dateien), references/rules.md (jede Regel mit Begründung und sichererem Vorgehen) und examples/ (13 Beispieldateien sowie report.md, die tatsächliche Scannerausgabe zum riskanten Beispiel).

Verwendung: Dies ist ein Agenten-Skill: ein Ordner mit der Datei SKILL.md und Python-Skripten, die ein KI-Programmieragent wie Claude Code, Cursor oder Codex CLI ausführen kann. Entpacken Sie das Archiv in den Skills-Ordner Ihres Agenten (für Claude Code: ~/.claude/skills/), und bitten Sie Ihren Agenten anschließend, Ihr Projekt zu prüfen. Die Skripte lassen sich auch eigenständig mit Python 3.9 oder neuer ausführen, ohne zusätzliche Installation. Sie lesen ausschließlich Ihre Dateien: kein Netzwerkzugriff, und es wird nichts irgendwohin gesendet.