Autenticación

HomeBe·at admite dos métodos para conectarte a tu instancia de Home Assistant: el flujo OAuth estándar y los Long-Lived Access Tokens.

OAuth (Recomendado)

Cuando lances HomeBe·at por primera vez, se te pedirá que introduzcas la URL de tu Home Assistant. La app abrirá una ventana del navegador donde inicias sesión en Home Assistant directamente. Esto usa el flujo de autorización OAuth 2.0 estándar — HomeBe·at nunca ve tu contraseña.

1
Introduce tu URL de HA

Proporciona la dirección local de tu Home Assistant, p. ej. http://homeassistant.local:8123. En macOS e iOS también puedes configurar una URL remota — la app cambia automáticamente entre local y remota según la disponibilidad.

2
Autoriza en el navegador

Se abre una ventana del navegador. Inicia sesión en Home Assistant y aprueba la solicitud de autorización.

3
Conectado

HomeBe·at recibe un token de acceso y se conecta automáticamente. El token se renueva en segundo plano.

Long-Lived Access Token

Si prefieres no usar el flujo OAuth, o necesitas conectarte desde un entorno donde la autenticación por navegador no es práctica (como tvOS), puedes usar un Long-Lived Access Token (LLAT).

Crear un token

1
Abre tu perfil de HA

En Home Assistant, haz clic en tu avatar de usuario en la esquina inferior izquierda y ve a tu página de perfil.

2
Desplázate hasta Long-Lived Access Tokens

Al final de la página de perfil, encuentra la sección Long-Lived Access Tokens.

3
Crea un token

Haz clic en Crear token, dale un nombre como "HomeBe·at" y copia el token generado. No podrás verlo de nuevo.

4
Pégalo en HomeBe·at

En los ajustes de conexión de la app, selecciona la opción LLAT y pega tu token.

Nota: Los Long-Lived Access Tokens no caducan automáticamente. Puedes revocarlos en cualquier momento desde la página de perfil de Home Assistant.

Autenticación en tvOS

En Apple TV, la autenticación OAuth basada en navegador no está disponible. Tienes dos opciones:

  • Vincular con macOS — Si HomeBe·at está configurado en un Mac con la misma cuenta de iCloud, las credenciales se comparten automáticamente a través del Llavero de iCloud.
  • Long-Lived Access Token — Introduce la URL de tu HA y el LLAT directamente en el Apple TV usando el teclado en pantalla o la app Remote en tu iPhone.

Almacenamiento de tokens

Todos los tokens de autenticación se almacenan de forma segura en el Llavero del sistema (macOS) o en el Llavero compartido de iCloud (tvOS). Nunca se transmiten a ningún servidor de terceros.