Статусы подключений

Каждое подключение к источнику данных в LightLead имеет статус, отражающий его работоспособность и состояние авторизации.

Все статусы

Статус	Отображение	Описание
Connected	Подключено	Подключение активно и работает
Reauthorization required	Требуется повторная авторизация	Токен истёк и не может быть обновлён автоматически
Missing permissions	Недостаточно прав	У авторизованного пользователя нет нужных разрешений
Expired	Истекло	Срок действия токена истёк, автоматическое обновление невозможно
Disconnected	Отключено	Подключение отключено пользователем или системой
In use	Используется	Подключение активно используется в запущенном отчёте

Детальное описание

Connected

Нормальное рабочее состояние. Токен доступа действителен, права достаточны, API источника отвечает.

• Данные синхронизируются по расписанию
• Ручной запуск отчётов доступен
• В интерфейсе: зелёный индикатор «Подключено»

Как достигается:

• Успешная OAuth-авторизация
• Автоматическое обновление токена через refresh token

Reauthorization required

Токен доступа истёк, и refresh token тоже недействителен. Автоматическое обновление невозможно.

Причины:

• Пользователь отозвал доступ на стороне источника
• Срок действия refresh token истёк
• Изменился пароль аккаунта в источнике
• Провайдер отозвал токен по соображениям безопасности

Решение:

• Нажать «Переподключить» и заново пройти OAuth
• В интерфейсе: жёлтый индикатор «Требуется авторизация»

Missing permissions

Токен действителен, но у авторизованного пользователя недостаточно прав для доступа к данным.

Причины:

• Пользователя понизили в правах в рекламном кабинете
• Изменились политики доступа в источнике
• Аккаунт заблокирован или приостановлен

Решение:

• Проверить права пользователя в источнике
• Авторизоваться под учётной записью с правами администратора
• В интерфейсе: оранжевый индикатор «Недостаточно прав»

Expired

Срок действия токена истёк. Отличается от Reauthorization required тем, что refresh token тоже просрочен.

Решение:

• Полная переавторизация через OAuth
• В интерфейсе: красный индикатор «Истекло»

Disconnected

Подключение отключено — либо пользователем вручную, либо системой.

Причины:

• Пользователь нажал «Отключить»
• Администратор рабочей области отключил подключение
• Автоматическое отключение при длительном Expired (более 30 дней)

Решение:

• Нажать «Подключить» для повторной авторизации
• В интерфейсе: серый индикатор «Отключено»

In use

Подключение активно используется — по нему прямо сейчас выполняется отчёт.

• Отключение невозможно до завершения отчёта
• Переавторизация во время выполнения может привести к ошибке отчёта
• В интерфейсе: синий индикатор «Используется»

Переходы статусов

Connected ──токен истёк──→ Reauthorization required
Connected ──права отозваны──→ Missing permissions
Reauthorization required ──переподключение──→ Connected
Reauthorization required ──30 дней без действия──→ Disconnected
Missing permissions ──права восстановлены──→ Connected
Missing permissions ──отключение──→ Disconnected
Connected ──ручное отключение──→ Disconnected
Disconnected ──подключение──→ Connected (через OAuth)
Connected ──истечение refresh_token──→ Expired
Expired ──переавторизация──→ Connected

Влияние на отчёты

При запуске отчёта проверяются статусы всех входящих в него подключений:

• Все Connected → отчёт выполняется нормально
• Есть Reauthorization required или Expired → пропуск проблемных источников, статус partial
• Есть Missing permissions → пропуск, статус partial
• Все проблемные → статус failed

Связанные страницы

• Статусы отчётов
• Коды ошибок
• Интеграции