Подключение аккаунтов

Содержимое этой страницы разошлось по разделам, где его ищут:

ВопросГде ответ
Как подключить кабинет, какие бывают потоки авторизации, где хранятся секретыКоннекторы → Подключение аккаунта
Как выдать агенту коннекторы и кабинетыАгенты → Выдача коннекторов и кабинетов
Как вызвать кабинет по ключу, адресовать один из нескольких и что делать, если его нетВызов по ключу

Частые вопросы

Какие потоки авторизации используют коннекторы?

Каждый сервис объявляет один из четырёх потоков авторизации: credentials (ключ API, токен или пароль в форме), popup_oauth (OAuth во всплывающем окне), device_code (подтверждение на сайте провайдера коротким кодом) и mcp_oauth, который есть только у MCP-сервера, добавленного пользователем. Транспорт, прикрепляющий секрет к каждому запросу, это отдельная ось, которой занимается сам коннектор.

Как хранятся учётные данные?

Подключённые учётные данные шифруются при хранении, и при вызове коннектора платформа сама подставляет секрет адресуемого аккаунта в запрос. Подробно, в том числе о песочнице, описано в разделе «Коннекторы».

Может ли один сервис держать несколько аккаунтов?

Да. Один сервис может держать несколько подключённых аккаунтов: несколько кабинетов Ozon, два продавца WB. Каждый из них адресуется суффиксом к сервису: ozon:2 или ozon:Top Zip.

Как агент получает доступ к коннектору и его учётным данным?

В два слоя, оба задаются на карточке интеграций агента в приложении. Список коннекторов решает, какие у агента инструменты; переключатель у каждого аккаунта решает, какими подключёнными аккаунтами он может пользоваться. Агент дотягивается до аккаунтов того, для кого работает, кроме отключённых. Подключения владельца агента до коллег не доходят: коллега запускает общего агента на своих подключениях, в пределах принятых им коннекторов.

Была ли страница полезна?