{# plugins/homeassistant/templates/homeassistant/form.html — where Home Assistant is, what signing in gives Steward, and leaving for its sign-in page. #} {% extends "base.html" %} {% from "_macros.html" import crumbs, page_header %} {% block title %}Home Assistant connection — Steward{% endblock %} {% block breadcrumb %}{{ crumbs([("Home Assistant", "/plugins/homeassistant/"), ("Connection", "")]) }}{% endblock %} {% block content %} {{ page_header("Home Assistant connection") }}
{% if error %}{% endif %} {% if connection %}

Signed in{% if connection.signed_in_at %} {{ connection.signed_in_at|ago }}{% endif %}{% if connection.signed_in_by %} by {{ connection.signed_in_by }}{% endif %}, as {{ "an administrator: Steward can install updates" if connection.can_install else "a user who isn't an administrator: Steward shows status only" }}.

{% endif %}
{{ csrf_field() }}

Sign in with Home Assistant

Both your browser and Steward need to reach it at this address.

Steward stores a credential with the same access as the user who signs in. Home Assistant has no narrower permission, so an administrator's credential can do anything that administrator can, including controlling every device. Steward only uses it to read status, take backups and install updates.

We recommend a service account: a Home Assistant user made just for Steward (Settings → People → Add person). What Steward does then appears under its own name in Home Assistant's logs, so it's easy to tell apart from what people do.

Installing updates needs an administrator. With any other user, Steward shows status only.

Cancel
{% if connection %}

Remove this connection

Steward stops reading Home Assistant, forgets its credential and ends the sign-in there.

{{ csrf_field() }}
{% endif %}
{% endblock %}