Authenticatie

HomeBe·at ondersteunt twee methoden om verbinding te maken met je Home Assistant-instantie: de standaard OAuth-flow en langlevende toegangstokens.

OAuth (Aanbevolen)

Wanneer je HomeBe·at voor het eerst start, word je gevraagd je Home Assistant-URL in te voeren. De app opent een browservenster waar je rechtstreeks inlogt bij Home Assistant. Dit gebruikt de standaard OAuth 2.0-autorisatieflow — HomeBe·at ziet je wachtwoord nooit.

1
Voer je HA-URL in

Geef je lokale Home Assistant-adres op, bijv. http://homeassistant.local:8123. Op macOS en iOS kun je ook een extern URL configureren — de app schakelt automatisch tussen lokaal en extern op basis van beschikbaarheid.

2
Autoriseer in de browser

Er opent een browservenster. Log in bij Home Assistant en keur het autorisatieverzoek goed.

3
Verbonden

HomeBe·at ontvangt een toegangstoken en maakt automatisch verbinding. Het token wordt op de achtergrond vernieuwd.

Langlevend toegangstoken

Als je liever geen OAuth-flow gebruikt, of verbinding moet maken vanuit een omgeving waar browsergebaseerde authenticatie niet praktisch is (zoals tvOS), kun je een langlevend toegangstoken (LLAT) gebruiken.

Een token aanmaken

1
Open je HA-profiel

Klik in Home Assistant op je gebruikersavatar linksonder en ga naar je profielpagina.

2
Scroll naar langlevende toegangstokens

Onderaan de profielpagina vind je het gedeelte Langlevende toegangstokens.

3
Maak een token aan

Klik op Token aanmaken, geef het een naam zoals "HomeBe·at" en kopieer het gegenereerde token. Je kunt het daarna niet meer zien.

4
Plak in HomeBe·at

Selecteer in de verbindingsinstellingen van de app de LLAT-optie en plak je token.

Opmerking: Langlevende toegangstokens verlopen niet automatisch. Je kunt ze op elk moment intrekken via je Home Assistant-profielpagina.

tvOS-authenticatie

Op Apple TV is browsergebaseerde OAuth niet beschikbaar. Je hebt twee opties:

  • Koppelen met macOS — Als HomeBe·at is ingesteld op een Mac met hetzelfde iCloud-account, worden inloggegevens automatisch gedeeld via iCloud-sleutelhanger.
  • Langlevend toegangstoken — Voer je HA-URL en LLAT rechtstreeks in op de Apple TV met het schermtoetsenbord of de Remote-app op je iPhone.

Tokenopslag

Alle authenticatietokens worden veilig opgeslagen in de systeem-sleutelhanger (macOS) of gedeelde iCloud-sleutelhanger (tvOS). Ze worden nooit naar een server van derden verzonden.