Authentifizierung

HomeBe·at unterstützt zwei Methoden, um dich mit deiner Home Assistant Instanz zu verbinden: den standardmäßigen OAuth-Flow und Long-Lived Access Tokens.

OAuth (Empfohlen)

Wenn du HomeBe·at zum ersten Mal startest, wirst du aufgefordert, deine Home Assistant URL einzugeben. Die App öffnet ein Browserfenster, in dem du dich direkt bei Home Assistant anmeldest. Dabei wird der standardmäßige OAuth 2.0 Authorization Flow verwendet — HomeBe·at sieht dein Passwort nie.

1
HA-URL eingeben

Gib deine lokale Home Assistant Adresse ein, z. B. http://homeassistant.local:8123. Auf macOS und iOS kannst du auch eine Remote-URL konfigurieren — die App wechselt automatisch zwischen lokal und remote, je nach Verfügbarkeit.

2
Im Browser autorisieren

Ein Browserfenster öffnet sich. Melde dich bei Home Assistant an und bestätige die Autorisierungsanfrage.

3
Verbunden

HomeBe·at erhält ein Access Token und verbindet sich automatisch. Das Token wird im Hintergrund erneuert.

Long-Lived Access Token

Falls du den OAuth-Flow lieber nicht nutzen möchtest oder dich in einer Umgebung befindest, in der browserbasierte Authentifizierung unpraktisch ist (z. B. tvOS), kannst du einen Long-Lived Access Token (LLAT) verwenden.

Token erstellen

1
HA-Profil öffnen

Klicke in Home Assistant auf deinen Benutzer-Avatar unten links und gehe zu deiner Profilseite.

2
Zu Long-Lived Access Tokens scrollen

Scrolle am Ende der Profilseite zum Bereich Long-Lived Access Tokens.

3
Token erstellen

Klicke auf Token erstellen, vergib einen Namen wie "HomeBe·at" und kopiere den generierten Token. Du wirst ihn danach nicht mehr einsehen können.

4
In HomeBe·at einfügen

Wähle in den Verbindungseinstellungen der App die LLAT-Option und füge deinen Token ein.

Hinweis: Long-Lived Access Tokens laufen nicht automatisch ab. Du kannst sie jederzeit auf deiner Home Assistant Profilseite widerrufen.

tvOS-Authentifizierung

Auf dem Apple TV ist browserbasiertes OAuth nicht verfügbar. Du hast zwei Möglichkeiten:

  • Mit macOS koppeln — Wenn HomeBe·at auf einem Mac mit demselben iCloud-Account eingerichtet ist, werden die Zugangsdaten automatisch über den iCloud-Schlüsselbund geteilt.
  • Long-Lived Access Token — Gib deine HA-URL und den LLAT direkt auf dem Apple TV über die Bildschirmtastatur ein, oder verwende die Remote-App auf deinem iPhone für einfachere Texteingabe.

Token-Speicherung

Alle Authentifizierungs-Tokens werden sicher im System-Schlüsselbund (macOS) oder im geteilten iCloud-Schlüsselbund (tvOS) gespeichert. Sie werden niemals an Drittanbieter-Server übertragen.