Одной строки db_url: mysql://homeassistant:password@core-mariadb или одного пароля Wi-Fi в файле ESPHome достаточно, чтобы ваши пароли утекли в день отправки конфигурации на GitHub. А trusted_proxies: 0.0.0.0/0 позволяет любому в интернете выбирать IP-адрес, который видит Home Assistant, поэтому блокировки по IP и вебхуки только для локальной сети перестают вас защищать. Этот навык находит эти и ещё девять ошибок конфигурации Home Assistant до того, как вы поделитесь настройками, добавите их в репозиторий или откроете доступ к системе, и объясняет, как исправить каждую.

Ваш агент запускает сканер для папки конфигурации Home Assistant: configuration.yaml, automations.yaml, скриптов, пакетов, чертежей, файлов, подключаемых через !include и !include_dir_*, и расположенных рядом файлов устройств ESPHome. Он воспринимает !secret, !include, !env_var и !input как ссылки, а не значения, распознаёт оба варианта записи триггеров (trigger: webhook и platform: webhook), читает подключаемые файлы, содержащие только блок http:, список провайдеров аутентификации или список платформ, и пропускает YAML, не относящийся к Home Assistant (процессы CI, Docker Compose, Kubernetes). Сканер самостоятельно проверяет правила .gitignore, включая распространённый вариант «игнорировать всё, затем разрешить *.yaml». Он никогда не запускает Home Assistant, не вызывает его API и ни к чему не подключается. Он возвращает BLOCK, REVIEW или NOT FLAGGED с указанием файла, строки, причины и более безопасного подхода. Секреты никогда не выводятся.

Что проверяется

BLOCK (исправить до передачи пользователям)

• H01: пароли, токены и ключи, записанные напрямую вместо !secret: ключи с именами, указывающими на секреты, пароли в db_url и rtsp:// URL камер, заголовки Authorization, токены в URL, долгоживущие токены доступа и ключи шифрования API ESPHome

• H02: secrets.yaml, .storage или .cloud в репозитории git без соответствующего правила в .gitignore

• H03: use_x_forwarded_for с trusted_proxies, открытым для всего интернета (0.0.0.0/0, ::/0)

• H04: провайдер входа trusted_networks, доверяющий всему интернету

REVIEW (проверить до выпуска)

• H11: allow_bypass_login: true или публичные адреса в trusted_networks

• H12: external_url с незашифрованным http:// для хоста в интернете

• H13: ip_ban_enabled: false, login_attempts_threshold: -1 или отсутствие порога попыток входа при работе за обратным прокси или с TLS

• H14: шаблоны внутри команд shell_command и command_line

• H15: триггеры вебхуков с local_only: false

• H16: allowlist_external_dirs, открывающий доступ к /, /config, /etc, /root или /home

• H17: verify_ssl: false для HTTPS-хостов в интернете

Что входит в комплект

• Сканер (Python 3.9+, только стандартная библиотека)

• Руководство по правилам с обоснованием и более безопасным подходом для каждого правила

• Примеры опасной и безопасной папок конфигурации (configuration.yaml, secrets.yaml, automations.yaml, пакет, устройство ESPHome и .gitignore), а также реальный отчёт сканера для опасного примера

Ограничения

Сканер читает каждый YAML-файл в том виде, в котором он записан, не объединяет файлы !include и не подставляет значения !secret. Настройки, сделанные в интерфейсе, хранятся в .storage и не читаются; начиная с Home Assistant 2026.8 это относится и к настройкам http:, которые однократно импортируются из YAML в Настройки > Система > Сеть, поэтому проверьте их и там. Пользователи, MFA, проброс портов и дополнения не проверяются. Статус NOT FLAGGED не является гарантией.

Содержимое

Один ZIP-архив с 21 файлом: SKILL.md, сканер в scripts/ (5 файлов Python), references/rules.md (каждое правило с обоснованием и более безопасным подходом) и examples/ (13 файлов примеров и report.md, реальный вывод сканера для опасного примера).

Как использовать: Это навык для агента: папка с файлом SKILL.md и скриптами Python, которые может запускать ИИ-агент для программирования, например Claude Code, Cursor или Codex CLI. Распакуйте архив в папку навыков вашего агента (для Claude Code: ~/.claude/skills/), затем попросите агента проверить ваш проект. Скрипты также можно запускать самостоятельно с Python 3.9 или новее, без установки дополнительных пакетов. Они только читают ваши файлы: доступа к сети нет, данные никуда не отправляются.