OAuth 2.0: как устроено
OAuth 2.0 нужен, если ваше приложение подключают разные компании Дескуса: коннектор, конструктор сайтов, CRM в каталоге. Клиент не копирует ключ, а нажимает «Разрешить» — приложение получает токен на его компанию.
Ключ или OAuth
Ключ API | OAuth 2.0 | |
|---|---|---|
Для кого | Своя система компании | Приложение для многих компаний |
Как подключить | Скопировать ключ из настроек | Нажать «Разрешить» в вашем приложении |
Срок | Без срока или 1–3650 дней | Токен — час, обновление — 90 дней |
Отключить | Отозвать ключ | Отключить приложение в настройках |
Как проходит подключение
Вы один раз регистрируете приложение и получаете
client_idиclient_secret.Клиент нажимает в вашем приложении «Подключить Дескус» — вы отправляете его на
https://app.deskus.ru/oauth/authorize.Он входит в свой кабинет, видит, что просит приложение, и нажимает «Разрешить» (согласие и код).
Дескус возвращает его на ваш адрес с одноразовым кодом.
Ваш сервер меняет код на токены —
POST /api/oauth/token(токены).Запросы к API идут с токеном доступа
dsk_a_…в заголовкеAuthorization: Bearer.Через час токен истекает — получите новый по
refresh_token.
Полезно знать
Схема — authorization code (RFC 6749) с PKCE (RFC 7636), метод только
S256.Разрешить доступ может только администратор компании: приложение получает данные всей компании.
Токен работает от имени того, кто нажал «Разрешить», — как ключ (от чьего имени).
Пока Дескус не проверил приложение, его подключает только ваша компания — проверка Дескусом.
Подключённые приложения компания видит в «Настройки → Компания → API и приложения → Приложения» и может отключить любое.