Autenticazione

HomeBe·at supporta due metodi per connettersi alla tua istanza Home Assistant: il flusso OAuth standard e i Long-Lived Access Token.

OAuth (Consigliato)

Al primo avvio di HomeBe·at, ti verrà chiesto di inserire l’URL del tuo Home Assistant. L’app aprirà una finestra del browser dove accederai direttamente a Home Assistant. Viene utilizzato il flusso di autorizzazione standard OAuth 2.0 — HomeBe·at non vede mai la tua password.

1
Inserisci l’URL di HA

Fornisci il tuo indirizzo locale di Home Assistant, ad es. http://homeassistant.local:8123. Su macOS e iOS, puoi anche configurare un URL remoto — l’app passa automaticamente tra locale e remoto in base alla disponibilità.

2
Autorizza nel browser

Si apre una finestra del browser. Accedi a Home Assistant e approva la richiesta di autorizzazione.

3
Connesso

HomeBe·at riceve un token di accesso e si connette automaticamente. Il token viene aggiornato in background.

Long-Lived Access Token

Se preferisci non utilizzare il flusso OAuth, o hai bisogno di connetterti da un ambiente in cui l’autenticazione tramite browser non è pratica (come tvOS), puoi utilizzare un Long-Lived Access Token (LLAT).

Creare un token

1
Apri il tuo profilo HA

In Home Assistant, clicca sul tuo avatar utente in basso a sinistra, poi vai alla pagina del tuo profilo.

2
Scorri fino a Long-Lived Access Tokens

In fondo alla pagina del profilo, trova la sezione Long-Lived Access Tokens.

3
Crea un token

Clicca su Crea Token, assegnagli un nome come "HomeBe·at" e copia il token generato. Non potrai più visualizzarlo in seguito.

4
Incolla in HomeBe·at

Nelle impostazioni di connessione dell’app, seleziona l’opzione LLAT e incolla il tuo token.

Nota: I Long-Lived Access Token non scadono automaticamente. Puoi revocarli in qualsiasi momento dalla pagina del tuo profilo Home Assistant.

Autenticazione tvOS

Su Apple TV, l'OAuth tramite browser non è disponibile. Hai due opzioni:

  • Abbina con macOS — Se HomeBe·at è configurato su un Mac con lo stesso account iCloud, le credenziali vengono condivise automaticamente tramite il Portachiavi iCloud.
  • Long-Lived Access Token — Inserisci l'URL di HA e il LLAT direttamente su Apple TV usando la tastiera su schermo o l'app Telecomando sul tuo iPhone.

Archiviazione dei token

Tutti i token di autenticazione sono archiviati in modo sicuro nel Portachiavi di sistema (macOS) o nel Portachiavi iCloud condiviso (tvOS). Non vengono mai trasmessi a server di terze parti.