Home Assistant
Home Assistantを接続してアクセスをテストし、各エンティティを読み取り専用にするか操作も許可するかを個別に決めます。
接続後にできること
明確な依頼があると、Assistelaからスマートホームの現在の状態を読み取り、Home Assistantのサービスを呼び出せます。温度センサーの確認、照明状態の読み取り、許可したカメラからのスナップショット取得、シーンの実行、明示的に許可したデバイスの操作などができます。
接続には2段階の保護があります。Home Assistantのアクセストークンと、Assistela内のエンティティ許可リストです。トークンがさらに多くの操作を許可していても、Assistelaはリストに追加していないエンティティの使用を拒否します。
1. 長期アクセストークンを作成する
プロフィールを開く
Home Assistantでユーザープロフィールを開き、Long-Lived Access Tokensを探します。
トークンを作成する
新しいトークンを作成し、Assistela Macなど識別しやすい名前を付けます。
すぐにコピーする
Home Assistantでトークン値が表示されるのは通常1回だけです。値をコピーし、Assistelaへ保存するまでダイアログを開いたままにします。
「チャット」、「メモリ」、通常のメモには貼り付けず、Home Assistantのアクセスキー欄にだけ入力してください。Assistelaでは保護された認証情報として保存されます。漏えいした可能性がある場合は、Home Assistantで無効にし、新しいトークンを作成します。
2. Assistelaをペアリングする
「連携」を開く
AssistelaでAssistela → 設定 → 連携 → Home Assistantを選び、「ペアリング」タブを開きます。
アドレスを入力する
「Home Assistantアドレス」に、ブラウザで使っているものと同じURLを入力します。http://またはhttps://とポートも含めてください。ローカルアドレスの例はhttp://homeassistant.local:8123です。
アクセスキーを貼り付ける
作成したトークンを「Home Assistantアクセスキー」に貼り付けます。
保存してテストする
「保存して接続をテスト」をクリックします。ローカルアドレスを使う場合、macOSからローカルネットワークへのアクセスを求められることがあります。この用途のために許可してください。
3. 選択したエンティティだけを許可する
「許可するエンティティ」を開いて項目を更新します。一覧を検索したり、種類で絞り込んだりできます。各エンティティには2つの独立した選択肢があります。
- 読み取り：Assistelaから状態と属性を取得できます。状況の報告だけが必要なセンサーやデバイスに適しています。
- 操作：照明をつける、シーンを実行するなどの操作を呼び出せます。「操作」を有効にすると「読み取り」も有効になります。
最初は、温度センサーとテスト用照明など、少数の無害な項目だけを追加してください。必要な指示と承認方法を明確にするまでは、ドアロック、警報、ガレージドア、暖房など、安全に関わるデバイスの「操作」を有効にしないでください。
最初のテスト
- 「リビングのセンサーは現在どのような状態ですか？」と尋ねます。
- 読み取りが正常なら、許可した照明をテストします。「オフィスのテスト用照明を短時間つけてください。」
- その後、Home Assistantで状態を直接確認します。
エンティティが見つからない場合は一覧を更新します。「見つかりません」という状態は通常、Home Assistantで名前が変更されたか削除されたことを示します。現在のエンティティIDを選び直してください。