Для AI-агентов: markdown этой страницы — /docs-content/partner-connect/registration.md индекс документации — /llms.txt

Регистрация приложения и права

Как зарегистрировать приложение Connect в кабинете Вайбкод, какие платформенные права оно может получить и что снимает отметку «проверено».

Регистрация в кабинете

Клиент регистрируется самостоятельно в кабинете Вайбкод — раздел Connect-приложения, боковое меню, группа «Доступ». Войдите под учётной записью Вайбкод и нажмите «Зарегистрировать приложение» — client_id выдаётся сразу, без заявки и предварительной проверки.

В форме заполняются:

  • Название и краткое описание приложения.
  • Идентификатор — строчные латинские буквы, цифры и дефис.
  • Один или несколько redirect_uri — адреса https:// либо локальные 127.0.0.1, localhost и [::1] по http или https.
  • Запрашиваемые права доступа.

Набор прав не может быть пустым: регистрация без единого права возвращает EMPTY_SCOPES. Приложение без прав не может запросить у пользователя ничего.

Тип клиента выбирается при создании и позже не меняется — разбор с примерами в разделе Типы клиента.

client_secret показывается один раз при создании. Прочитать его повторно нельзя, только перевыпустить действием «Обновить секрет».

В ⋮-меню карточки приложения есть два помощника: «Собрать ссылку» — конструктор ссылки авторизации (выбор redirect_uri и прав, готовый URL и curl для обмена кода, для клиента без секрета — одноразовая пара строк PKCE), и «Как увидит клиент» — предпросмотр страницы согласия ровно в том виде, в каком её увидит пользователь, включая отметку о проверке.

Число активных клиентов на одного пользователя ограничено. При достижении предела регистрация возвращает CLIENT_LIMIT_REACHED, текущее значение приходит в поле limit. Деактивация клиента освобождает место.

Новое приложение получает статус «непроверенное» — пользователь видит эту отметку на странице согласия. Повысить статус может платформенный администратор, запрос отправляется действием «Запросить верификацию» в карточке приложения. Заявку принимают, когда у приложения:

  • адрес сайта на https.
  • у конфиденциального клиента — хотя бы один публичный redirect_uri, не на localhost.
  • хотя бы одно действующее подключение пользователя.
  • описание не короче 20 символов.

Если условие не выполнено, заявка отклоняется кодом VERIFICATION_REQUIREMENTS_NOT_MET, а недостающие пункты приходят в поле missingRequirements. Заявку могут отклонить с причиной — она приходит владельцу приложения, и после правок заявку подают заново.

Управление приложениями портала

Администратор выбранного портала видит приложения всех сотрудников в профиле на вкладке «Все приложения портала»: подключения, запросы к AI и долю лимита. В разделе «AI-модели» доступна разбивка «По приложениям».

«Разрешить ИИ» одобряет ожидающий запрос или выдаёт разрешение без запроса. Само разрешение не создаёт ключ: сотрудник повторяет подключение. «Запретить ИИ» закрывает вызовы моделей, сохраняя остальные права ключа. «Отключить для всех» отзывает все ключи приложения на этом портале и производные токены. Расход за текущий период остаётся в статистике.

Управление доступно, когда на платформе включено разрешение AI администратором портала. Ключи других порталов не затрагиваются.

Платформенные права

Права Вайбкод открывают разделы самой платформы, а не данные Битрикс24. Для приложения Connect они делятся на три группы.

vibe:ai приложение запрашивает само. Отметьте его в правах при регистрации — там же, где права Битрикс24, — и дальше оно идёт обычным путём: передаётся в параметре scope у /v1/connect/authorize, показывается пользователю на странице согласия строкой «AI-модели» и приходит на выданный ключ. Заявки и проверки для этого не нужно. Расход покрывает месячный AI-лимит аккаунта, к которому подключается приложение.

Автоматически право не добавляется: приложение, которое его не отметило, работает без доступа к AI-роутеру, а уже выданные ключи набор прав не меняют. Чтобы открыть AI существующему подключению, отметьте право в карточке приложения и проведите пользователя через согласие заново — он получит новый ключ.

vibe:search (веб-поиск /v1/search), vibe:infra, vibe:feedback, vibe:onec и vibe:connectors выдаёт платформенный администратор. При саморегистрации запрос с ними отклоняется кодом SCOPE_NOT_ALLOWED. Порядок — три шага, и первые два делает владелец приложения:

  1. Отправьте заявку действием «Запросить верификацию» в карточке приложения.
  2. Напишите в ленте «Обсуждение с платформой» той же карточки, какое право нужно и для какого сценария. Отдельного поля «запрашиваю право» в заявке нет, поэтому без сообщения проверяющий видит только заявку на значок.
  3. Администратор выдаёт право проверенному приложению. Верификация сама по себе прав не открывает — это два разных решения, и первое является условием второго.

После выдачи право ведёт себя как vibe:ai: передаётся в scope, показывается на странице согласия, приходит на ключ.

vibe:storage и vibe:artifacts приложению Connect не выдаются. Ключ, выданный через Connect, попадает в ту же область хранилища, что и личные ключи подключившего пользователя в этом аккаунте Битрикс24. С этим правом приложение видело бы все файлы, загруженные его личными ключами. vibe:artifacts закрыт по той же причине: опубликованный артефакт попадает в ту же общую область. Запрос с этими правами при саморегистрации отклоняется кодом SCOPE_NOT_ALLOWED, а в режиме PERSONAL их не выдаёт и платформенный администратор. Приложению в режиме COMPANY платформенный администратор может выдать vibe:storage — см. Подключение Компании; vibe:artifacts не выдаётся приложению Connect ни в одном режиме.

Что снимает отметку «проверено»

Отметка держится на том, каким приложение прошло проверку, поэтому правка пяти полей возвращает статус «непроверенное»:

  • название,
  • описание,
  • логотип,
  • адреса возврата redirect_uri,
  • набор запрашиваемых прав.

Адрес сайта на отметку не влияет. Повторное сохранение того же описания отметку не снимает. Отсутствие описания и пустая строка равнозначны.

Кабинет предупреждает до сохранения: форма показывает подтверждение с перечнем полей, из-за которых отметка будет снята. Без подтверждения правка не сохраняется, ответ — VERIFICATION_RESET_NOT_CONFIRMED с тем же перечнем в теле.

Заполнение пустого набора прав отметку не снимает, если администратор приложению права не выдавал или выбранные права укладываются в выданный им набор.

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

Смотрите также