Настройка Apple Push Notification service
Для отправки push-уведомлений на устройства iOS необходимо настроить подключение к службе Apple Push Notification service (APNs).
Apple поддерживает два способа аутентификации при взаимодействии с APNs: с помощью сертификата и с помощью ключа аутентификации.
Получение сертификата APNs в формате p12
Для получения Production-сертификата APNs в формате .p12 необходим компьютер Apple и учетная запись Apple Developer с доступом к сертификатам и профилям.
Шаг 1. Создайте CSR-файл
- Откройте приложение Связка ключей.
- В меню выберите Связка ключей → Ассистент сертификации» → Запросить сертификат у бюро сертификации.
- В открывшемся окне укажите адрес электронной почты.
- Выберите Запрос: Сохранен на диске.
- Нажмите Продолжить и сохраните CSR-файл на компьютере.
Шаг 2. Выпустите Production-сертификат
-
Авторизуйтесь в Apple Developer и откройте Certificates, Identifiers & Profiles.
Apple Developer -
В левом меню выберите Identifiers.
-
Найдите нужное приложение и откройте его.
подсказкаЕсли приложение еще не зарегистрировано, создайте новый App ID.
-
При создании App ID включите capability Push Notifications.
-
Откройте приложение в разделе Identifiers.
-
В списке Capabilities найдите Push Notifications и убедитесь, что capability включена.
-
Нажмите Configure.
-
В разделе Production SSL Certificate нажмите Create Certificate.
warningСоздавайте именно production-сертификат. Платформа edna работает с production-окружением Apple, поэтому development-сертификат не подходит.
-
Выберите платформу iOS.
-
В разделе Upload a Certificate Signing Request нажмите Choose file.
-
Выберите созданный ранее CSR-файл и нажмите Continue.
-
Нажмите Download, чтобы загрузить сертификат на компьютер.
к сведениюСрок действия сертификата ограничен и составляет чуть больше года. До окончания срока действия текущего сертификата необходимо выпустить новый сертификат и загрузить его в edna.
Шаг 3. Экспортируйте сертификат в формате p12
- Найдите загруженный сертификат и дважды нажмите на него, чтобы открыть его в приложении Связка ключей.
- Перейдите в категорию Сертификаты или Мои сертификаты.
- Нажмите на сертификат правой кнопкой мыши и выберите Экспортировать.
- Укажите имя файла.
- Выберите формат
.p12и нажмите Сохранить.
Если сертификат выбран в категории Все объекты, экспорт в формате .p12 может быть недоступен.
Шаг 4. Задайте пароль сертификата
-
При экспорте сертификата задайте пароль для защиты контейнера
.p12.warningПароль обязателен: он потребуется при настройк е приложения в edna. Контейнер без пароля не принимается. Используйте в пароле только печатные ASCII-символы.
-
При появлении запроса введите пароль Связки ключей для подтверждения экспорта сертификата и нажмите Разрешить.
В результате будут подготовлены:
- сертификат APNs в формате
.p12; - пароль от контейнера
.p12.
Передайте файл сертификата и пароль специалистам edna или загрузите сертификат самостоятельно в консоли Управление Push.
Получение ключа APNs в формате p8
Для получения ключа APNs необходима учетная запись Apple Developer с разрешением на доступ к сертификатам и профилям. Ключ формируется для всех приложений команды разработки и может использоваться для отправки push-уведомлений.
-
Авторизуйтесь в учетной записи Apple Developer и перейдите в раздел Certificates, Identifiers & Profiles.
Apple Developer -
Определите Team ID. Он отображается в правом верхнем углу страницы под именем учетной записи.
-
В боковом меню перейдите в раздел Keys и нажмите для создания нового ключа.
-
Введите название ключа, выберите тип Apple Push Notification service (APNs) и нажмите Continue.
-
Проверьте параметры ключа и нажмите Register, чтобы подтвердить его создание.
-
Скачайте сформированный файл ключа в формате
.p8.warningФайл
.p8можно скачать с сервера Apple только один раз. Сохраните его в безопасном месте после скачивания. -
Передайте специалистам edna:
- файл ключа
.p8; - Key ID;
- Team ID.
- файл ключа