Оффлайн
- Регистрация
- 1 Мар 2015
- Сообщения
- 1,481
- Баллы
- 155
Долгое время искал в интернете нормальное решение для массовой рассылки Push сообщений на Android и iOS, но ничего подходящего и нормально работающего не попадалось.
В Delphi долгое время приходилось использовать компоненты Kinvey (или Pasre). При этом возникали новые проблемы зависимости от платформы, ключей и пр. С любым серьёзным изменением приходилось изменять, как сам проект, так и настройки проекта. В некоторых случаях сторонние компоненты отказывались работать на той или иной платформе по не понятной причине. А так же, огромным минусом Kinvey, было то, что при получении Push сообщения на iOS не воспроизводилось звуковое уведомление. В конце концов, зависимость от третьей стороны всегда является определённым минусом любого проекта.
И вот после очередных поисков я объединил все имеющиеся знания и сделал серверную часть для регистрации устройств и рассылки Push сообщений.
Принцип работы скрипта достаточно прост. В нём имеются функции для регистрации (удаления) токенов устройств, ну и собственно сами функции рассылки. Большая часть мануалов? которые мне удалось найти были написаны либо неправильно, либо попросту были неполными.
Введение
Немного теории. Для отправки Push сообщений используются сервисы у Apple и у Google. Наш скрипт может выступать в качестве самостоятельного сервера рассылки Push через сервера Apple и Google, а так же принимать токены устройств регистрируемых в базе данных.
Apple, iOS и ApnsPHP
Начнём с более сложной части.
Я не стану изобретать велосипед и воспользуюсь уже имеющимися в сети, бесплатными, библиотеками написанными на PHP. Набор библиотек ApnsPHP представляет собой набор классов для работы с Push сообщениями APNS. Скачать их с примерами можно на GitHub по .
Но одних библиотек нам мало. Самое сложное, это генерация и конвертирование сертификатов для работы с Push на iOS. Я опишу полный алгоритм экспорта и конвертации сертификатов, а затем их дальнейшее применение в скриптах.
Генерация сертификата для отправки Push сообщений
Будем предполагать, что вы уже создали и настроили сертификаты в личном кабинете разработчика и загрузили их в «Связку ключей» на ваш Mac.
Открываем
Экспортируем сертификаты
Далее, нам необходимо открыть скачанные сертификаты на Mac'е, т. е. импортировать их в «Связку ключей». Для этого просто делаем двойной клик на каждом сертификате.
Открываем корневой сертификат.
Экспортируем сертификат.
На данный момент, мы получили 3 основных файла для работы с сервисом APNS:
Для конвертации я воспользовался бесплатным набором утилит .
После установки пакета, для простоты выполнения команд я использовал TotalCommander.
openssl pkcs12 -in server_certificates_bundle_prod.p12 -out server_certificates_bundle_prod.pem -nodes -clcerts
На запрос ввода пароля, просто нажимаем Enter.
.fotorama1457319815101 .fotorama__nav--thumbs .fotorama__nav__frame{ padding:2px; height:64px} .fotorama1457319815101 .fotorama__thumb-border{ height:60px; border-width:2px; margin-top:2px}
Подготавливаем сертификаты и программу.
Готовые сертификаты.
Сертификаты.
И так, теперь у нас есть набор необходимых сертификатов для работы с Push сообщениями на iOS.
Google и GCM
Для работы с Google и GCM мы будем использовать библиотеку . Скачанный архив библиотек и пример работы из коробки у меня по какой-то причине отказался работать, поэтому пришлось немного модифицировать код.
Для работы с GCM нам потребуется API ключ проекта. Выполняем следующие действия:
Теперь у нас имеются все необходимые данные для организации PHP сервера рассылки Push сообщений.
База данных
Для рассылки Push сообщений на устройства пользователей используются токены устройств, которые выдаётся серверами Google и Apple, т. е. для получения Push сообщения, токен устройства должен быть зарегистрирован в системе. Наш сервер так же отправки Push сообщений будет использовать токены устройств. Для хранения токено устройств, ID устройств и платформы я использовал базу данных.
Текст скрипта для создания базы данных выглядит так.
Для добавления устройств в базу данных используется отдельная функция скрипта сервера, но об этом чуть позже.
Сервер
Переходим к самому серверу и его настройке. Все файлы я выложу отдельным архивом.
Суть скрипта состоит в следующем: подключаем библиотеки для работы с Push, настраиваем сертификаты и API ключ и с помощью имеющихся функций выполняем необходимые действия, будь то рассылка сообщений, регистрация устройств и пр.
В состав сервера входит файл конфигурации. Приведу отдельно его текст.
Думаю, что раздел конфигурации базы данных не требует объяснения, тут надо указать настройки для доступа к базе данных, в которой хранится таблица «Devices».
Параметры:
$config['apn']['send'] = true;
$config['gcm']['send'] = true;
Отвечают за включение или отключение рассылки Push сообщений, если значение false, то рассылка на указанную платформу не производится.
Дальше идут настройки API ключа и указание каталогов сертификатов, что в общем-то тоже я думаю понятно всем.
Отдельно рассмотрим ключ:
$config['apn']['production'] = false;
Данный ключ переключает режим работы сервера. Development или Production режимы рассылки.
Как можно заметить, все сертификаты необходимо положить в каталог «Certificates» рядом со скрипом.
Если при генерации сертификатов Apn использовался пароль, то в настройках, необходимо указать пароль:
$config['apn']['sertPass'] = 'пароль сертификата';
Работа со скриптом
После заполнения файла конфигурации скрипт готов к работе, осталось зарегистрировать устройства.
Скрипт сервера push.php принимает 2 значения параметра action:
Примеры запросов:
Регистрация устройства iOS
Регистрация устройства Android
Отправка Push сообщений
день, мой господин!
Первые два запроса регистрируют устройства в базе данных и в момент рассылки скрипты выбирает токены устройств по полю platform и производит отправку Push сообщений.
Второй запрос производит рассылку Push сообщения все зарегистрированным устройствам.
В общем-то, всё достаточно просто, каждый желающий может в дальнейшем модифицировать скрипт по своему желанию, вводя защиту от несанкционированного доступа и пр. Прошу меня не пинать, за полное отсутствие защиты в скрипте, скрипт призван показать логику и рабочий пример работы с Push сообщениями. Плюс данного скрипта состоят в том, что данные мы можем отправлять с любой платформы, будь то веб форма, Windiws приложения или мобильные приложения.
Delphi
Настало время рассмотреть небольшой код написанный для Delphi, который позволяет регистрировать токены устройств на нашем сервере. Каждое мобильное устройство после запуска приложения получает свой DeviceID и токен, после чего отправляет полученные данные на наш сервер.
В разделе public нашего юнита добавляем следующие строки:
public
{ Public declarations }
APushService : TPushService;
AServiceConnection : TPushServiceConnection;
А в раздел type добавляем описание 2-х функций:
procedure OnReceiveNotificationEvent(Sender: TObject; const ANotification : TPushServiceNotification);
procedure OnServiceConnectionChange(Sender: TObject; AChange : TPushService.TChanges);
В момент отображения формы добавляем код получения DID и токена. Будьте внимательны, значение PROJECTNUM необходимо заменить на свой номер проекта из личного кабинета Google разработчика.
Так же, надо добавить функцию, которая срабатывает при изменении состояния получения DID и токена.
Для вывода Push сообщения добавляем функцию
В результате мы получаем почти готовую программу. Кто был более внимательным, заметил, что в коде есть несколько функций, не объявленных ранее, таких как ShowNotification или RegisterDevice. Для удобства, я вынес их в отдельный файл global.pas. Достаточно добавить данный файл в проект, чтобы не копипастить функции. В данном файле вам потребуется заменить константу DOMAIN для указания пути к файлу скрипта на сервере, и если вы положили скрипт не в корне сервера, а в случайный каталог, то потребуется внести дополнительные изменения для указания точной адресации.
Так же имеется функция SendPush, которая позволяет отправлять Push сообщения прямо с устройства.
Все функции в файле global.pas имеют подробное описание и думаю их использование не вызовет никаких вопросов.
Таким образом мы получаем устройства, которые регистрируются в системе, отправляя свои DID и токены скрипту, а скрипт записывает их в базу данных для дальнейшего использования при отправке Push сообщений. Если в базе имеются токены устройств, на которых программа не установлен (удалена), то такие токены будут удалены из базы данных после попытки отправки Push сообщений.
Используемые файлы.
Заключение
В данной статье я попытался максимально подробно изложить принципы и алгоритмы работы с Push сообщениями с использованием дополнительных библиотек GCMMessage и ApnsPHP в php скрипте и взаимодействие с программным обеспечением (в моём случае Windows приложения и мобильные платформы).
Данная статья не претендует на оригинальность и истину последней инстанции. Имеются открытые места в безопасности, такие, как сертификаты без паролей, открытый доступ к функциям скрипта без идентификации пользователей и пр.
Если у кого-нибудь будет желание доработать данный скрипт в плане безопасности или внести поправки я буду только рад. Ваши изменения и замечания вы можете писать в комментариях к статье.
В Delphi долгое время приходилось использовать компоненты Kinvey (или Pasre). При этом возникали новые проблемы зависимости от платформы, ключей и пр. С любым серьёзным изменением приходилось изменять, как сам проект, так и настройки проекта. В некоторых случаях сторонние компоненты отказывались работать на той или иной платформе по не понятной причине. А так же, огромным минусом Kinvey, было то, что при получении Push сообщения на iOS не воспроизводилось звуковое уведомление. В конце концов, зависимость от третьей стороны всегда является определённым минусом любого проекта.
И вот после очередных поисков я объединил все имеющиеся знания и сделал серверную часть для регистрации устройств и рассылки Push сообщений.
Принцип работы скрипта достаточно прост. В нём имеются функции для регистрации (удаления) токенов устройств, ну и собственно сами функции рассылки. Большая часть мануалов? которые мне удалось найти были написаны либо неправильно, либо попросту были неполными.
Введение
Немного теории. Для отправки Push сообщений используются сервисы у Apple и у Google. Наш скрипт может выступать в качестве самостоятельного сервера рассылки Push через сервера Apple и Google, а так же принимать токены устройств регистрируемых в базе данных.
Apple, iOS и ApnsPHP
Начнём с более сложной части.
Я не стану изобретать велосипед и воспользуюсь уже имеющимися в сети, бесплатными, библиотеками написанными на PHP. Набор библиотек ApnsPHP представляет собой набор классов для работы с Push сообщениями APNS. Скачать их с примерами можно на GitHub по .
Но одних библиотек нам мало. Самое сложное, это генерация и конвертирование сертификатов для работы с Push на iOS. Я опишу полный алгоритм экспорта и конвертации сертификатов, а затем их дальнейшее применение в скриптах.
Генерация сертификата для отправки Push сообщений
Будем предполагать, что вы уже создали и настроили сертификаты в личном кабинете разработчика и загрузили их в «Связку ключей» на ваш Mac.
- Запускаем утилиту «Связка ключей» и в левой части выбираем раздел «Мои сертификаты».
- Раскрываем сертификат интересующего нас проекта. БУДЬТЕ ВНИМАТЕЛЬНЫ! Есть две версии сертификатов, Developer (используется при отладке и разработке) и Production (используется для рабочей версии). Выбираем сертификат и закрытый ключ данного сертификата.
- Нажимаем правой кнопкой и выбираем пункт «Экспортировать объектов: 2». Сохраняем полученные сертификаты. Я сохранил с именами server_certificates_bundle_sandbox.p12 (для сертификата разработки) и server_certificates_bundle_prod.p12 (для сертификата публикации). Внимание! При экспорте поле пароля оставляем пустым. В дальнейшем вы сможете усложнить систему защиты и выгрузить сертификаты с указанием пароля.
- Переходим на .
- Выбираем «Personal Use and Secure Server Installation» и нажимаем кнопку «Download Certificates».
- Нажимаем на «Root Certificates».
- Нас интересуют два сертификата «entrust_ssl_ca.cer» и «entrust_2048_ca.cer». Скачиваем их. Вообще, в изначальном описании написано, что сертификат «entrust_ssl_ca.cer» используется в Prodution режиме, а «entrust_2048_ca.cer» в режиме Development. Но есть пометка, что после 22 декабря 2010 в качестве Production сертификата так же можно использовать «entrust_2048_ca.cer». Т. е. данный сертификат можно использовать в обоих режимах работы, меняя лишь сертификаты пользователя.
Открываем
Экспортируем сертификаты
Далее, нам необходимо открыть скачанные сертификаты на Mac'е, т. е. импортировать их в «Связку ключей». Для этого просто делаем двойной клик на каждом сертификате.
- Открываем в левой части «Связки ключей» раздел «Вход» («Сертификаты»).
- Находим наш сертификат и экспортируем его «entrust_root_certification_authority_2048.pem».
Открываем корневой сертификат.
Экспортируем сертификат.
На данный момент, мы получили 3 основных файла для работы с сервисом APNS:
- «entrust_root_certification_authority_2048.pem» — корневой сертификат.
- «server_certificates_bundle_sandbox.p12» — сертификат пользователя для режима Development.
- «server_certificates_bundle_prod.p12» — сертификат пользователя для режима Production.
Для конвертации я воспользовался бесплатным набором утилит .
После установки пакета, для простоты выполнения команд я использовал TotalCommander.
- Открываем в левой части каталог установленного OpenSSL и переносим туда наши сертификаты.
- В нижней части TotalCommander в командной строке выполняем следующие команды:
openssl pkcs12 -in server_certificates_bundle_prod.p12 -out server_certificates_bundle_prod.pem -nodes -clcerts
На запрос ввода пароля, просто нажимаем Enter.
.fotorama1457319815101 .fotorama__nav--thumbs .fotorama__nav__frame{ padding:2px; height:64px} .fotorama1457319815101 .fotorama__thumb-border{ height:60px; border-width:2px; margin-top:2px}
Подготавливаем сертификаты и программу.
Готовые сертификаты.
Сертификаты.
И так, теперь у нас есть набор необходимых сертификатов для работы с Push сообщениями на iOS.
Google и GCM
Для работы с Google и GCM мы будем использовать библиотеку . Скачанный архив библиотек и пример работы из коробки у меня по какой-то причине отказался работать, поэтому пришлось немного модифицировать код.
Для работы с GCM нам потребуется API ключ проекта. Выполняем следующие действия:
- Открываем .
- Выбираем интересующий нас проект.
- Открываем раздел «APIs & auth» — «Credentials» и копируем ключ Server Key.
- Если вы ещё не создавали ключи, то вам потребуется включить API «Google Cloud Messaging for Android».
Теперь у нас имеются все необходимые данные для организации PHP сервера рассылки Push сообщений.
База данных
Для рассылки Push сообщений на устройства пользователей используются токены устройств, которые выдаётся серверами Google и Apple, т. е. для получения Push сообщения, токен устройства должен быть зарегистрирован в системе. Наш сервер так же отправки Push сообщений будет использовать токены устройств. Для хранения токено устройств, ID устройств и платформы я использовал базу данных.
Текст скрипта для создания базы данных выглядит так.
Код:
CREATE TABLE devices (
id int(10) UNSIGNED NOT NULL AUTO_INCREMENT COMMENT 'Уникальный идентификатор записи в таблице',
deviceID varchar(255) NOT NULL COMMENT 'Идентификатор устройства',
deviceToken varchar(255) NOT NULL COMMENT 'Токен устройства',
devicePlatform varchar(255) NOT NULL COMMENT 'Платформа устройства',
PRIMARY KEY (id),
UNIQUE INDEX deviceID (deviceID)
)
ENGINE = MYISAM
AUTO_INCREMENT = 20
AVG_ROW_LENGTH = 166
CHARACTER SET utf8
COLLATE utf8_general_ci
COMMENT = 'Зарегистрированные устройства для рассылки PUSH сообщений';Для добавления устройств в базу данных используется отдельная функция скрипта сервера, но об этом чуть позже.
Сервер
Переходим к самому серверу и его настройке. Все файлы я выложу отдельным архивом.
Суть скрипта состоит в следующем: подключаем библиотеки для работы с Push, настраиваем сертификаты и API ключ и с помощью имеющихся функций выполняем необходимые действия, будь то рассылка сообщений, регистрация устройств и пр.
В состав сервера входит файл конфигурации. Приведу отдельно его текст.
Код:
<?php
# Переменные для работы с базой данных
$config['db']['host'] = "localhost";
$config['db']['name'] = "Имя БД";
$config['db']['user'] = "Пользователь БД";
$config['db']['pass'] = "Пароль БД";
# Управление рассылкой. True - рассылка производится, false - рассылка отключена.
$config['apn']['send'] = true;
$config['gcm']['send'] = true;
# Ключи для доступа к сервисам
# Ключ для доступа Google Server API
$config['gcm']['apikey'] = "ВАШ API КЛЮЧ";
# Путь к сертификатам APN для подключения к серверу рассылки
$config['apn']['sert'] = 'Certificates/server_certificates_bundle_sandbox.pem';
$config['apn']['sert_prod'] = 'Certificates/server_certificates_bundle_prod.pem';
$config['apn']['RootCertificat'] = 'Certificates/entrust_root_certification_authority_2048.pem';
$config['apn']['production'] = false;
?>Параметры:
$config['apn']['send'] = true;
$config['gcm']['send'] = true;
Отвечают за включение или отключение рассылки Push сообщений, если значение false, то рассылка на указанную платформу не производится.
Дальше идут настройки API ключа и указание каталогов сертификатов, что в общем-то тоже я думаю понятно всем.
Код:
# Ключи для доступа к сервисам
# Ключ для доступа Google Server API
$config['gcm']['apikey'] = "ВАШ API КЛЮЧ";
# Путь к сертификатам APN для подключения к серверу рассылки
$config['apn']['sert'] = 'Certificates/server_certificates_bundle_sandbox.pem';
$config['apn']['sert_prod'] = 'Certificates/server_certificates_bundle_prod.pem';
$config['apn']['RootCertificat'] = 'Certificates/entrust_root_certification_authority_2048.pem';$config['apn']['production'] = false;
Данный ключ переключает режим работы сервера. Development или Production режимы рассылки.
Как можно заметить, все сертификаты необходимо положить в каталог «Certificates» рядом со скрипом.
Если при генерации сертификатов Apn использовался пароль, то в настройках, необходимо указать пароль:
$config['apn']['sertPass'] = 'пароль сертификата';
Работа со скриптом
После заполнения файла конфигурации скрипт готов к работе, осталось зарегистрировать устройства.
Скрипт сервера push.php принимает 2 значения параметра action:
- register-device
- send-push
- did — Идентификатор устройства (не используется, но на всякий случай).
- token — токен устройства, используется для рассылки Push сообщений.
- platform — платформа устройства, используется функциями рассылки. Может принимать 2 значения: ios или andoid.
Примеры запросов:
Регистрация устройства iOS
Регистрация устройства Android
Отправка Push сообщений
день, мой господин!
Первые два запроса регистрируют устройства в базе данных и в момент рассылки скрипты выбирает токены устройств по полю platform и производит отправку Push сообщений.
Второй запрос производит рассылку Push сообщения все зарегистрированным устройствам.
В общем-то, всё достаточно просто, каждый желающий может в дальнейшем модифицировать скрипт по своему желанию, вводя защиту от несанкционированного доступа и пр. Прошу меня не пинать, за полное отсутствие защиты в скрипте, скрипт призван показать логику и рабочий пример работы с Push сообщениями. Плюс данного скрипта состоят в том, что данные мы можем отправлять с любой платформы, будь то веб форма, Windiws приложения или мобильные приложения.
Delphi
Настало время рассмотреть небольшой код написанный для Delphi, который позволяет регистрировать токены устройств на нашем сервере. Каждое мобильное устройство после запуска приложения получает свой DeviceID и токен, после чего отправляет полученные данные на наш сервер.
В разделе public нашего юнита добавляем следующие строки:
public
{ Public declarations }
APushService : TPushService;
AServiceConnection : TPushServiceConnection;
А в раздел type добавляем описание 2-х функций:
procedure OnReceiveNotificationEvent(Sender: TObject; const ANotification : TPushServiceNotification);
procedure OnServiceConnectionChange(Sender: TObject; AChange : TPushService.TChanges);
В момент отображения формы добавляем код получения DID и токена. Будьте внимательны, значение PROJECTNUM необходимо заменить на свой номер проекта из личного кабинета Google разработчика.
Код:
/// На данном этапе происходит регистрация устройства для получения Push.
procedure TMainForm.FormShow(Sender: TObject);
var
ADeviceID, ADeviceToken : string;
begin
// Получение и отправка токена устройства
{$ifdef ANDROID}
// Для Android
APushService := TPushServiceManager.Instance.GetServiceByName(TPushService.TServiceNames.GCM);
APushService.AppProps[ TPushService.TAppPropNames.GCMAppID ] := 'PROJECTNUM';
{$else}
// Для iOS
APushService := TPushServiceManager.Instance.GetServiceByName(TPushService.TServiceNames.APS);
{$endif}
// Создаём подключение к серверу
AServiceConnection := TPushServiceConnection.Create( APushService );
// Активируем подключение
AServiceConnection.Active := True;
// Подключаем делегаты
AServiceConnection.OnChange := OnServiceConnectionChange;
AServiceConnection.OnReceiveNotification := OnReceiveNotificationEvent;
ADeviceID := APushService.DeviceIDValue[ TPushService.TDeviceIDNames.DeviceID ];
ADeviceToken := APushService.DeviceTokenValue[ TPushService.TDeviceTokenNames.DeviceToken ];
if (ADeviceID <> '') AND (ADeviceToken <> '') then
begin
// Регистрируем устройство на сервере для отправки push сообщений
RegisterDevice(ADeviceID, ADeviceToken);
end;
end;
Код:
/// Устройства не всегда успевают получить токен,
/// поэтому при изменении состояния опять проверяем токен
procedure TMainForm.OnServiceConnectionChange(Sender: TObject;
AChange : TPushService.TChanges);
var
ADeviceID, ADeviceToken : string;
begin
// При измении состояния компонента
ADeviceID := APushService.DeviceIDValue[ TPushService.TDeviceIDNames.DeviceID ];
ADeviceToken := APushService.DeviceTokenValue[ TPushService.TDeviceTokenNames.DeviceToken ];
if (ADeviceID <> '') AND (ADeviceToken <> '') then
begin
// Регистрируем устройство на сервере для отправки push сообщений
RegisterDevice(ADeviceID, ADeviceToken);
end;
end;
Код:
/// Процедура вывода сообщение при получении Push уведомления от сервера
procedure TMainForm.OnReceiveNotificationEvent(Sender: TObject;
const ANotification : TPushServiceNotification);
var
MessageText : string;
begin
// Получаем текст сообщения в зависимости ль платформы
{$ifdef ANDROID}
MessageText := ANotification.DataObject.GetValue('message').Value;
{$else}
MessageText := ANotification.DataObject.GetValue('alert').Value;
{$endif};
// Выводим сообщение
ShowNotification(MessageText, 0);
end;Так же имеется функция SendPush, которая позволяет отправлять Push сообщения прямо с устройства.
Все функции в файле global.pas имеют подробное описание и думаю их использование не вызовет никаких вопросов.
Таким образом мы получаем устройства, которые регистрируются в системе, отправляя свои DID и токены скрипту, а скрипт записывает их в базу данных для дальнейшего использования при отправке Push сообщений. Если в базе имеются токены устройств, на которых программа не установлен (удалена), то такие токены будут удалены из базы данных после попытки отправки Push сообщений.
Используемые файлы.
Заключение
В данной статье я попытался максимально подробно изложить принципы и алгоритмы работы с Push сообщениями с использованием дополнительных библиотек GCMMessage и ApnsPHP в php скрипте и взаимодействие с программным обеспечением (в моём случае Windows приложения и мобильные платформы).
Данная статья не претендует на оригинальность и истину последней инстанции. Имеются открытые места в безопасности, такие, как сертификаты без паролей, открытый доступ к функциям скрипта без идентификации пользователей и пр.
Если у кого-нибудь будет желание доработать данный скрипт в плане безопасности или внести поправки я буду только рад. Ваши изменения и замечания вы можете писать в комментариях к статье.