Как зарегистрировать плеер

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

Связанные страницы: Протокол устройства v1 о вызовах плеера и Передача показов о том, что он сообщает после регистрации.

Прежде чем начать

• Экран «Плееры» и токен доступны администратору организации оператора.
• Конструкция уже должна быть зарегистрирована и действовать. Если конструкций нет, консоль предложит сначала добавить конструкцию.
• Плеер должен быть в сети и достигать адреса устройств https://devices.tanba-ooh.kz.

Выпустите токен

1. Откройте «Плееры» и нажмите «Токен регистрации».
2. Выберите конструкцию, к которой относится плеер. В списке только действующие конструкции.
3. Нажмите «Выпустить». Токен показывается один раз, в поле только для чтения, и начинается с tdt_. Скопируйте его сразу.

Токен действует 24 часа и срабатывает один раз. Он привязан к выбранной конструкции, поэтому плеер появится под ней. Если токен потерян, просрочен или уже использован, запрос плеера отклоняется с кодом invalid_token: выпустите новый. Платформа ограничивает число запросов регистрации с одного адреса.

Что делает плеер

Плеер создает собственный ключ (ECDSA P-256), отправляет запрос сертификата вместе с токеном в POST /d/v1/enroll и получает сертификат устройства на один год и цепочку до центра сертификации устройств. Токен это единственные учетные данные этого вызова; каждый следующий вызов предъявляет сертификат. Плеер также сообщает модель, версию прошивки, серийный номер и версию спецификации соответствия, которую заявляет. Как ввести токен в плеер, описывает изготовитель программного обеспечения плеера.

Проверьте, что плеер зарегистрирован

В таблице «Плееры» у каждого плеера видны конструкция, модель, прошивка, состояние, режим и последний сигнал.

Новый плеер показывает «Не выходил на связь» до первого heartbeat, затем «На связи». В колонке «Режим» то, что сообщает сам плеер: «Штатный», «Режим соответствия» (плеер потерял связь с платформой дольше лимита своего класса) или «Отключен» (его отключила подписанная команда).

Плеер с пометкой «Только подпись» подтверждает себя подписью зарегистрированного ключа вместо клиентского сертификата, на уровне приложения. Пометка стоит рядом с моделью.

Отзовите плеер

Чтобы вывести плеер из работы или если его ключ мог быть раскрыт, нажмите «Отозвать» в его строке, укажите причину до 500 символов и подтвердите. Плеер теряет доступ к каналу управления. Действие необратимо. Отозванный плеер показывает «Отозван», других действий для него нет.

Если плеер не появился