Что такое read-only ключ в Битрикс24 Вайбкод?

Это режим доступа ключа, при котором любые операции записи ( create , update , delete ) блокируются на стороне Вайбкода до того, как запрос дойдёт до Битрикс24. ИИ-агент может читать данные CRM, но не может их изменить - при попытке записи возвращается ошибка WRITE_BLOCKED_READONLY_KEY .

Как быстро перестаёт работать отозванный ключ?

Мгновенно. После деактивации или удаления ключа все запросы с ним получают отказ без задержки. Приложения, привязанные к этому ключу, остаются недоступны до выпуска нового.

Чем отличается деактивация ключа от его удаления?

Деактивация обратима: ключ можно восстановить через меню «Три точки → Активировать». Удаление необратимо и применяется при компрометации - восстановить удалённый ключ невозможно.

Если сотрудник уволился, нужно ли отзывать его ключи вручную?

Частично. Когда администратор Битрикс24 закрывает учётную запись сотрудника, доступ к Вайбкоду через неё закрывается автоматически. Однако отдельные API-ключи, выданные этому сотруднику, нужно отозвать явно в разделе «API-ключи».

Работает ли двухфакторная аутентификация Битрикс24 в Вайбкоде?

Да. Авторизация в Вайбкоде идёт только через учётную запись Битрикс24, поэтому 2FA, настроенная на портале, автоматически распространяется и на Вайбкоде.

Можно ли ограничить ИИ-агента конкретными сущностями CRM, а не всем порталом?

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

Безопасность вайбкодинга в Битрикс24: как не дать ИИ сломать CRM

ИИ-агент, подключённый к CRM с полным доступом, способен за секунды перезаписать тысячи полей или удалить сделки - и вы узнаете об этом слишком поздно. Битрикс24 Вайбкод предоставляет несколько уровней защиты: read-only ключи, изолированные серверы, 2FA и мгновенный отзыв доступа.

Почему вопрос безопасности здесь острее, чем кажется

Обычный сотрудник, ошибившись в карточке сделки, правит одну запись. ИИ-агент с полным доступом к API действует в цикле и может затронуть сотни объектов за один запуск - изменить стадии, перезаписать поля, удалить контакты.

Коварство ситуации в том, что изменения полей CRM не логируются на пользовательском уровне: понять, что именно перезаписал агент, после факта крайне трудно. А откат из резервной копии неизбежно уничтожит свежие данные - те, что появились между последним бэкапом и инцидентом.

Именно поэтому принцип «минимальных привилегий» в Вайбкоде - не паранойя, а базовая гигиена.

Четыре типа ключей Вайбкода и для чего каждый

Вайбкод разделяет доступ на несколько типов ключей - чтобы при утечке одного остальное продолжало работать.

Тип ключа	Префикс	Сценарий использования	Привязка
API-ключ	`vibe_api_`	Личный дашборд, серверная интеграция, бот на своём портале	Один портал, запросы от вашего имени
Ключ авторизации	`vibe_app_`	Приложение для команды или нескольких порталов	Каждый пользователь - со своими правами
Менеджмент-ключ	`vibe_live_`	Администрирование платформы, управление ключами	Не привязан к порталу, к данным CRM доступа нет
Сервисный ключ агента	-	Отладка и починка агента	Живёт 3 дня, отзывной, только к серверу агента

Принцип изоляции: если API-ключ попал в открытый репозиторий, под угрозой только ваши личные автоматизации. Ключ приложения отзывается точечно - остальные приложения не трогаются. Менеджмент-ключ скрыт от пользователя и не может быть скопирован из кода.

При совместном доступе Вайбкод не передаёт ваш ключ коллегам. Платформа выпускает отдельный ключ для каждого получателя; чтобы закрыть доступ одному человеку - отзываете только его ключ.

Режим «только чтение»: главный инструмент защиты от ИИ

У каждого ключа есть переключатель «Режим доступа»:

Чтение и запись - полный доступ к API Битрикс24.
Только чтение - любая операция записи (create, update, delete) блокируется на стороне Вайбкода, до того как запрос дойдёт до Битрикс24. Агент получает ошибку WRITE_BLOCKED_READONLY_KEY с указанием заблокированного метода.

Блокировка происходит именно на уровне Вайбкод - это значит, что даже если ИИ-модель «решит» оптимизировать воронку и попытается удалить серию сделок, запрос физически не дойдёт до CRM.

Три сценария, где read-only обязателен

ИИ-агент для анализа CRM. Агент читает сделки, строит отчёты, находит аномалии - но не трогает данные. Выдайте ему read-only ключ.
Защита при компрометации. Скомпрометированный read-only ключ не позволит злоумышленнику ничего сломать - максимум, что он получит, это чтение данных.
Политика по умолчанию. Администратор в разделе /keys устанавливает правило: все новые ключи - только чтение, а для конкретного сотрудника или интеграции делает точечное исключение с полным доступом. Companion-бот портала уведомляет владельца ключа о каждом изменении режима - с указанием, кто и когда изменил.

Риски автономных ИИ-агентов: что может пойти не так

Понимание рисков помогает правильно выбрать уровень доступа. По нашему опыту работы с внедрениями, типичные сценарии аварий выглядят так:

«Сделано, а по факту нет». Агент отрапортовал об успешном выполнении, но данные записались некорректно или частично. Без логирования на уровне пользователя это заметят только при следующей ручной проверке.
Подмена полномочий. Агент, получив широкий доступ, начинает выполнять действия, которые разработчик не предполагал - например, обращается к сущностям за пределами своей задачи.
Каскадные сбои. Ошибка в одном шаге (например, неверная стадия сделки) запускает цепочку автоматизаций через роботов и триггеры, которые переводят другие объекты в неправильные состояния.
«Слишком усердный помощник». Модель, пытаясь «помочь», выбирает разрушительное действие - массово закрывает лиды как нецелевые, удаляет дубли с полезными данными и т.д.

Вывод прямой: человек должен оставаться в цикле на критичных операциях. ИИ анализирует и предлагает - человек подтверждает запись.

Архитектура безопасности: как устроена защита на всех уровнях

Как Вайбкод выстраивает эшелонированную защиту: запрос от ИИ-агента проходит через несколько барьеров перед тем как (и если) добраться до данных Битрикс24.

flowchart TD
    AI[ИИ-агент / приложение] -->|запрос с ключом| VC[Вайбкод]
    VC -->|read-only? блокировка| BLOCK[WRITE_BLOCKED_READONLY_KEY]
    VC -->|ключ отозван?| DENY[Отказ мгновенно]
    VC -->|OK| BH[Сервер Black Hole]
    BH -->|внутренний туннель| B24[Битрикс24 CRM]
    B24 -->|права пользователя| DATA[Данные сделок / контактов]

Серверы Black Hole - скрыты от интернета. У них нет публичного IP-адреса и они не отвечают на входящие соединения извне. Это закрывает атаки прямым перебором, попытки подключиться к административным портам и утечки ключей с публично доступных страниц.

Авторизация - только через Битрикс24. Отдельных логинов для Вайбкода нет. Если сотрудник уволился - администратор Битрикс24 отключает ему доступ, и доступ к Вайбкоду закрывается автоматически. 2FA, настроенная на портале, действует и в Вайбкоде.

Данные не покидают Битрикс24. Приложение обращается к данным через защищённый канал и не копирует их. На серверы Black Hole передаётся только то, что нужно для ответа на конкретный запрос, и не хранится дольше необходимого.

Все данные и модели - в РФ (на момент публикации).

Настройка ключа: что задать при создании

При создании ключа в Вайбкоде доступны несколько параметров, влияющих на безопасность:

Права доступа ключа

Отметьте только те инструменты Битрикс24, которые реально нужны приложению. По умолчанию выбраны все права - это нужно явно сократить до минимума. Полный список прав доступа: vibecode.bitrix24.tech/docs/scopes.

Срок действия

Ключ можно выдать на 30, 90, 180 дней, 1 год или без ограничений. Для ИИ-агентов рекомендуем ограниченный срок с плановым перевыпуском - это снижает риски от «забытых» ключей.

Лимит запросов в минуту

По умолчанию - 300 запросов в минуту. Для ИИ-агентов, работающих в фоне, установите меньшее значение: если агент из-за ошибки начнёт слать повторные запросы, лимит остановит лавину до того, как она нагрузит API.

Белый список IP-адресов

В расширенных настройках укажите IP-адреса, с которых приложению разрешено принимать запросы. Даже если ключ утечёт - с неразрешённого адреса он не сработает.

⚠️ Полный API-ключ показывается один раз при создании. Закрыли окно, не сохранив - восстановить невозможно. Храните ключи в переменных окружения (env), никогда не в коде или переписке.

Что делать, если ключ скомпрометирован

Действуйте без промедления - после отзыва ключ перестаёт работать мгновенно.

Чек-лист при инциденте:

Перейдите в раздел API-ключи в боковом меню Вайбкод
Нажмите Три точки (...) рядом с нужным ключом → Удалить (если ключ скомпрометирован, деактивации недостаточно - удаляйте)
Если к ключу привязаны активные серверы - сначала отвяжите их, затем удалите ключ
Откройте вкладку Журнал на сервере и проверьте активность за последние часы
Если в журнале есть подозрительные обращения - поставьте приложение на паузу целиком
Создайте новый ключ и обновите его во всех приложениях, где использовался старый
При серьёзных подозрениях - обратитесь в поддержку Битрикс24 для оценки ущерба

Деактивация vs удаление: деактивация обратима (ключ можно восстановить через Активировать) и подходит для плановых пауз. Удаление - необратимо и применяется при компрометации.

Политика доступа: как выстроить систему на уровне команды

Разовые настройки не дают долгосрочной защиты. Устойчивая система строится на правилах, а не на индивидуальных решениях.

Рекомендуемая политика:

По умолчанию - только чтение. Администратор задаёт политику в /keys: все новые ключи создаются с режимом read-only. Полный доступ выдаётся точечно, по заявке.
Один агент - один ключ. Не давайте несколько приложений работать под одним ключом. Это упрощает отзыв и аудит.
Плановый перевыпуск. Раз в 90-180 дней меняйте ключи даже без инцидентов - по аналогии с ротацией паролей.
2FA обязательна. Включите двухфакторную аутентификацию для всех пользователей портала - она распространяется и на Вайбкоде автоматически.
Журнал обращений - под контроль. Периодически просматривайте журнал активности ключей на предмет аномальных пиков или обращений в нерабочее время.
Увольнение сотрудника = немедленный отзыв. Администратор Битрикс24 закрывает учётную запись - доступ к Вайбкоду закрывается автоматически. Но отдельные ключи, выданные сотруднику, нужно отозвать явно.

Если вы только выстраиваете архитектуру доступов в Битрикс24, полезно параллельно изучить тему миграции прав доступа - там схожие принципы изоляции.

Для более глубокого понимания того, как ИИ-инструменты встраиваются в портал, читайте про ИИ-помощников в Битрикс24 и ИИ-агентов Hermes и Коворк/Код.

Бэкапы, права доступа и ключи: обновления безопасности (июль 2026)

💾 Автобэкапы для всех. После инцидента 29 июня (сбой при очистке неактивных серверов, затронул <0,1%, компенсация 5000 вайбов за сервер) Вайбкод включил полные автобэкапы серверов - диск целиком (код + данные + файлы) по расписанию. Это дополнительный слой защиты к депонированию исходников и read-only ключам.
🔑 Права доступа уточнены: crm (CRM + расшифровки звонков), note (База знаний 2.0), vibe:ai (эмбеддинги и AI Router). Давайте ключу только необходимые права.
⚙️ Сервисный ключ агента ограничен операциями exec/upload/logs/deploy - им нельзя вызвать /v1/me (ошибка AGENT_MAINTENANCE_KEY_OUT_OF_SCOPE). Это намеренное сужение прав.
🛡️ Белые/чёрные списки доступа. В настройках Вайбкода можно явно указать, кто имеет доступ к платформе (whitelist/blacklist).

Нужна помощь по вайбкод-приложению? АС Проект - платиновый партнёр Битрикс24: собираем приложения на Вайбкоде, проверяем чужие перед боевым запуском и берём на сопровождение. Состав работ и цены - на странице приложения на вайбкодинге.

Что изменилось к концу августа 2026

Ключ подписки в сторонних клиентах. Модели платформы стали доступны из внешних агентных клиентов (OpenCode, Crush, Cline, Aider) по ключу подписки Коворк/Кода. Ключ по умолчанию несёт все права портала, лишнее снимается кнопкой «Снять все».
Команда и передача приложений. У сервера появилась команда разработки с ролями «Разработчик» и «Администратор»: каждый работает своим ключом, а выкладка отклоняется, если в хранилище есть более свежая версия исходников. Приложение можно передать другому сотруднику одной транзакцией вместе с ключами, сервером, встройками и исходниками.
BitrixGPT 5.6 Agent 1M. Контекст вырос до 1 млн токенов (порядка тысячи страниц за один запрос), новые агенты создаются на этой модели по умолчанию, а долгие ответы почти исчезли.

Данные на 29 августа 2026 - платформа Вайбкод в активной бете, цифры (квоты, цены, версии) меняются. Сверяйтесь с документацией Вайбкода.