> ## Documentation Index
> Fetch the complete documentation index at: https://docs.arzguard.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Авторизация партнёрского бота

> Bearer-токены, список разрешённых IP, согласованные серверы, scopes и проверка прав модератора.

## Получить доступ

Для оформления доступа обратитесь к руководителю проекта или разработки. Укажите название и назначение бота, платформы, серверы, нужные операции и при необходимости исходящие IP-адреса. После согласования владелец получает токен в CRM. Значение токена показывается один раз.

Храните токен в защищённой конфигурации серверной интеграции. Передавайте его по HTTPS.

```http theme={null}
Authorization: Bearer <PARTNER_TOKEN>
```

Тестовые и рабочие токены выдаются отдельно. Если для бота настроен список IP, отправляйте запросы с разрешённого IPv4, IPv6 или адреса из согласованного CIDR.

## Как проверяется доступ

| Проверка | Что определяет |
| - | - |
| Токен | Активную интеграцию и окружение |
| Согласованные серверы | В каких серверных контекстах может работать бот |
| Scopes и trust factor | Какие действия доступны и какие применяются лимиты |
| Модератор | Разрешено ли этому человеку действие над конкретной целью по правилам CRM |

Актуальные значения `approved_scopes`, `effective_scopes` и `limits` возвращает [GET /me](https://docs.arzguard.com/cerberus-crm/api/get-me.md). Изменение уровня доверия само по себе не выдаёт новые согласованные scopes. Для расширения списка серверов, операций или IP оформите изменение доступа.

## Передать инициатора

Методы, работающие от имени сотрудника, принимают идентификатор его привязанного аккаунта.

```json theme={null}
{
  "moderator": {
    "provider": "discord",
    "platform_user_id": "123456789012345678"
  }
}
```

Поддерживаются `discord` и `telegram`. Передавайте внешний ID строкой. Получайте его из подтверждённого контекста события вашей платформы. Для кадровых изображений эти данные передаются через `X-Moderator-Provider` и `X-Moderator-ID`.

При ротации сохраните новый токен и переключите бота в течение переходного периода. Для ответа `401` проверьте окружение, статус токена и исходящий IP.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.