Инструкция: настройка APNs Key для iOS пушей через Firebase

0. Что нужно заранее

Перед началом есть два варианта:

Вариант А — делает клиент
Передать клиенту эту инструкцию и попросить прислать:

• .p8 файл APNs Key

• Key ID

• Team ID

Вариант Б — делает PM/команда Rightech
Запросить у клиента доступ в Apple Developer Account с правами на управление:

• Certificates, Identifiers & Profiles

• Keys

• Identifiers / App ID

Также нужен доступ в Firebase проект клиента/проекта.

1. Создание APNs Key в Apple Developer

Перейти в: https://developer.apple.com/account

Apple Developer → Account → Certificates, Identifiers & Profiles → Keys

Нажать:

+ / Create a key

Заполнить:

• Key Name: например PushKeyZiptron

• Включить галочку:

  • Apple Push Notifications service (APNs)

Нажать Edit.

2. Настройка APNs Key

В окне Configure Key выбрать:

• Environment: Sandbox & Production

• Key Restriction: Team Scoped (All Topics)

Нажать Save.

Важно: после сохранения эти параметры нельзя изменить. Если ошиблись — нужно создавать новый ключ.

3. Регистрация и скачивание ключа

После настройки нажать:

Continue → Register

На финальном экране нажать:

Download

Скачается файл вида:

AuthKey_XXXXXXXX.p8

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

4. Зафиксировать данные ключа

Сохранить в проектной документации:

Project: <название проекта>
iOS Bundle ID: <bundle id приложения>
APNs Key Name: <название ключа>
Key ID: <значение из Apple Developer>
Team ID: <значение из Apple Developer>
.p8 file: <где хранится файл>

Key ID отображается на экране созданного ключа.

Team ID находится в:

Apple Developer → Account → Membership details → Team ID

5. Загрузка ключа в Firebase

Перейти в:

Firebase Console → Project Settings → Cloud Messaging

В блоке:

Apple app configuration → APNs Authentication Key

Для iOS-приложения выбрать нужное приложение, например:

Ziptron — io.rent.ziptron

Нажать Upload.

Загрузить:

• .p8 файл

• Key ID

• Team ID

Если Firebase предлагает отдельные строки:

• development APNs auth key

• production APNs auth key

можно загрузить один и тот же .p8 ключ в обе строки, если в Apple он создан как Sandbox & Production.

6. Проверить Bundle ID

Обязательно сверить, что Bundle ID совпадает в трёх местах:

Apple Developer App ID
Firebase iOS app
iOS-приложение / Xcode

Пример:

io.rent.ziptron

Если Bundle ID не совпадает — пуши работать не будут.

7. Проверить capability в Apple Developer

В Apple Developer открыть:

Certificates, Identifiers & Profiles → Identifiers → App ID приложения

Проверить, что включено:

Push Notifications