Подключение аккаунтов
Содержимое этой страницы разошлось по разделам, где его ищут:
| Вопрос | Где ответ |
|---|---|
| Как подключить кабинет, какие бывают потоки авторизации, где хранятся секреты | Коннекторы → Подключение аккаунта |
| Как выдать агенту коннекторы и кабинеты | Агенты → Выдача коннекторов и кабинетов |
| Как вызвать кабинет по ключу, адресовать один из нескольких и что делать, если его нет | Вызов по ключу |
Частые вопросы
Какие потоки авторизации используют коннекторы?
Каждый сервис объявляет один из четырёх потоков авторизации: credentials (ключ API, токен или пароль в форме), popup_oauth (OAuth во всплывающем окне), device_code (подтверждение на сайте провайдера коротким кодом) и mcp_oauth, который есть только у MCP-сервера, добавленного пользователем. Транспорт, прикрепляющий секрет к каждому запросу, это отдельная ось, которой занимается сам коннектор.
Как хранятся учётные данные?
Подключённые учётные данные шифруются при хранении, и при вызове коннектора платформа сама подставляет секрет адресуемого аккаунта в запрос. Подробно, в том числе о песочнице, описано в разделе «Коннекторы».
Может ли один сервис держать несколько аккаунтов?
Да. Один сервис может держать несколько подключённых аккаунтов: несколько кабинетов Ozon, два продавца WB. Каждый из них адресуется суффиксом к сервису: ozon:2 или ozon:Top Zip.
Как агент получает доступ к коннектору и его учётным данным?
В два слоя, оба задаются на карточке интеграций агента в приложении. Список коннекторов решает, какие у агента инструменты; переключатель у каждого аккаунта решает, какими подключёнными аккаунтами он может пользоваться. Агент дотягивается до аккаунтов того, для кого работает, кроме отключённых. Подключения владельца агента до коллег не доходят: коллега запускает общего агента на своих подключениях, в пределах принятых им коннекторов.