BlogKontakt

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_key

2. 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_password
  • ota.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 zamiast encryption: ustaw password: !secret boneio_ota_password — hasło sprawdza tylko, kto wgrywa. Obu naraz ustawić się nie da.
  • web_server.auth chroni stronę urządzenia. Jeśli z niej nie korzystasz, usuń cały blok web_server.
  • Sterownik adoptowany wcześniej może mieć w ota linię - platform: web_server — to wgrywanie firmware'u przez przeglądarkę. Usuń ją albo zostaw tylko razem z web_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.