Hangar запускает программы на твоём компьютере и передаёт им твой ввод. На этой странице описано, от чего приложение должно защищать, что для этого делает выпущенная версия, где проходят границы и как сообщить об уязвимости.
От чего Hangar должен защищать
Агент или подменённый репозиторий не должен через Hangar ничего запускать и ни до чего добираться без твоего разрешения. Отсюда следуют такие цели:
- Рабочая папка, профиль или источник обновлений не заставляют Hangar выполнять код, который ты не запрашивал.
- Интерфейс достигает только тех функций ядра приложения, которые ему явно выданы.
- Секреты не попадают в журналы, файлы конфигурации и сохранённую историю терминала, кроме случаев, описанных в настройках.
- Обновление устанавливается, только если его подпись верна.
Что для этого делает Hangar
Hangar запускает программы как список аргументов, а не как составленную для оболочки командную строку. В Windows сессии обновления и пакетные файлы не ищут программы в рабочей папке.
Секретные переменные профиля хранятся в хранилище учётных данных операционной системы, а не в файле.
- Вставленный текст теряет управляющие символы, прежде чем попадает в программу.
- Если Hangar сам вставляет многострочный текст из заметок или фрагментов в программу, у которой не включён Bracketed Paste, он сначала спрашивает.
- Ссылки в терминале открывают только веб-адреса с http или https, а также локальные файлы и папки, но не сетевые пути и не пути к устройствам. Файл открывается, только если у него безопасное расширение; остальные Hangar показывает в файловом менеджере.
- Дополнительные окна, например просмотр файлов, могут вызывать только те команды, которые выданы каждому из них отдельно.
В командных сессиях Hangar спрашивает, прежде чем агент изменит файл, над которым сейчас работает другая сессия или участник команды. Ты отвечаешь один раз, для этого файла, или правилом «Всегда» либо «Никогда» для файла или папки проекта. Каждый автоматический ответ записывается в журнал. Если ответа нет десять минут, Hangar отклоняет запрос. Это относится к Claude Code, Codex CLI, OpenCode и Pi.
Данные команды шифруются сквозным шифрованием. Сервер хранит и пересылает их, но прочитать не может. Он видит, кто состоит в команде, какие есть устройства, когда и сколько передаётся и кто с кем общается. Новое устройство входит в команду, только когда уже подключённое устройство сверило его номер безопасности и подтвердило его. К релею Hangar подключается только по wss, а по незашифрованному ws только к адресу на этом же компьютере. Общие заметки хранятся в репозитории в зашифрованном виде.
Обновления
Каждое обновление подписано. Перед установкой Hangar проверяет подпись по ключу, встроенному в приложение, и отклоняет любой файл с неподходящей подписью.
У установщика пока нет подписи сертификата подписи кода. Поэтому при первом запуске Windows может показать предупреждение SmartScreen. К каждому релизу прилагается файл SHA256SUMS.txt, по которому можно проверить загрузку вручную.
Исправления безопасности выходят только для последней версии. Hangar обновляется сам.
Границы
- Hangar не песочница. Агенты и оболочки работают с твоими правами и сами выполняют свои команды.
- Личные сессии работают без вопросов, которые задают командные сессии. Новые сессии по умолчанию начинаются личными.
- Об уязвимостях в самих CLI агентов, пожалуйста, сообщай их производителям.
- Другие меры защиты готовятся. Они появятся здесь, как только выйдет версия с ними.
Сообщить об уязвимости
Пожалуйста, не создавай публичный issue. Воспользуйся вместо этого закрытым сообщением об уязвимостях на GitHub. Укажи версию Hangar, свою операционную систему, шаги для воспроизведения и ожидаемые последствия.
Первый ответ ты получишь в течение недели. Когда исправление будет выпущено, описание уязвимости публикуется с указанием твоего имени, если ты не хочешь иного.
К таким случаям относятся, например, рабочая папка, профиль или источник обновлений, которые заставляют Hangar выполнить код, который ты не запрашивал, интерфейс, который достигает не выданных ему функций ядра приложения, секреты, которые сверх описанного в настройках попадают в журналы, файлы конфигурации или сохранённую историю, а также любой обход подписи обновлений.