Authentification

HomeBe·at prend en charge deux méthodes pour se connecter à votre instance Home Assistant : le flux OAuth standard et les tokens d'accès longue durée.

OAuth (Recommandé)

Au premier lancement de HomeBe·at, il vous sera demandé de saisir l'URL de votre Home Assistant. L'application ouvrira une fenêtre de navigateur dans laquelle vous vous connecterez directement à Home Assistant. Ce processus utilise le flux d'autorisation OAuth 2.0 standard — HomeBe·at ne voit jamais votre mot de passe.

1
Saisir l'URL de votre HA

Indiquez l'adresse locale de votre Home Assistant, par ex. http://homeassistant.local:8123. Sur macOS et iOS, vous pouvez également configurer une URL distante — l'application bascule automatiquement entre local et distant selon la disponibilité.

2
Autoriser dans le navigateur

Une fenêtre de navigateur s'ouvre. Connectez-vous à Home Assistant et approuvez la demande d'autorisation.

3
Connecté

HomeBe·at reçoit un token d'accès et se connecte automatiquement. Le token est renouvelé en arrière-plan.

Token d'accès longue durée

Si vous préférez ne pas utiliser le flux OAuth, ou si vous devez vous connecter depuis un environnement où l'authentification par navigateur n'est pas pratique (comme tvOS), vous pouvez utiliser un token d'accès longue durée (LLAT).

Créer un token

1
Ouvrir votre profil HA

Dans Home Assistant, cliquez sur votre avatar utilisateur en bas à gauche, puis accédez à votre page de profil.

2
Faire défiler jusqu'aux tokens d'accès longue durée

En bas de la page de profil, trouvez la section des tokens d'accès longue durée.

3
Créer un token

Cliquez sur Créer un token, donnez-lui un nom tel que « HomeBe·at », et copiez le token généré. Vous ne pourrez plus le consulter par la suite.

4
Coller dans HomeBe·at

Dans les paramètres de connexion de l'application, sélectionnez l'option LLAT et collez votre token.

Remarque: Les tokens d'accès longue durée n'expirent pas automatiquement. Vous pouvez les révoquer à tout moment depuis votre page de profil Home Assistant.

Authentification tvOS

Sur Apple TV, l'authentification OAuth via navigateur n'est pas disponible. Vous avez deux options :

  • Jumeler avec macOS — Si HomeBe·at est configuré sur un Mac avec le même compte iCloud, les identifiants sont partagés automatiquement via le trousseau iCloud.
  • Token d'accès longue durée — Saisissez l'URL de votre HA et le LLAT directement sur l'Apple TV à l'aide du clavier à l'écran ou de l'app Télécommande sur votre iPhone.

Stockage des tokens

Tous les tokens d'authentification sont stockés de manière sécurisée dans le trousseau système (macOS) ou le trousseau iCloud partagé (tvOS). Ils ne sont jamais transmis à un serveur tiers.