Общие принципы работы

Сервис уведомлений предназначен для оперативной доставки информации в виде текстовых Push-уведомлений на мобильные устройства.

Функциональность получения Push-уведомлений доступна в ОС Аврора, начиная с версии 3.2.2.

Если Push-уведомление отправлено, а мобильное устройство в данный момент недоступно, мобильное приложение получит Push-уведомления после подключения к сети, обеспечивающей доступ к Push-серверу.

Для использования Push-уведомлений в своих системах разработчикам необходимо расширить функциональность мобильного приложения и сервера, отправляющего Push-уведомления.

Для работы с Push-уведомлениями устройство должно быть зарегистрировано в Аврора Центр. Для Аврора Центр версии ниже 5.0 и ОС Аврора ниже 5.1:

Протокол общения устройств с сервером Push-уведомлений не подразумевает передачу конфиденциальной информации. Поэтому не рекомендуется передавать с помощью уведомлений конфиденциальную и чувствительную информацию в незащищённых сетях.

Протокол передачи доработан для передачи конфиденциальной информации для связки Аврора Центр, начиная с 5.0, и ОС Аврора, начиная с 5.1.

При разработке приложения функциональность Push-уведомлений можно тестировать двумя способами:

подключившись к тестовому серверу.
при помощи плагина для эмуляции сервера Сервиса уведомлений.

Идентификатор приложения

Для работы с сервисом уведомлений ОС Аврора (как на этапе тестирования, так и при использовании собственного продуктивного сервера) необходимо получить уникальный идентификатор приложения — applicationId.

Этот параметр является обязательным. Без его установки регистрация в push-демоне невозможна, а доставка сообщений не будет осуществляться. Идентификатор гарантирует уникальность продукта в экосистеме Аврора Центр и предотвращает перехват или подмену уведомлений другими приложениями.

Значение applicationId необходимо запросить в технической поддержке предприятия-разработчика по адресу электронной почты dev-support@omp.ru. В обращении следует указать данные о предприятии и сведения о создаваемом приложении. После обработки запроса служба поддержки предоставит уникальное значение, которое затем необходимо интегрировать в код приложения.

Конфигурационный файл сервера уведомлений

Для авторизации прикладного сервера или тестового приложения на сервере push-увеложений ОС Аврора используется специальный конфигурационный файл в формате YAML.

Этот файл играет роль «паспорта» интеграции: в нём хранятся параметры адресации push-сервера (URL-адреса шлюза и авторизации) и криптографические ключи авторизации приложения (сертификаты, идентификатор клиента и приватный ключ). Без этих данных сервер не сможет пройти авторизацию и отправить push-уведомление на мобильные устройства.

В каких случаях нужен этот файл?

При локальном тестировании: для передачи параметров авторизации демонстрационным серверам, таким как утилита PushSender или тестовые скрипты на Python/Java.
В продуктовой среде: для настройки корпоративного сервера приложений, отправляющего реальные уведомления пользователям.

Порядок получения конфигурационного файла

Способ получения файла зависит от рабочей инфраструктуры:

Для тестирования:
1. Необходимо направить официальный запрос в службу технической поддержки разработчиков по адресу dev-support@omp.ru, указав название организации и имя регистрируемого мобильного приложения.
2. В ответном письме служба поддержки вышлет архив с двумя файлами конфигурации: файл настроек приложения (содержит application_id для сборки клиента) и файл конфигурации сервера. Настройки тестового сервера выдаются в единственном экземпляре на организацию.
Для продуктового решения:
1. При самостоятельном развертывании ИТ-администратор регистрирует новое мобильное приложение непосредственно в консоли администрирования платформы управления устройствами «Аврора Центр» компании.
2. После регистрации приложения система автоматически генерирует уникальные идентификаторы и криптографическую пару ключей.
3. Готовый конфигурационный файл экспортируется администратором безопасности напрямую из веб-интерфейса «Аврора Центр» и передается разработчикам для развертывания на прикладном сервере.

Использование конфигурационного файла

На прикладном сервере: Путь к YAML-файлу передается серверному приложению (написанному по примерам на Python или Java) для автоматического считывания параметров, авторизации и последующей отправки push-запросов.
В утилите тестирования PushSender: Импортировать полученный YAML-файл можно через графический интерфейс демонстрационного приложения PushSender на его вспомогательной странице настроек. Чтобы упростить перенос конфигурационных данных можно воспользоваться вспомогательным инструментом PushSenderConfig.

Работа с Push-уведомлениями описана в разделах: