Приложение для iPhone

Приложение Piomio для iPhone — твой хаб в кармане: команда, все чаты со всеми карточками, задачи, «Входящие» и подтверждения по Face ID. Интеллекта на телефоне нет. Он подключается к твоему хабу, где бы тот ни работал: на Mac, на PC или на сервере.

Что есть в приложении#

Чат на телефоне — тот же самый чат, что на компьютере, со всеми карточками: входа, форм, карт, страниц, подтверждений. Можно надиктовать вместо того, чтобы печатать, и поменять, как думает агент, прямо из шапки. Настройки, новых агентов, интеллект и плагины меняешь, попросив ассистента в чате, или на компьютере.

Подключить телефон#

1. Возьми QR-код на компьютере. Напиши в чате «подключи мой телефон» или открой Настройки → Устройства → Подключить телефон. Карточка покажет QR-код, который срабатывает один раз и действует час, а если другие устройства уже достают до хаба — ещё и ссылку, которую можно переслать на телефон. На сервере, установленном через install.sh, piomio devices pair (от пользователя piomio) выводит QR-код прямо в терминал.
2. Открой его на телефоне. В приложении нажми Сканировать QR-код или просто наведи на код камеру iPhone. Можно и открыть ссылку на телефоне (на её странице есть Открыть в Piomio) или скопировать её и нажать Вставить ссылку.
3. Подтверди. Приложение спросит «Подключиться к (твой хаб)?», покажет Адреса хаба и отвечает ли каждый, а также проверку шифрования: Ключ совпал. Назови телефон в поле Имя телефона и нажми Подключить с Face ID.

Телефон появится в Настройки → Устройства в разделе Подключённые телефоны, с моделью и временем, когда был в сети. Карандаш переименовывает.

Если Подключить телефон неактивна, телефонам сейчас до хаба не достать: порт для телефонов закрыт, а доступ из любого места выключен. Об этом ниже.

Как телефон достаёт до хаба#

QR-код передаёт телефону все адреса, по которым можно достучаться до хаба, и телефон пробует их сразу все: сначала тот, что сработал в прошлый раз, потом самый ранний в списке из ответивших. Поэтому между домом и улицей он переключается сам.

• Дома — свой порт для телефонов. Хаб открывает в сеть один HTTPS-порт для телефонов, свой порт + 2: 41782 в приложении для компьютера, 8082 на сервере. В сеть открывается только он, а веб-интерфейс и пульт безопасности остаются там, где были. Если дома телефон не подключается, разреши входящие подключения к этому порту в файрволе компьютера (ufw allow 8082/tcp на сервере).
• Через Tailscale. Если на самом компьютере работает Tailscale, его адрес в Tailscale тоже попадает в список: телефон с включённым Tailscale достанет до хаба откуда угодно.
• Вне дома — ссылка доступа из любого места. Когда включён доступ из любого места, в списке есть и постоянная ссылка хаба, и вне дома телефоны ходят по ней. Телефон, подключённый ещё до ссылки, узнает её при следующем соединении.

Порядок в QR-коде такой: адреса из PIOMIO_DEVICE_URLS, потом адреса компьютера в Wi-Fi и Ethernet, его другие локальные адреса, ссылка, его адрес в Tailscale и в самом конце публичный, если он есть.

Шифрование без домена#

Порт для телефонов работает по HTTPS с собственным сертификатом хаба: он создаётся при первом обращении и лежит в папке данных хаба (devices). QR-код несёт его отпечаток, и приложение доверяет этому сертификату и никакому другому: ни домена, ни удостоверяющего центра не нужно. По ссылке доступа из любого места телефон видит тот же сертификат, так что проверка та же.

Настройки порта для телефонов#

За пробросом порта или прокси хаб не видит адрес, по которому к нему ходить телефонам, так что укажи его сам: PIOMIO_DEVICE_URLS=https://home.example.com:8082. Остальные переменные — в Настройках и переменных окружения.

Подтверждения по Face ID#

Когда агент хочет что-то отправить, купить или изменить вовне, карточка подтверждения приходит и на телефон: в чат (Разрешить, Отклонить) и во Входящие (Разрешить, Нет). Чтобы сказать «да», нужен Face ID.

• При подключении телефон создаёт ключ в своём Secure Enclave и отдаёт хабу только открытую часть. Подтверждение подписывает этим ключом одноразовый запрос, а хаб проверяет подпись.
• Токен телефона лежит в Связке ключей iPhone, а хаб хранит только его хэш. Одним украденным токеном ничего подтвердить нельзя.
• Правила, содержимое хранилища и журнал аудита остаются в пульте безопасности на компьютере. Создать или открыть хранилище, когда этого просит карточка, приложение может.

Как устроены подтверждения и автомод на всех устройствах — на странице Подтверждения и автомод.

Делиться местоположением#

Во вкладке Хаб включи Делиться местоположением с агентами. Тогда агенты знают, где ты, — для мест рядом и маршрутов.

• Сначала iOS спросит доступ к геолокации, а потом может один раз спросить, разрешить ли его всегда, чтобы перемещения доходили до хаба и в фоне.
• Телефон сообщает, когда ты заметно сместился, а не шлёт координаты непрерывно, и сам называет место. Хаб хранит только последнее.
• Если выключить, хаб забудет место; то же происходит, когда телефон отключают.

Отключить телефон#

В Настройки → Устройства нажми Отключить в карточке телефона. Он сразу теряет доступ, а приложение на нём выходит из хаба. На самом телефоне: Хаб → Отключить этот телефон. Чтобы пользоваться им снова, подключи его заново по новому QR-коду.