Verfy
Безопасность

Модель безопасности простыми словами

Невзламываемых продуктов не бывает, и Verfy так о себе не говорит. Эта страница объясняет, что Verfy защищает, как и где его защита заканчивается. Полная модель угроз лежит в репозитории: docs/THREAT_MODEL.md.

доказывает Квитанция показывает

  • какой вызов инструмента прошёл через Verfy, когда и в какой сессии;
  • вердикт, сработавшие правила и хеш политики, по которой он принят;
  • дайджест определения инструмента и хеш аргументов и результата с секретной солью, так что по квитанции их не угадать;
  • что её подписало устройство, у которого есть ключ, и что с тех пор ни одна квитанция в цепочке не изменена, не удалена и не переставлена.

не доказывает Квитанция не может показать

  • что инструмент или MCP-сервер сделал внутри себя после вызова;
  • действия, которые вообще не прошли через хук или шлюз Verfy;
  • что само устройство не было взломано в момент подписи;
  • что весь журнал не удалили и не начали заново или не собрали и не переподписали ключом устройства (это видно только по внешней копии, например по квитанциям, уже отправленным в Verfy Cloud).

Что уже сделано

Разделение команд

Защита на уровне строк в каждой таблице, привязанная к членству вошедшего пользователя. Серверные маршруты проверяют организацию ещё раз. Доступ между командами покрыт автотестами на настоящем Postgres.

Никаких прямых записей

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

Доказательства только на добавление

В Verfy Cloud квитанции, опубликованные версии политик и журнал аудита нельзя изменить или удалить, даже секретным ключом сервера. Журнал на устройстве — файл владельца: verfy verify покажет любую правку в нём.

Ключи устройств

Квитанции подписываются на устройстве ключом Ed25519. Сервер хранит только открытые ключи и при загрузке заново проверяет каждую подпись и каждую хеш-связь.

Секреты

Секретный ключ Supabase используется только в серверном коде после того, как Verfy проверил вызывающего. Токены устройств и приглашений хранятся как хеши SHA-256.

Доступ оператора

У оператора Verfy одна страница только для чтения со списком аккаунтов, организаций и листа ожидания (без содержимого квитанций и политик). Она открывается только его аккаунту после второго фактора; остальные получают 404, а каждый просмотр пишется в журнал только на добавление до того, как что-либо прочитано.

Защита сайта

CSP без неназванных встроенных скриптов (nonce на каждый запрос на страницах после входа, SHA-256 каждого скрипта на публичных), HSTS, запрет встраивания в рамки, строгая политика referrer, проверка origin при каждом изменении по cookie, проверка схем с ограничением размера и безопасные сообщения об ошибках.

Ограничение частоты

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

Цепочка поставок

Зафиксированные зависимости с lock-файлом, аудит зависимостей и поиск секретов в CI, а у CLI нет обязательных сторонних пакетов.

Может ли агент отключить Verfy?

Мы попробовали очевидные способы. Verfy не даёт агенту править настройки хука, lock-файл, политику или установку Verfy и не даёт самому одобрить изменение инструмента. Verfy не может проследить за программой, которую агент записал в файл и затем запустил: такая программа всё ещё может поменять настройки в ваших файлах. С verfy setup --system --write, запущенным от администратора, хуки Claude Code и Cursor лежат в общесистемных файлах, которые агент, работающий от вашего имени, изменить не может вовсе. Изнутри компьютера Verfy также не заметит, что его хук удалили, потому что удалённый хук не запускается; в команде устройство просто перестаёт присылать квитанции. Повторная проверка настроек при старте сессии этого не изменит: она жила бы в том же файле настроек.

Попытки отключить Verfy и ответ Verfy
Что пробует агентВердиктПравило
Править ~/.claude/settings.json, чтобы убрать хукdenyVFY-SELF-001
printf '{}' > .claude/settings.jsondenyVFY-SELF-001
rm ~/.claude/settings.jsondenyVFY-SELF-001
Править ~/.codex/hooks.json, ~/.gemini/settings.json или .github/hooks/verfy.jsondenyVFY-SELF-001
verfy lock approve filesystem --yesdenyVFY-SELF-003
pip uninstall -y verfydenyVFY-SELF-004
Править .mcp.json, чтобы вывести сервер из-за шлюзаaskVFY-SELF-002
python -c "open('.claude/settings.json','w').write('{}')"askVFY-SELF-005
cat ~/.verfy/key.json (ключ подписи)denyVFY-SELF-006
Прочитать ~/.verfy/team.json (токен устройства)denyVFY-SELF-006
Записать fix.py, затем запустить python fix.pyallowне отслеживается

Песочница: что она удерживает и что нет

Сам Verfy не песочница: его проверки видят то, что проходит через хук или шлюз. Для изоляции verfy run --sandbox запускает команду, MCP-сервер или самого агента внутри открытой песочницы Anthropic, srt, а ограничения обеспечивает операционная система.

Удерживает

  • команду и всё, что она запускает, включая скрипт, который написал агент;
  • сеть: никаких хостов, кроме разрешённых вами;
  • запись: только в эту папку и в добавленные вами, и не в файлы, которые решают, что запустится потом: verfy.lock, .mcp.json, файлы хуков агентов и git-хуки, даже если их ещё нет;
  • чтение папок с учётными данными и файлов, которые ваша политика называет чувствительными, а в WSL — тех же папок каждого пользователя Windows;
  • ваше окружение: внутрь попадают только PATH, HOME и другие основные переменные, а ключи API остаются снаружи.

Не удерживает

  • то, что вы запустили не через неё: она выключена, пока вы её не попросите;
  • чтение остального диска;
  • ключ, который вы передали через --allow-env, или собственный ключ агента, запущенного с --agent: он может уйти через любой разрешённый хост;
  • разрешённый хост: он разрешён целиком;
  • Windows без WSL: там нет среды выполнения, поэтому песочница работает через WSL2.

srt — исследовательская предварительная версия, которую вы ставите сами. С --agent от ключа подписи агента удерживает guard, а не песочница. Поле sandbox в квитанции — то, что сообщает машина, а не доказательство.

Известные ограничения

  • Правила guard — это сопоставление с шаблонами. Настойчивый атакующий может сформулировать команду, которую Verfy не узнает; неизвестные опасные шаблоны не считаются безопасными, но правила — не песочница. Для недоверенного кода используйте verfy run --sandbox, контейнер или виртуальную машину.
  • Считайте guard ремнём безопасности, а не стеной. В нашем внутреннем тесте список из 113 атак, написанный после очередных исправлений, провёл через 0.16.1 59 атак. Мы исправили всё по этому списку, и при повторной проверке (6 ноября 2026) 0.17.0 остановил все 113. Исправления делались с этим списком перед глазами, поэтому следующий новый список найдёт ещё. Это не независимый аудит. Для недоверенного кода используйте песочницу.
  • Команды Windows проверяются шаблонами по тексту, а это слабее, чем разбор оболочки, который у Verfy есть для bash.
  • Verfy не может оценить пакет или скрипт по имени, поэтому npx, uvx и скрипт в проекте запускаются без вопроса. Отправка сообщения через MCP-инструмент не требует подтверждения, если вы не указали этот инструмент.
  • Сканер находит известные тревожные признаки. Чистый результат сканирования не значит, что инструмент безопасен.
  • Защита от DDoS зависит от вашего хостинга и его настроек. Verfy добавляет ограничения частоты в приложении, но не заменяет межсетевой экран.
  • Независимого теста на проникновение ещё не было. Относитесь к этому выпуску как к MVP и проверьте его, прежде чем на него полагаться. В ноябре 2026 мы дважды провели внутренний тест атак и исправили то, что прошло. Код писали мы сами, поэтому это не независимая проверка.

Проверить выпуск

Аттестация сборки показывает, что файл собрал workflow этого репозитория. Скрипты установки проверяют её сами, если есть GitHub CLI с выполненным входом. Одна только контрольная сумма показывает лишь, что файл скачан целиком: список берётся из того же выпуска.

$ gh attestation verify verfy-linux-x64.tar.gz -R verfy-dev/verfy-releases

Без GitHub CLI используйте cosign 3 или новее. Начиная с 0.16.1 файл SHA256SUMS каждого автономного выпуска подписан через Sigstore, поэтому проверка подписи, а затем списка показывает, что загрузку собрал workflow этого репозитория.

$ cosign verify-blob SHA256SUMS --bundle SHA256SUMS.sigstore.json \
    --certificate-identity https://github.com/verfy-dev/verfy-releases/.github/workflows/build.yml@refs/heads/main \
    --certificate-oidc-issuer https://token.actions.githubusercontent.com
$ sha256sum -c SHA256SUMS --ignore-missing

У файлов на PyPI есть аттестация Sigstore с названием репозитория, который их опубликовал. pip install verfy её не проверяет, поэтому выполните проверку сами. Команда печатает OK: и имя файла и завершается ошибкой, если файл опубликовал другой репозиторий. Те же файлы, каждый с пакетом Sigstore, лежат в GitHub-выпуске этой версии в исходном репозитории.

$ pip install pypi-attestations
$ pypi-attestations verify pypi --repository https://github.com/verfy-dev/verfy pypi:verfy-0.23.1-py3-none-any.whl

Найдите обход

Профессионального теста на проникновение у Verfy ещё не было, поэтому мы просим всех попробовать его сломать: команда, путь, URL или вызов инструмента, которые должны быть запрещены или требовать подтверждения, но проходят; способ для агента отключить Verfy; изменённый MCP-инструмент, который проходит через шлюз; или отредактированная цепочка квитанций, которая всё ещё проходит проверку. verfy check "…" показывает вердикт, ничего не запуская.

Сообщите о нём закрыто (ниже). С вашего разрешения каждый, кто нашёл настоящий обход, попадает в зал славы и упоминается в примечаниях к выпуску. Известные ограничения, например скрипт, который агент пишет и потом запускает, перечислены выше и обходом не считаются.

Сообщить об уязвимости

Пожалуйста, сообщайте о проблемах безопасности закрыто, а не в публичных issues. Используйте закрытую форму GitHub для уязвимостей в репозитории Verfy (открыть форму). Способ для агента обойти Verfy тоже считается уязвимостью. Если GitHub вам недоступен, напишите на security@verfy.dev. Приложите шаги для воспроизведения и проверенную версию. Мы стараемся подтвердить получение в течение 2 рабочих дней, держать вас в курсе до выхода исправления и исправить подтверждённую проблему в течение 90 дней. Мы публикуем уведомление, когда исправление вышло, или не позже чем через 90 дней. То же написано в security.txt.

Пожалуйста, не тестируйте чужие установки, не открывайте чужие данные и не ухудшайте работу сервиса для других.

Безопасная гавань

Мы не будем преследовать по закону добросовестное исследование, которое остаётся в рамках этой политики, не нарушает приватность и не ухудшает работу сервиса, не открывает чужие данные и даёт нам разумное время на исправление до раскрытия. Проверяйте CLI на своём компьютере, а Verfy Cloud — со своим аккаунтом. Это касается только Verfy: за Supabase, Vercel и GitHub мы говорить не можем, поэтому о проблемах в их сервисах сообщайте им.