Bezpieczeństwo
Aktualizacje i zabezpieczenia sterownika boneIO ESP oraz jak zgłosić podatność
Sterowniki boneIO ESP działają na ESPHome. Możesz z nich korzystać na dwa sposoby, a od wyboru zależy, kto dba o aktualizacje i zabezpieczenia:
- firmware fabryczny — sterownik dodajesz w Home Assistant i nic więcej; aktualizacje dostarcza boneIO;
- adopcja w ESPHome Builder — przejmujesz konfigurację i kompilujesz ją sam; aktualizacje i zabezpieczenia są wtedy po Twojej stronie.
Firmware fabryczny
Taki firmware jest na sterowniku z fabryki i wgrywa go instalator boneio.eu/esp.
Aktualizacje. W Home Assistant sterownik ma encję Firmware. Gdy boneIO wyda nową wersję, encja pokaże dostępną aktualizację — instalujesz ją przyciskiem Aktualizuj. Sterownik sprawdza to po każdym starcie i co 6 godzin. Sterowniki ze starszym firmware'em, bez tej encji, dostaną ją po jednorazowym wgraniu firmware'u z instalatora.
Zabezpieczenia.
| Firmware fabryczny | |
|---|---|
Połączenie z Home Assistant (api) | Szyfrowane. Klucz, inny dla każdego sterownika, ustawia Home Assistant przy pierwszym połączeniu i sam go przechowuje |
Wgrywanie firmware'u przez sieć (ota) | Bez hasła — każdy w sieci może wgrać sterownikowi własny firmware. Tak wymaga ESPHome: przez nie wgrywasz własną konfigurację po adopcji |
Strona urządzenia (web_server) | Brak. Włącza ją opcja + web panel w instalatorze albo lista Firmware variant w Home Assistant — strona na porcie 80 jest wtedy bez hasła i pozwala przełączać wyjścia |
| Wgrywanie firmware'u przez przeglądarkę | Brak |
Dodaj sterownik do Home Assistant zaraz po podłączeniu do sieci: do tego czasu połączenie nie jest szyfrowane, a klucz ustawi ten, kto połączy się pierwszy. Trzymaj sterownik w zaufanej sieci, najlepiej oddzielonej od urządzeń gości.
Klucz przeżywa ponowne wgranie. Sterownik pamięta klucz także po wgraniu firmware'u przez USB. Przy sprzedaży sterownika, przenosinach do innego Home Assistant albo gdy Home Assistant stracił klucz (np. reinstalacja bez kopii zapasowej), wgraj firmware z instalatora i zgódź się na wymazanie urządzenia — dopiero to usuwa klucz.
Po adopcji w ESPHome Builder
Adopcja kopiuje publiczną konfigurację sterownika — bez aktualizacji boneIO, więc encja Firmware znika, a nowy firmware wgrywasz, kompilując konfigurację w ESPHome Builder. Rób to regularnie: tak dostajesz poprawki ESPHome i pakietów boneIO.
1. Przejmij sterownik z kluczem API. W oknie Take control zostaw
zaznaczone Enable API encryption (ESPHome Builder 2026.10 lub nowszy).
Jeśli Home Assistant poprosi potem o klucz w integracji ESPHome, skopiuj go
z bloku api w konfiguracji urządzenia.
W starszym ESPHome Builder dopisz klucz sam (32 bajty w base64, Builder potrafi go wygenerować):
api:
reboot_timeout: 0s
encryption:
key: !secret boneio_api_key2. Zamknij OTA i stronę urządzenia. Publiczna konfiguracja ma stronę urządzenia bez hasła. Zmień te bloki i wgraj firmware jeszcze raz:
ota:
- platform: esphome
encryption:
web_server:
port: 80
local: true
auth:
type: digest
username: admin
password: !secret boneio_web_passwordota.encryption— sterownik przyjmie tylko firmware zaszyfrowany jego kluczem API: obcy nie wgra mu własnego, a obraz firmware'u (z kluczem w środku) nie idzie po sieci otwartym tekstem. Wymaga ESPHome 2026.9 lub nowszego; na starszym zamiastencryption:ustawpassword: !secret boneio_ota_password— hasło sprawdza tylko, kto wgrywa. Obu naraz ustawić się nie da.web_server.authchroni stronę urządzenia. Jeśli z niej nie korzystasz, usuń cały blokweb_server.- Sterownik adoptowany wcześniej może mieć w
otalinię- platform: web_server— to wgrywanie firmware'u przez przeglądarkę. Usuń ją albo zostaw tylko razem zweb_server.auth.
Hasło trzymaj w secrets.yaml, inne dla każdego sterownika.
Jak zgłosić podatność
Prosimy nie zakładać publicznego zgłoszenia. Napisz na security@boneio.eu
z SECURITY w temacie — potwierdzamy odbiór w ciągu 5 dni roboczych.
Zgłoszenie można też przekazać przez CERT Polska.
Problemy samego ESPHome zgłaszaj do
projektu ESPHome.