Zugang und Sicherheit
Passwort, Login am Deck, API-Schlüssel, Sperre, HTTPS und CORS.
Passwort
Die Weboberfläche hat einen Benutzer, admin. Beim ersten Start erzeugt der Connector ein zufälliges Passwort und zeigt es im Deck-Menü. Ein eigenes (6 bis 23 Zeichen) setzt du in der Einrichtung oder unter Zugang (Demo).
Vor der Einrichtung kommt ein Browser für kurze Zeit ohne Passwort hinein, siehe Erste Einrichtung. Ein Werkszustand öffnet es wieder.
Ein neues Passwort startet den Connector neu und beendet jede Sitzung. Eine Sitzung endet nach 12 Stunden ohne Nutzung, beim Abmelden und bei einem Stromausfall.
Passwort vergessen
Die Anmeldeseite bietet drei Wege. Für jeden muss jemand am Deck stehen, und Eingaben über die API zählen nie.
| Weg | Am Deck |
|---|---|
| Am Deck anfragen | Innerhalb von 60 s auf Annehmen tippen |
| Passwort am Deck | Das Passwort steht 30 s lang da |
| Zurücksetzen | Innerhalb von 60 s zweimal auf Zurücksetzen tippen. Alle Einstellungen sind weg |
Endet einer davon ohne Annehmen, kann dieselbe Adresse ihn erst nach einer Minute wieder starten. Die Anmeldeseite zeigt, wie lange. Alle IPv6-Adressen mit derselben ersten Hälfte (/64) zählen als eine Adresse.
Sperre
- Nach fünf falschen Passwörtern von einer Adresse wartet diese Adresse ein paar Sekunden, höchstens eine Minute.
- Nach 30 falschen Passwörtern in einer Minute von allen Adressen warten alle bis zum Ende der Minute, außer den letzten vier Adressen, die sich angemeldet haben.
- Ein API-Schlüssel wird nie gesperrt.
API-Schlüssel
Skripte und Home Assistant nutzen einen API-Schlüssel. Du legst ihn unter Zugang › API-Zugriff an. Er wird nur einmal angezeigt.
curl -H 'Authorization: Bearer SCHLUESSEL' http://192.168.1.50/api/statusVier Stufen, jede enthält die darüber. open: alle. control: das Passwort oder ein API-Schlüssel mit Steuern oder Vollzugriff. full: das Passwort oder ein Schlüssel mit Vollzugriff. admin: nur das Passwort.
- openAlleLogin, Zertifikat, Hilfe bei vergessenem Passwort, erste Einrichtung
- controlPasswort, Schlüssel Steuern oder VollzugriffStatus, Deck-Bild, Tastendrücke, Menü, Messwerte
- fullPasswort, Schlüssel VollzugriffEinstellungen, Neustart, Updates, Firmware-Plätze, Log, Kopplung, WLAN
- adminNur das PasswortPasswort, API-Schlüssel, Backup, Absturzbericht, eigenes Zertifikat, Werkszustand
Ein Schlüssel hat Steuern (control) oder Vollzugriff (full). Es gibt höchstens 8. Ein gelöschter gilt sofort nicht mehr. Ein neuer Schlüssel mit demselben Namen ersetzt den alten. Der Connector speichert nur einen Hash, und eine Sicherung enthält nie einen Schlüssel. Home Assistant löscht seinen eigenen Schlüssel, wenn du die Integration entfernst.
HTTPS
Der Connector antwortet auf Port 80 und per HTTPS auf 443. Sein Zertifikat stammt von seiner eigenen CA, die er beim ersten Start anlegt. Vertraue der CA einmal auf jedem Gerät, unter Zugang › HTTPS. Dann warnt unter https://<name>.local kein Browser mehr.
- Die CA bürgt nur für
<name>.localundlocalhost, nie für einen anderen Namen oder eine IP-Adresse. - Das Zertifikat wird 30 Tage vor Ablauf erneuert. Der Fingerabdruck ändert sich dabei, die CA bleibt.
- Ein neuer Name bekommt eine neue CA. Vertraue ihr dann auf jedem Gerät neu.
- Ein Zurücksetzen auf Werkszustand löscht die CA.
GET /api/caliefert die CA,GET /api/certdas aktuelle Zertifikat als PEM.- Nur HTTPS schaltet unverschlüsseltes HTTP ab. Die Startseite leitet um, jede andere Anfrage über HTTP bekommt 403. Solange das Setup-WLAN offen ist, bleibt HTTP an. Home Assistant braucht unverschlüsseltes HTTP und funktioniert dann nicht mehr.
- Du kannst ein eigenes Zertifikat mit Schlüssel als PEM hochladen. Einen Schlüssel mit Passwort lehnt der Connector ab.
Passkeys
Mit einem Passkey meldest du dich per Fingerabdruck, Gesicht oder Geräte-PIN an. Du legst ihn unter Zugang › Passkeys an.
- Er braucht HTTPS ohne Warnung und einen Namen, etwa
https://deckconnector-a1b2c3.local. Vertraue zuerst der CA oder lade ein Zertifikat für deinen eigenen Namen hoch. - Ein Passkey gilt nur unter dem Namen, unter dem er angelegt wurde. Nach einer Umbenennung legst du ihn neu an.
- Höchstens 8 Passkeys. Das Passwort gilt weiter. Ein Zurücksetzen auf Werkszustand löscht alle Passkeys.
Hinter einem Reverse Proxy
Ein Proxy wie Caddy kann den Connector unter seinem eigenen Namen ausliefern. Dann kommt jede Anfrage von der Adresse des Proxys. Trage diese Adresse unter Zugang › HTTPS › Reverse Proxy ein. Der Connector nimmt den Client dann aus dem letzten Eintrag von X-Forwarded-For. Er nutzt ihn für die Sperre, für Passkeys und für die Anmeldefrage auf dem Deck.
- Der Connector liest den Header nur von dieser einen Adresse. Von allen anderen ignoriert er ihn.
- Der Proxy muss den
Host-Header behalten und den Client anX-Forwarded-Foranhängen. Caddy macht beides von selbst. - Durch den Proxy gehen die Einrichtung im ersten Browser und Companions Discover nicht.
Setup-WLAN
Ein Browser im Setup-WLAN braucht kein Web-Passwort. Das WLAN-Passwort zeigt nur das Deck, zum Verbinden musst du also am Deck sein. Nur Handys im Setup-WLAN bekommen die Anmeldeseite und die DNS-Antworten des Connectors, Geräte im LAN nie.
CORS
Eine Webseite von einem anderen Origin darf die API mit einem API-Schlüssel aufrufen, wenn ihr Origin unter Erlaubte Webseiten steht. Anfangs leer. Cookies gelten nie über Origins hinweg.