docs: Token-Schutz richtig beschreiben, Verfügbarkeit dokumentieren

This commit is contained in:
Michael Sauer
2026-09-16 19:37:11 +02:00
parent edef034fb1
commit ad165e18b3
4 changed files with 26 additions and 7 deletions
+23 -4
View File
@@ -23,10 +23,21 @@ angeboten. Alternativ „Integration hinzufügen → ninlight" und IP-Adresse od
`ninlight-xxxx.local` eingeben.
Das Token-Feld ist mit dem **öffentlichen Vorgabe-Token** `aabbccddeeff0011223344` vorbelegt.
Solange eine Lampe dieses Token nutzt, kann jeder in deinem Netz sie steuern und neu flashen;
HA zeigt dafür einen Reparaturhinweis. Eigenes Token auf der Lampe setzen
(`PUT /api/v1/system/settings` mit `{"type":"token","token":"…"}`) und in HA über
*Neu konfigurieren* eintragen.
Solange eine Lampe dieses Token nutzt, kann jeder in deinem Netz sie neu konfigurieren, neu
starten und neu flashen; HA zeigt dafür einen Reparaturhinweis. Schalten und Dimmen sind ohne
`auth_all` ohnehin für jeden im Netz möglich – ein eigenes Token allein schützt nicht davor.
Eigenes Token auf der Lampe setzen (`PUT /api/v1/system/settings` mit
`{"type":"token","token":"…"}`) und in HA über *Neu konfigurieren* eintragen. Willst du zusätzlich
das Schalten schützen, aktiviere `auth_all` auf der Lampe:
```
PUT /api/v1/system/settings
{"type": "auth", "all": true}
```
Mit aktiviertem `auth_all` verlangt jede Abfrage – auch lesende – das Token; ein falsches oder
fehlendes Token führt dann sofort zur Neuanmeldung.
Wechselt eine Lampe ihre IP, aktualisiert mDNS den Eintrag selbst (Identität ist die MAC).
Das gilt ungeprüft: Ein Gerät im selben Netz, das dieselbe MAC per mDNS ankündigt, übernimmt
@@ -46,6 +57,14 @@ Lampe gehen (relevant nur in einem bereits kompromittierten Netz).
| IP-Adresse, freier Speicher, letzter Update-Fehler, letzter Start | Sensor (Diagnose) | standardmäßig deaktiviert |
| Firmware | Update | siehe unten |
## Verfügbarkeit
Kurze Aussetzer werden toleriert: Erst nach 3 fehlgeschlagenen Abfragen in Folge gilt die Lampe
als nicht verfügbar. Beim Standardintervall von 30 s und 10 s Timeout sind das 90–120 s (gemessen
an der G95: 90 s und 110 s). Fehlgeschlagene Schaltbefehle werden dagegen sofort als Fehler
gemeldet. Im HA-Debug-Log erscheinen tolerierte Fehlschläge als „poll failed (n/3)“ und trotzdem
mit „success: True“, weil der zuletzt bekannte Zustand weiterverwendet wird.
## Firmware-Updates
Home Assistant bietet Updates aus dem Ordner **`<config>/ninlight_firmware/`** an (wird beim