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

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

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

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

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

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

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

Тип клиента выбирается при создании и позже не меняется — разбор с примерами в разделе [Типы клиента](/docs/partner-connect#типы-клиента).

`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, попадает в ту же область [хранилища](/docs/storage), что и личные ключи подключившего пользователя в этом аккаунте Битрикс24. С этим правом приложение видело бы все файлы, загруженные его личными ключами. `vibe:artifacts` закрыт по той же причине: опубликованный артефакт попадает в ту же общую область. Запрос с этими правами при саморегистрации отклоняется кодом `SCOPE_NOT_ALLOWED`, а в режиме `PERSONAL` их не выдаёт и платформенный администратор. Приложению в режиме `COMPANY` платформенный администратор может выдать `vibe:storage` — см. [Подключение Компании](/docs/partner-connect/company); `vibe:artifacts` не выдаётся приложению Connect ни в одном режиме.

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

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

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

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

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

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

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

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

- [Типы клиента](/docs/partner-connect#типы-клиента)
- [Начать авторизацию пользователя](/docs/partner-connect/authorize)
- [Подключение AI из приложения внутри Битрикс24](/docs/partner-connect/ai-in-app)
- [Partner Connect](/docs/partner-connect)
