Обзор интеграции SaaS

Используйте Connector for SaaS, когда каждому пользователю продукта нужно авторизовать собственный аккаунт Gmail, Slack, Notion или другого провайдера. Ваш продукт управляет пользовательским интерфейсом и сопоставлением пользователей; OOMOL Connector хранит подключённый аккаунт и выполняет actions по запросу вашего backend.

Этот путь использует project API key вида oo_proj_…. Ключ представляет один проект Connector и хранится на вашем backend.

Модель ресурсов

Ресурс	Назначение
Project	Изолирует конфигурации провайдеров, ключи, подключённые аккаунты, журналы и использование
Provider config	Определяет способ авторизации одного провайдера внутри проекта
External user ID	Связывает подключённые аккаунты с пользователем вашего продукта
Connected account ID или alias	Выбирает аккаунт для выполнения action
Project API key	Аутентифицирует запросы вашего backend

Процесс интеграции

Создайте project и provider config в OOMOL Console.
Создайте project API key и сохраните его в менеджере секретов backend.
Попросите backend создать authorization link для внешнего пользователя.
Проведите пользователя через процесс авторизации провайдера.
Сохраните полученный connected account ID или alias рядом с пользователем продукта.
Выполняйте actions из backend для этого пользователя и аккаунта.

Ответственность

Ваш продукт аутентифицирует пользователей, определяет доступных для подключения провайдеров, хранит сопоставление пользователей и аккаунтов и контролирует actions, запрашиваемые backend. Не размещайте project API key в браузерах и мобильных клиентах.

Для этого пути интеграции OOMOL Console предоставляет конфигурацию проекта, записи подключённых аккаунтов, журналы выполнения и сведения об использовании.

Начните разработку

Используйте руководство Connector for SaaS для настройки Console и REST flow. Если backend написан на TypeScript, используйте Подключение аккаунтов конечных пользователей с ProjectConnector.