harnsy · harnsy Max
Ваши агенты на телефоне.
С harnsy Max установите дашборд на телефон как приложение. Вопрос или запрос разрешения от агента приходит push-уведомлением, и вы отвечаете с телефона, даже когда приложение закрыто. Это веб-приложение, которое ставится из браузера, а не приложение из магазина.
Установите из браузера.
Откройте дашборд на телефоне через доступ снаружи и воспользуйтесь командой браузера «На главный экран» («Установить»). После этого дашборд открывается как приложение, со своим значком.
Push, когда вас ждёт агент.
Вопросы и запросы разрешений приходят на телефон, даже когда приложение закрыто. В уведомлении названы проект и команда, а сам вопрос не показан, так что на экране блокировки ничего личного нет. Нажмите, и откроется терминал этого агента, а если терминала нет, список тех, кто ждёт.
Терминал, который помещается в телефон.
Терминал на телефоне занимает весь экран и добавляет ряд клавиш, которых нет на клавиатуре телефона (Esc, Tab, стрелки, Enter и Ctrl+C). Историю листаете касанием. Набирать в агента снаружи нельзя, пока вы не включите полное управление на самой машине. Оно выключается само: по умолчанию через два часа, а вы можете задать от 1 до 24 часов.
Нет публичного адреса? Телефон подключит релей.
Большинство домашних компьютеров и ноутбуков из интернета не достать. С harnsy Max ваша машина сама выходит к релею, а телефон заходит через него. Порт открывать не нужно, публичный IP-адрес тоже. Наш релей в бете.
Соединение зашифровано от конца до конца: TLS идёт от вашего телефона до вашей машины, а наш релей только пересылает зашифрованные байты. У него нет ключа, которым их можно прочитать.
Одна оговорка: службу имён для вашего адреса держим мы, поэтому теоретически мы могли бы получить на него сертификат. harnsy каждые 6 часов проверяет публичные журналы сертификатов и предупреждает вас, если такой появится. Он обнаруживает такую атаку, но не может её предотвратить.
harnsy
shop-lead задаёт вопрос
acme-shop · shop
TLS идёт от телефона до вашей машины и заканчивается на ней. Релей только передаёт зашифрованные байты.
1. Ваша машина выходит наружу.
harnsy на вашей машине открывает соединение к нашему релею и держит его открытым. Это исходящее соединение, как при открытии любой веб-страницы, так что на роутере ничего менять не нужно.
2. Телефон открывает ваш адрес.
У вашей машины есть собственный веб-адрес. Телефон открывает его как обычный сайт и попадает на релей.
3. Релей соединяет их.
Релей соединяет поток телефона с соединением, которое держит ваша машина, и передаёт байты между ними.
4. Отвечает ваша машина.
Защищённое соединение (TLS) заканчивается на вашей машине, с ключом, который остаётся там. Вход и проверка passkey тоже происходят там, а не на релее.
5. Вы внутри.
Телефон показывает ваш дашборд, как за рабочим столом. Сам релей внутрь не попадает.
Что видит релей, а что нет.
Релей читает только имя адреса, который запрашивает телефон, а остальное передаёт дальше в зашифрованном виде. Он знает, откуда примерно пришло соединение (не полный адрес), какая машина и лицензия (только в виде коротких кодов), когда, как долго и сколько данных. Содержимое, адреса страниц, cookie, имена и почту он не записывает.
Это безопасно?
Из интернета все двери закрыты. Без авторизации никто не войдёт: доступ вы выдаёте сами, каждому человеку и каждому устройству.
И даже тот, кого вы впустили, может только смотреть, но не действовать: запускать, останавливать и печатать в агентов можно только с вашим passkey, а печатать ещё и после переключателя на вашем компьютере.
Подробности и границы.
- Паролей нет. Вы входите по одноразовому QR-коду, который делается только в вашем дашборде (действует 5 минут, один раз), а затем подтверждаете вход на телефоне отпечатком, лицом или PIN-кодом: это и есть passkey.
- Любое изменение (запуск и остановка агентов, ввод в них, настройки) снова просит отпечаток, лицо или PIN, если прошлая проверка была больше 15 минут назад. Выход, настройки push, создание passkey и просто просмотр терминала этого не просят.
- Сразу после QR-кода телефон 24 часа может смотреть всё в вашем дашборде (агентов, задачи, сообщения, файлы, живой экран терминалов), но почти ничего не может менять, пока вы не создали passkey. Относитесь к QR-коду как к ключу и создайте passkey сразу.
- Печатать в агентов снаружи нельзя, пока вы не включите это на самом компьютере, а через 2 часа оно выключается снова (можно задать от 1 до 24). Телефон, которым вы не пользовались 7 дней, выходит из сессии, а любой телефон выходит через 30 дней.
- Если кто-то узнает адрес вашего дашборда, он увидит только страницу входа — больше ничего. Подобрать вход перебором не получится: после 5 неудачных попыток нужно ждать 30 секунд, потом минуту, потом две — и так до часа.
- Есть ещё два узких входа, и оба создаёте вы. Публичная ссылка открывает один файл, которым вы решили поделиться, пока она не истечёт. Компьютер, который вы подключили к кластеру, входит по собственному токену.
- Ваши агенты и так работают с правами вашего пользователя, поэтому вошедший телефон может давать им поручения. Заблокируйте его экран, а потерянное устройство сразу выведите из сессии.
Наш релей в бете и входит в harnsy Max. Собственный релей тоже может обслуживать телефон, если запущен с веб-зоной. Со своим доменом релея нет: тогда ваша машина или переадресатор перед ней должны быть доступны на порту 443. В руководстве описаны оба случая.
Как работает релей между вашими машинами →Полный обзор безопасности →Настроить доступ снаружи →
Уведомления и в браузере.
На компьютере, если вы включили это в этом браузере, harnsy показывает уведомление, когда агент задаёт вопрос, просит разрешение или ждёт вас, а вкладка harnsy в фоне. В нём названы проект и команда, а вопрос не показан. Нажмите, и откроется терминал этого агента, а если терминала нет, список тех, кто ждёт. Эта часть есть в каждой сборке harnsy.
Или отвечайте из чата.
Если вы живёте в Telegram или Discord, бот на проект приносит вопросы лида проекта и Ассистента в ваш личный чат кнопками. Запросы разрешений приходят туда, только если вы это включили (по умолчанию выключено). Боты — это harnsy Max. Подробнее — «Мессенджеры».
Честно об ограничениях
- Это устанавливаемое веб-приложение, а не приложение из магазина.
- Приложение на телефоне и push требуют harnsy Max. Доступ снаружи нужен только телефону; push на сам компьютер его не требует.
- Телефон, вошедший снаружи, может давать поручения вашим агентам: относитесь к нему как к ключам от машины, с блокировкой экрана.
- Уведомление никогда не показывает вопрос: откройте его, чтобы прочитать и ответить.
- Наш релей в бете. Чтобы телефон достучался, ваша машина должна быть включена и harnsy на ней запущен.
Ваша первая команда — в одной фразе.
Установка — одна фраза вашему агенту. Чтобы harnsy сам открывал агентов, он управляет терминалом: tmux на Linux и macOS, собственный терминальный хост на Windows.
Установи harnsy по инструкции: https://harnsy.dev/llms.txt