認証

HomeBe·at は Home Assistant インスタンスへの接続に2つの方法をサポートしています：標準の OAuth フローと Long-Lived Access Token です。

OAuth（推奨）

HomeBe·at を初めて起動すると、Home Assistant の URL の入力を求められます。アプリがブラウザウィンドウを開き、Home Assistant に直接サインインします。これは標準的な OAuth 2.0 認可フローを使用しており、HomeBe·at がパスワードを参照することはありません。

1
HA の URL を入力

ローカルの Home Assistant アドレスを入力してください（例：http://homeassistant.local:8123）。macOS と iOS では、リモート URL も設定でき、アプリが可用性に基づいてローカルとリモートを自動的に切り替えます。

2
ブラウザで認可

ブラウザウィンドウが開きます。Home Assistant にサインインし、認可リクエストを承認してください。

3
接続完了

HomeBe·at がアクセストークンを受け取り、自動的に接続します。トークンはバックグラウンドで更新されます。

Long-Lived Access Token

OAuth フローを使用したくない場合や、ブラウザベースの認証が実用的でない環境（tvOS など）から接続する必要がある場合は、Long-Lived Access Token（LLAT）を使用できます。

トークンの作成

1
HA プロフィールを開く

Home Assistant で左下のユーザーアバターをクリックし、プロフィールページに移動します。

2
Long-Lived Access Token までスクロール

プロフィールページの下部にある Long-Lived Access Token セクションを見つけます。

3
トークンを作成

「トークンを作成」をクリックし、「HomeBe·at」などの名前を付けて、生成されたトークンをコピーします。このトークンは再度表示できません。

4
HomeBe·at に貼り付け

アプリの接続設定で LLAT オプションを選択し、トークンを貼り付けます。

注意: Long-Lived Access Token は自動的に有効期限が切れることはありません。Home Assistant のプロフィールページからいつでも取り消すことができます。

tvOS 認証

Apple TV ではブラウザベースの OAuth は利用できません。2つのオプションがあります：

  • macOS とペアリング — 同じ iCloud アカウントでサインインした Mac に HomeBe·at がセットアップされている場合、iCloud キーチェーン経由で認証情報が自動的に共有されます。
  • Long-Lived Access Token — Apple TV のオンスクリーンキーボードまたは iPhone のリモートアプリを使用して、HA の URL と LLAT を直接入力します。

トークンの保存

すべての認証トークンは、システムキーチェーン（macOS）または共有 iCloud キーチェーン（tvOS）に安全に保存されます。サードパーティのサーバーに送信されることはありません。