Токены доступа

Токен доступа CMS — это учётные данные, с которыми система управления контентом организации (CMS) спрашивает CityScreen Context, что показывать. Каждый вызов CMS содержит этот токен; дальше на странице он называется просто токен доступа.

Страница адресована сотрудникам с ролями владельца и администратора — только они могут сгенерировать токен заново, — и инженерам, которые подключают CMS.

Один токен на организацию

У организации один токен доступа.

Все экраны организации передают один и тот же токен, и по нему платформа определяет, какая организация обращается.

Токен создаётся вместе с организацией, поэтому он есть с первого дня её существования.

Что он охватывает

Токен аутентифицирует каждый вызов CMS, то есть весь набор вызовов CMS:

  • Стандартный рекламный запрос и следующие за ним отчёты о показах.

  • Путь private deal — см. Private deals.

  • Рекламные запросы тех интеграций CMS, которые используют свой вариант протокола: SpinetiX, Cubic Vision и COT.

Токен идентифицирует организацию целиком и не даёт доступа к клиентскому кабинету.

Источники спроса сообщают итоги показов по идентификатору запроса, который выдала платформа, и токен для этого не нужен.

Как токен передаётся

CMS отправляет токен с каждым запросом.

Вызов с неизвестным токеном или с токеном отключённой организации отклоняется.

Вторая проверка поверх токена

Одной аутентификации недостаточно, чтобы спрашивать про конкретную организацию.

Идентификатор организации в пути запроса должен совпадать с тем, что записан в её собственных настройках синхронизации CMS, — значением, которое оператор вводит при подключении CMS. Токен, который прошёл аутентификацию, но используется с идентификатором другой организации, отклоняется. См. Подключение CMS.

Где найти токен и как сгенерировать его заново

Токен показан в клиентском кабинете в разделе Настройки → Интеграции с агентствами (/settings/agencies) под названием Внешний Token организации, вместе с идентификатором организации и датами создания и последнего изменения токена.

Показанный там идентификатор — это GID организации. В пути запроса должно стоять значение из настроек синхронизации CMS; обычно оно совпадает с GID — см. Синхронизация.

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

Генерация нового токена

  1. Откройте Настройки → Интеграции с агентствами.

  2. Выберите действие, которое генерирует новый токен.

  3. Подтвердите действие паролем своей учётной записи.

Новый токен вступает в силу сразу, переходного периода нет. В момент выдачи нового токена старый перестаёт работать, и каждый экран, который его ещё передаёт, перестаёт получать ответы, пока CMS не обновят.

Согласуйте замену с тем, кто обслуживает CMS, и делайте её вне часов, когда экраны продают эфир.

Генерация нового токена записывается в журнал аудита организации — см. Аудит. Токен показан целиком на странице настроек, поэтому относитесь к ней как к любому другому месту, где видны действующие учётные данные.

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