mSDK v2
Описание
Altcraft mSDK v2.0 — это обновлённый мобильный SDK, который обеспечивает надёжную работу с push-уведомлениями и взаимодействие с платформой Altcraft. Он разработан для Android и iOS, поддерживает Firebase, Huawei, RuStore и APNS, а также предоставляет расширенные возможности по управлению подписками, обработке событий и работе с несколькими пользователями на одном устройстве.
SDK может использовать JWT-токены или rToken, что позволяет гибко настраивать уровень безопасности и типы матчинга данных профилей. Автоматическая обработка уведомлений и событий доставки обеспечивает стабильность и высокую точность передачи данных, а встроенный WorkManager гарантирует доставку событий даже в случае сетевых сбоев.
Altcraft mSDK v2 доступен на GitHub для iOS и Android.
Возможности
- Управление подпиской на push-уведомления: добавление, приостановка, отписка.
- Автоматический показ уведомлений с содержимым, настраиваемым в платформе, с возможностью кастомизации отображения.
- Автоматическое обновление push-токена при его изменении.
- Автоматическая передача событий доставки и открытия уведомлений.
- Поддержка анонимных и зарегистрированных пользователей, а также нескольких пользователей на одном устройстве (при использовании JWT).
- Автоматический повтор запросов через WorkManager для максимальной доставки событий.
- Поддержка push-провайдеров: Firebase, Huawei, RuStore (Android), APNS (iOS).
- Использование JWT-токенов для обеспечения безопасности и неограниченных вариантов матчинга профилей.
- Возможность работы через rToken с ограниченным доступом по идентификатору push-подписки.
- Поддержка переопределения формата push-уведомлений и доступа ко всем data-полям сообщений.
Варианты авторизации
JWT-токен
Данный тип авторизации использует JWT-токен, который приложение передаёт в SDK. Токен добавляется в заголовок каждого запроса.
JWT (JSON Web Token) — это строка в формате JSON, содержащая claims (набор данных), подписанных для проверки подлинности и целостности.
Токен формируется и подписывается ключом шифрования на стороне серверной части клиента (ключи шифрования не хранятся в приложении). По запросу SDK, приложение обязано передать полученный с сервера JWT-токен.
Преимущества:
- Повышенная безопасность API-запросов.
- Возможность поиска профилей по любым идентификаторам (email, телефон, custom ID).
- Поддержка нескольких пользователей на одном устройстве.
- Восстановление доступа к профилю после переустановки приложения.
- Идентификация конкретного профиля на разных устройствах.
rToken
Альтернативный способ авторизации — использование ролевого токена (rToken), переданного в параметры конфигурации SDK. При этом методе авторизации запросы содержат заголовок с ролевым токеном.
Особенности:
- Поиск профилей возможен только по push-токену устройства (например, FCM).
- Если push-токен изменился и не был передан на сервер (например, после удаления и переустановки приложения), связь с профилем будет потеряна / создастся новый профиль.
Ограничения:
- Потеря связи с профилем при изменении push-токена, которое не было зафиксировано на сервере Altcraft.
- Отсутствие возможности использовать приложение для разных профилей на одном устройстве.
- Невозможность регистрации одного пользователя на другом устройстве.