Apple Push Notification Service

Когда использовать

Apple Push Notification service (APNs) — провайдер для отправки push-уведомлений на устройства iOS. Используйте APNs, если:

• вы настраиваете push для iOS-приложения
• вам нужна прямая интеграция с Apple без промежуточных сервисов

предупреждение

Для настройки APNs необходим аккаунт Apple Developer и устройство на macOS.

Что нужно до настройки

1. Аккаунт Apple Developer. Перейдите на https://developer.apple.com/account/resources/authkeys/list

2. Устройство на macOS для работы с сертификатами

3. Bundle ID приложения

Настройка в Apple Developer

Регистрация идентификатора

1. В Apple Developer перейдите в раздел Certificates, Identifiers & Profiles — Identifiers.

2. Создайте новый идентификатор: App IDs — App.

3. Укажите Bundle ID приложения и выберите Push Notifications.

Создание сертификата

1. В разделе Certificates создайте новый сертификат.

2. Выберите тип Apple Push Notification service SSL (Sandbox & Production).

3. Найдите приложение в выпадающем списке AppID и загрузите созданный сертификат.

Экспорт сертификата

1. Дважды нажмите на скачанный сертификат для установки в Keychain.

2. Откройте Keychain Access, найдите сертификат и экспортируйте в формате .p12.

Аутентификация

APNs поддерживает два типа аутентификации:

Аутентификация с токеном (рекомендуется)

1. В Apple Developer перейдите в Keys и создайте новый ключ.

2. Укажите тип APNs и сохраните Key ID.

3. Скачайте ключ (скачивается один раз).

4. На платформе Altcraft активируйте Использовать APNs токен и заполните:

• apns-topic — Bundle ID приложения
• kid — Key ID ключа
• iss — Team ID из аккаунта разработчика
• Ключ подписи — содержимое файла ключа

Аутентификация с сертификатом

1. Создайте pem-ключ: openssl pkcs12 -in filename.p12 -out filename.key.pem -nocerts -nodes

2. Создайте pem-сертификат: openssl pkcs12 -in filename.p12 -out filename.crt.pem -clcerts -nokeys

3. На платформе активируйте Использовать APNs сертификат и заполните:

• Сертификат — значение pem-сертификата
• Приватный ключ — значение pem-ключа

Настройка в Altcraft

1. Создайте ресурс для push-канала.

2. Выберите платформу iOS и включите переключатель Apple Push Notification service.

3. Заполните поля в соответствии с выбранным типом аутентификации.

Что дальше

• Интеграция приложения с Altcraft
• Структура push-сообщений APNs