Права на создание ключей и приложений

Права на создание ключей, приложений и вебхуков задаются в двух местах — в кабинете Вайбкод и в Битрикс24. Страница объясняет, где какая настройка и как по тексту отказа понять, какую из них менять.

Две группы настроек

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

Как понять, кто отказал

Отказ Вайбкод называет администратора портала и не упоминает Битрикс24. Например, при создании ключа приходит текст «У вас нет прав на создание API-ключей. Обратитесь к администратору портала.» Коды — KEY_CREATION_RESTRICTED для ключа и APP_CREATION_RESTRICTED для приложения, оба со статусом 403.

Отказ Битрикс24 прямо называет право на вебхуки или на установку приложений. Например: «Администратор портала Битрикс24 не выдал вам право создавать входящие вебхуки. Попросите его открыть «Настройки» → «Безопасность» и либо добавить вас в поле «Кому разрешить создавать входящие вебхуки» в блоке «Интеграции Битрикс24», либо включить переключатель «Источник прав — Вайбкод-сервер» в блоке «Вайбкод-коннектор» — тогда права берутся из кабинета Вайбкод.» Коды — CONNECTOR_KEY_ISSUE_FORBIDDEN, CONNECTOR_APP_INSTALL_FORBIDDEN и B24_ACCESS_DENIED, все со статусом 403.

Если отказ пришёл от Вайбкод — коды KEY_CREATION_RESTRICTED и APP_CREATION_RESTRICTED — и вы не администратор, отправьте заявку на доступ из кабинета. Администратор одобрит или отклонит её. Заявка доступна, когда для настройки выбран режим со списком.

Полный список кодов — Ошибки.

Настройки в кабинете Вайбкод

Раздел доступен администратору Битрикс24.

1. Откройте кабинет Вайбкод под учётной записью администратора Битрикс24.
2. Перейдите в раздел «Настройки».
3. Найдите нужную настройку: право создавать ключи находится в карточке «Ключи», остальные — в карточке «Правила создания».
4. Выберите режим. В режиме со списком добавьте сотрудников, которым доступ открыт.
5. Нажмите «Сохранить» в той же карточке.

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

В режиме со списком сотрудник, которого в списке нет, может отправить заявку на доступ. Администратор одобряет или отклоняет её.

В карточке «Ключи» задаётся режим доступа для новых ключей — только чтение или чтение и запись. Он сохраняется сразу при переключении, отдельной кнопки не требует, и на уже выпущенные ключи не влияет.

Настройки в Битрикс24

Раздел доступен сотрудникам с правами администратора Битрикс24.

1. В Битрикс24 откройте левое меню, нажмите «Настройки» и выберите «Настройки Битрикс24».
2. В списке разделов слева выберите «Безопасность».
3. Разверните блок «Интеграции Битрикс24».
4. В нужном поле нажмите «+ Добавить» и выберите сотрудников.

Переключатель «Источник прав — Вайбкод-сервер»

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

1. Откройте «Настройки» → «Безопасность» в Битрикс24.
2. Разверните блок «Вайбкод-коннектор».
3. Установите переключатель «Источник прав — Вайбкод-сервер» в нужное положение.

Важно: переключатель снимает проверку на стороне Битрикс24, а права кабинета Вайбкод действуют при любом его положении. Если создание закрыто в кабинете Вайбкод, включение переключателя не откроет доступ — отказ приходит раньше, чем платформа обращается к Битрикс24.

Ключ создан, но вызовы не проходят

Права закрывают не только создание ключа. Два случая, когда ключ выпущен и виден в списке, а вызовы отклоняются.

Вызовы к Битрикс24 отвечают `401 TOKEN_MISSING`

Вебхук для ключа не выписан. Причина приходит в поле details.reason:

{
  "success": false,
  "error": {
    "code": "TOKEN_MISSING",
    "message": "This key has no Bitrix24 webhook: the portal refused to create one for its owner. ...",
    "details": {
      "reason": "WEBHOOK_MINT_REFUSED_BY_PORTAL"
    }
  }
}

Значение WEBHOOK_MINT_REFUSED_BY_PORTAL означает, что Битрикс24 отказал владельцу ключа в праве создавать входящие вебхуки. Администратор открывает это право, после чего платформа выпускает вебхук в течение 15 минут. Переподключать ключ и выпускать новый не нужно: новый получит тот же отказ.

Остальные значения details.reason и порядок действий по каждому — в разделе TOKEN_MISSING.

Изменяющие вызовы отвечают `403 WRITE_BLOCKED_READONLY_KEY`

Ключ выпущен в режиме только чтения. Режим задаётся в кабинете Вайбкод на момент выпуска, в карточке «Ключи», и на уже выпущенные ключи не переносится. Такой ключ выполняет чтения и отклоняет изменяющие вызовы. Администратор может открыть запись отдельному ключу в его карточке.

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

• Ключи и авторизация
• Авторизация, ключи и права
• Создать приложение
• Быстрый старт