Доступы и уровни
Каждое устройство и каждый браузер входят в дом со своим доступом. Доступ — это уровень, разрешения поверх него, список открытых домов и, по желанию, срок. Всё это проверяет сайдкар, а не приложение: гостю не выдают учётку Home Assistant вовсе.
Уровни
Каждый следующий уровень включает предыдущий.
| Уровень | Что может |
|---|---|
| Гость | Ходит по дому и видит свет. Ничего не переключает; датчиков и истории не видит |
| Свет и розетки | Плюс включает свет и устройства, кроме защищённых |
| И защищённое | Плюс защищённые устройства: щиток, котёл, розетка холодильника |
| Правит дом | Плюс правит план и расстановку, видит датчики. Доступы раздавать не может |
| Владелец | Всё, включая доступы, обновления и удалённую поддержку |
Владельцем становятся через админство в Home Assistant или по личному приглашению от другого владельца; открытой ссылкой владельца не раздают. Граница между «Правит дом» и «Владельцем» — раздача доступов: редактор доступы не выдаёт и владельца себе выдать не может.
Разрешения
Поверх уровня. Уровень отвечает, чем человек распоряжается, разрешения — откуда и как.
| Разрешение | По умолчанию | Что значит |
|---|---|---|
| Можно снаружи | выключено | Управлять домом не из домашней сети. Ходить по дому и говорить это не запрещает |
| Голос | включено | Голосовая связь в прогулке |
| Лицо | включено | Живое лицо с камеры вместо картинки. Включает его сам человек у себя; это запрет сверху, а не разрешение снизу |
| Демо | включено | Дом в кармане: без связи с домом, по скачанному плану, с выдуманными датчиками |
| Бета-сборки приложения | выключено | Устройство получает бету, когда она новее основной сборки. Ставится в правке доступа, не в приглашении из приложения |
У доступа есть и срок в днях: «гость на выходные» погаснет сам. 0 — без срока. В приложении срок задаётся в правке доступа, в веб-версии — и при приглашении.
Отзыв не отменяет скачанного
Демо работает без связи. У того, кто уже скачал дом и ушёл в самолёт, отобрать демо нельзя. Запрет действует, как только устройство снова дотянется до сайдкара.
Защищённые устройства
В карточке устройства есть отметка «Управляет не всякий». Такое устройство переключают только уровни «И защищённое» и выше. Попытка уровня ниже отклоняется и попадает в журнал. Алисе защищённые устройства не отдаются: она слушается любого голоса.
Пока ни одно устройство не отмечено, «Свет и розетки» и «И защищённое» ничем не отличаются.
Владелец
Первый владелец появляется при установке: установщик печатает QR, приложение снимает его в мастере первого запуска на шаге У меня приглашение и становится владельцем. Там же показывается ключ владельца — шесть групп по пять знаков, перепишите его на бумагу. См. Установка.
Владельцев может быть несколько. Второй взрослый в доме становится владельцем одним из двух путей:
- По приглашению. Владелец выдаёт личное приглашение с уровнем «Владелец» или поднимает до него уже выданный доступ в правке. См. Приглашение.
- Через админство в Home Assistant. Нужны адрес и токен администратора:
- Настройки → Дом → Адрес и токен HA.
- Настройки → Доступ → Сайдкар дома → Стать владельцем.
- Появится ключ владельца. Перепишите его на бумагу и нажмите Записал.
Устройство при этом уже получило свой доступ, ключ ему больше не нужен. Ключом владельца входят в веб-версию (вкладка Ключ владельца на странице входа) и возвращают себе дом, если приложение снесли.
Ключ показывается один раз
У сайдкара лежит только отпечаток ключа. Потеряли — получите новый тем же путём, предъявив админство. Старый ключ перестанет работать, а доступы устройств останутся.
Приглашение
Раздавать доступы может только владелец.
В приложении: Настройки → Доступ → Сайдкар дома → Пригласить устройство.
- Впишите, чьё устройство: «телефон Пети». По этой подписи потом отзывают.
- Выберите уровень и разрешения. Уровень «Владелец» тоже здесь: владельцу открыты все дома, поэтому выбор домов для него скрыт.
- Если у сайдкара несколько домов — отметьте, какие открыть.
- Выдать. На экране появится QR-код. Нажатие на код копирует его в буфер.
В веб-версии: страница Доступы → Пригласить устройство; Пригласить гостя — то же приглашение, но сразу заполненное гостем на три дня. Код показывается двумя QR: Для браузера (ссылка …/web/join#c=…, вход происходит сам) и Для приложения. Рядом кнопки скопировать код или ссылку. Приложение читает оба QR: в ссылке «Для браузера» адрес дома — сама ссылка, так одним QR заводят и браузер, и телефон. Если внешнего адреса у дома нет, в QR кладётся адрес, по которому владелец открыл веб-версию.
Ссылка ведёт туда, откуда её выдали: получатель попадает в тот же дом и тот же вид — план, изометрию, 3D или прогулку, — а не на план своего дома. Дом в приглашении по умолчанию — открытый на экране.
Приглашение одноразовое и живёт сутки. Нужно позвать сразу нескольких — открытая ссылка.
Предупредите приглашённого
Действия над домом пишутся в журнал, и журнал видит владелец. Прогулки, голоса и перемещений там нет.
Открытая ссылка
Одна ссылка на нескольких человек и на время: позвать пятерых в прогулку — одна ссылка в общий чат, а не пять кодов. Открывает только владелец.
В приложении: Настройки → Доступ → Сайдкар дома → Доступы, карточка Открытая ссылка → Открыть ссылку. В веб-версии: страница Доступы → Открытая ссылка.
| Поле | Что значит |
|---|---|
| Ссылка открыта | Сколько ссылка принимает новых: от 1 часа до 7 дней |
| Сколько человек | Предел входов. 0 — сколько угодно |
| Уровень, Разрешения, Дома | Что получит каждый вошедший. Владельца и мастера ссылкой не раздают |
| Срок доступа, дней | Срок каждого доступа, от момента, когда человек зашёл. 0 — без срока |
| Подпись | Как вошедшие подписаны в списке доступов, по умолчанию «Гость по ссылке» |
Открыть ссылку показывает ссылку вида …/web/open#c=… и её QR. Ссылку показывают один раз — скопируйте сразу. Как и приглашение, она ведёт в тот дом и вид, откуда её открыли.
Человек открывает ссылку в браузере, тихо получает свой доступ и настраивает только себя: Имя над головой, Цвет одежды, микрофон при входе и Звуки прогулки — и жмёт В дом. Повторный заход с того же браузера второго доступа не заводит. Браузер, который уже вошёл в дом иначе, спросит: Остаться как есть или Войти по ссылке.
В списке доступов каждый вошедший — отдельная строка с пометкой по ссылке, и отзывается он сам по себе. У самой ссылки две кнопки: Закрыть — новые не войдут, вошедшие остаются; Закрыть и отозвать всех — гасит и уже выданное. У закрытой ссылки с живыми доступами остаётся Отозвать всех.
Одна ссылка принимает не больше 20 входов в минуту. О заходах владельцу приходит уведомление сводкой раз в минуту, а не по сообщению на каждого.
Выше «гостя» — осторожно
Ссылку могут переслать дальше: пока окно открыто, выбранный уровень получит любой, к кому она попадёт. Форма предупреждает об этом, как только уровень выше «Гостя».
Ссылка на установку
Установщики Homer публично не выкладываются: новый дом ставят по ссылке от того, у кого Homer уже стоит. Это не доступ к вашему дому — получатель поднимает свой. Выдаёт только владелец, в веб-версии: страница Доступы → Ссылка на установку, рядом с «Открытой ссылкой». В приложении этой кнопки пока нет.
| Поле | Что значит |
|---|---|
| Подпись | Кому ссылка: «Петя, дача». По ней ссылку потом узнают в списке |
| Действует | Бессрочно, 7, 30, 90 или 365 дней |
| Сколько установок | Предел установок сервера. 0 — без лимита |
Выдать ссылку показывает ссылку вида https://<адрес дома>/web/get#t=… и её QR. Показывают их один раз — Копировать сразу. Получатель открывает её и видит страницу «Установка Homer» с вашим приглашением, а на ней команду для сервера дома (Linux или Windows), кнопку Скачать APK — приложение Homer для Android, та же сборка, которую ваш сервер раздаёт вашим устройствам, — и кнопку Скачать Homer Node. Что делать с ними дальше — Установка.
Считается каждый запуск установки сервера — он и тратит лимит. Скачивание APK считается отдельно и лимита не тратит. О каждой установке по ссылке владельцу приходит уведомление.
В списке у каждой ссылки — состояние (открыта, закрыта, истекла, исчерпана), «установок N», «APK: N», когда была последняя установка и срок. Закрыть — по ссылке больше ничего не поставить и не скачать; уже поставленные дома живут дальше.
Принять приглашение
Телефон и планшет: Настройки → Доступ → Сайдкар дома → Принять приглашение → Снять камерой. Адрес дома приезжает вместе с кодом.
Телевизор: камеры нет, поэтому код набирают руками — двадцать два знака с экрана владельца, поле Код приглашения. Адрес дома берётся из поля Домашний адрес выше. Удобнее всего скопировать код нажатием на QR у владельца и переслать.
Браузер: открыть ссылку приглашения или вставить код на странице входа, вкладка По приглашению. Там же можно сразу задать имя и картинку лица для прогулки. Браузер получает собственный доступ, владелец видит его в общем списке.
В поле кода приложения можно вставить и ссылку приглашения целиком (…/web/join#c=…): адрес дома возьмётся из неё.
Список доступов
В приложении: Настройки → Доступ → Сайдкар дома → Доступы. В веб-версии: страница Доступы.
В списке — подпись, модель устройства, уровень, разрешения, дома и когда устройство было в последний раз; вошедшие по открытой ссылке помечены по ссылке. Нажатие открывает правку: уровень, разрешения, дома, подпись, срок. Правка доходит до устройства сразу, без нового приглашения. Поднять доступ до «Владельца» можно и правкой; уровень уже выданного владельца правкой не меняется — такой доступ только отзывают.
Отозвать закрывает доступ мгновенно, в том числе в идущей прогулке. Отозванные видны отдельным списком.
Доступ, который не заходил больше двух месяцев, помечен давно не заходил. Сам он не гаснет: настенный планшет может молчать неделями. Если устройство потеряно или гость уехал — отзовите; в веб-версии кнопка Отозвать прямо в строке. Доступу можно задать и срок — после него он погаснет сам.
Забыть доступ на карточке «Сайдкар дома» стирает секрет только на этом устройстве. Сам доступ в доме остаётся, пока его не отзовёт владелец. Нужно, когда доступ уже отозвали, а устройство продолжает его предъявлять.
Снаружи дома
Сайдкар отличает домашний вход от внешнего по тому, каким портом пришёл запрос, а не по заголовкам. Доступ без Можно снаружи снаружи ходит по дому и говорит, но не управляет. Как настроить внешний адрес — Установка.
В веб-версии меню под вашим именем показывает уровень, вход («из дома» или «снаружи») и что можно этому браузеру: голос, лицо с камеры, управление снаружи.
Адрес веб-версии
Из него строятся ссылки приглашений и «место в доме». В приложении — на карточке Сайдкар дома, в веб-версии — первым полем на странице Доступы. Пусто — берётся адрес страницы, с которой ссылку сделали.
Журнал
Владельцу виден журнал: кто что включал — через приложение, в самом Home Assistant и выключателем на стене. Отказы записываются наравне с удачами. В приложении — кнопка Журнал на карточке «Сайдкар дома», в веб-версии — вкладка Журнал в «Состоянии дома».
Я в доме
В веб-версии: меню под именем → Настройки → Я в доме.
- Имя — подпись над головой в прогулке.
- Лицо — своя картинка, живое с камеры или пустая маска. Живое лицо недоступно, если владелец не разрешил.
- Цвет одежды — чтобы в доме отличать, кто есть кто.
Пинкод поручений
Колонку Хомера может позвать любой, кто в комнате. Поручения старшей модели закрываются пинкодом или парольной фразой: Настройки → Колонка → Мозги Хомера → Пинкод поручений. Подробнее — Безопасность колонки.
Мастер поддержки
Мастера пускают не приглашением, а сеансом на несколько часов. У мастера права редактора без права раздавать доступы. См. Удалённая поддержка.