Apple Push Notification Service

Для отправки Mobile Push на устройства iOS необходимо предварительно настроить Apple Push Notification Service.

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

Все действия выполняются на macOS-устройстве. Для настройки необходим аккаунт Apple Developer.

APNs поддерживает два типа аутентификации: авторизационный ключ (рекомендуется) и сертификат.

Опция 1: авторизационный ключ

Шаг 1. Создание Auth Key

Зайдите на сайт Apple Developer в раздел Account. Перейдите в Certificates, Identifiers & Profiles — Keys и создайте новый Key.

Выберите Apple Push Notification service.

Настройте конфигурацию APNs. Нажмите Configure и выберите Environment в зависимости от окружения.

Зарегистрируйте ключ, нажав Register.

Apple Developer предоставляет возможность однократно сохранить созданный ключ. Обязательно сохраните его в надёжном месте — после загрузки получить его повторно невозможно.

Шаг 2. Настройка в платформе Altcraft

В платформе Altcraft откройте настройки ресурса. Добавьте канал Push и активируйте переключатель Apple Push Notification service.

Активируйте переключатель Использовать APNs токен и укажите:

apns-topic — Bundle ID приложения
kid — ID ключа (хранится в разделе Certificates, Identifiers & Profiles — Keys)
iss — Team ID с сайта Apple Developer
Ключ подписи — содержимое загруженного p8-файла (откройте в текстовом редакторе и скопируйте)

Сохраните ресурс кнопками в правом верхнем углу экрана.

Опция 2: сертификат

Шаг 1. Создание сертификата

Откройте приложение Связка ключей на macOS. Перейдите в Связка ключей — Ассистент сертификации — Запросить сертификат у бюро сертификации.

Заполните необходимые данные и обязательно выберите опцию Сохранить на диске.

Сохранённый файл в формате .certSigningRequest понадобится на следующем этапе.

Зайдите на сайт Apple Developer в раздел Account. Перейдите в Certificates, Identifiers & Profiles — Certificates и создайте новый сертификат.

В Services укажите Apple Push Notification service SSL (Sandbox) или (Sandbox and Production) в зависимости от окружения. Выберите ваше приложение из списка.

Загрузите созданный Certificate Signing Request (файл .certSigningRequest).

Скачайте созданный сертификат. Откройте его в приложении Связка ключей, дважды нажмите на сертификат и задайте уровень доверия Всегда доверять.

Кликните правой кнопкой мыши по сертификату и выберите Экспортировать, чтобы сохранить его в формате .p12. При необходимости установите пароль.

Шаг 2. Создание pem-файлов

Перейдите в папку с экспортированным сертификатом через терминал.

Создайте pem-ключ:

openssl pkcs12 -legacy -in filename.p12 -out filename.key.pem -nocerts -nodes

Создайте pem-сертификат:

openssl pkcs12 -legacy -in filename.p12 -out filename.crt.pem -clcerts -nokeys

Откройте оба файла в текстовом редакторе — их содержимое нужно вставить в поля платформы:

Шаг 3. Настройка в платформе Altcraft

Активируйте переключатель Использовать APNs сертификат и укажите:

Сертификат — содержимое pem-сертификата
Приватный ключ — содержимое pem-ключа

Сохраните ресурс кнопками в правом верхнем углу экрана.

Опция 1: авторизационный ключ​

Шаг 1. Создание Auth Key​

Шаг 2. Настройка в платформе Altcraft​

Опция 2: сертификат​

Шаг 1. Создание сертификата​

Шаг 2. Создание pem-файлов​

Шаг 3. Настройка в платформе Altcraft​

Что дальше​