# Параметры конфигурации iOS

В этом разделе приведены пошаговые инструкции по настройке вашего iOS-приложения для включения служб обмена сообщениями с помощью Pushwoosh. Выберите конфигурацию на основе сертификатов или токенов в зависимости от требований вашего проекта.

<Aside type="tip">
Независимо от выбранного метода, храните ваши сертификаты и ключи в безопасности. Несанкционированный доступ может привести к неправомерному использованию ваших возможностей push-уведомлений.
</Aside>
## Конфигурация iOS на основе сертификатов
Узнайте, как настроить Pushwoosh для iOS с использованием аутентификации на основе сертификатов для APNs (служба push-уведомлений Apple).

<LinkCard title="Узнать больше" href="/developer/first-steps/connect-messaging-services/ios-configuration/ios-platform-configuration/" />

## Конфигурация iOS на основе токенов
Настройте Pushwoosh с аутентификацией на основе токенов для APNs, которая является более безопасной и эффективной альтернативой сертификатам.

<LinkCard title="Узнать больше" href="/developer/first-steps/connect-messaging-services/ios-configuration/ios-token-based-configuration/" />  

## Конфигурация VoIP-сертификата для iOS
Разрешите Pushwoosh доставлять VoIP push-уведомления в ваше iOS-приложение, чтобы вы могли отправлять оповещения о входящих вызовах и другие VoIP-события на устройства пользователей.

<LinkCard title="Узнать больше" href="/developer/first-steps/connect-messaging-services/ios-configuration/ios-voip-certificate-configuration/" />

## Конфигурация пропуска Apple Wallet для iOS
Загрузите свой сертификат для подписи Pass Type ID, чтобы Pushwoosh мог подписывать и обновлять пропуска Apple Wallet (`.pkpass`) для вашего приложения.

<LinkCard title="Узнать больше" href="/developer/first-steps/connect-messaging-services/ios-configuration/ios-wallet-pass-configuration/" />

## Выбор между сертификатами .p12 и ключами .p8 для push-уведомлений iOS

При настройке push-уведомлений iOS в Pushwoosh необходимо пройти аутентификацию в службе push-уведомлений Apple (APNs). Существует два поддерживаемых метода:

1. **Сертификат `.p12`**: традиционный подход на основе сертификатов.
2. **Ключ `.p8`**: современный метод на основе токенов, рекомендованный Apple.

Это руководство поможет вам определить, какой метод лучше всего подходит для вашего случая.
<Aside type="caution" title="Важно">
[Live Activities](/ru/developer/pushwoosh-sdk/ios-sdk/ios-live-activities/) в Pushwoosh требуют [конфигурации на основе токенов](/ru/developer/first-steps/connect-messaging-services/ios-configuration/ios-token-based-configuration/). Если вы собираетесь использовать Live Activities, убедитесь, что ваша конфигурация iOS использует этот метод, так как конфигурация на основе сертификатов не поддерживается.
</Aside> 


## Обзор вариантов

| Характеристика               | Сертификат `.p12`                                         | Ключ аутентификации `.p8`                                        |
|----------------------|------------------------------------------------------------|------------------------------------------------------------------|
| **Как это работает**     | Использует криптографический сертификат для установления доверия.       | Использует постоянный токен, подписанный приватным ключом.                |
| **Файл**             | Файл `.p12`, содержащий сертификат и приватный ключ.    | Файл `.p8`, содержащий приватный ключ.                            |
| **Срок действия**       | Истекает (обычно ежегодно); требует продления.          | Не истекает автоматически.                                           |
| **Настройка**            | Сложнее в создании и управлении.                       | Обычно проще в настройке.                                    |
| **Использование**            | Один сертификат на один Bundle ID для каждой среды.        | Один ключ поддерживает несколько приложений и обе среды.           |
| **Рекомендация**   | Устаревший метод. Используйте только для существующих настроек.               | Рекомендовано Apple и Pushwoosh.                        |


## Плюсы и минусы каждого метода

### Сертификат `.p12`: традиционный подход

**Плюсы:**
- Широко поддерживается.
- Позволяет использовать отдельные сертификаты для разработки и продакшена.

**Минусы:**
- Срок действия сертификатов истекает, и они требуют продления. Несвоевременное продление может нарушить доставку push-уведомлений.
- Сложнее в управлении.


### Ключ `.p8`: современный, рекомендуемый подход

**Плюсы:**
- Не требует продления, что снижает затраты на обслуживание.
- Проще в создании и интеграции.
- Один ключ работает для нескольких проектов.
- Рекомендовано Apple и Pushwoosh.

**Минусы:**
- В случае компрометации все связанные приложения окажутся под угрозой. Надежно защищайте свой ключ `.p8`.


## Какой метод выбрать?

<Aside type="caution" title="Важное замечание по безопасности">
Независимо от выбранного метода, всегда защищайте свои сертификаты и ключи. Несанкционированный доступ может скомпрометировать вашу инфраструктуру push-уведомлений.
</Aside>

Мы рекомендуем использовать **метод с ключом `.p8`** для всех новых проектов. Он проще, более масштабируем и соответствует лучшим практикам Apple.

Используйте сертификаты `.p12` только в следующих случаях:

- У вас есть существующая инфраструктура, зависящая от сертификатов `.p12`.
- Вам требуется строгое разделение сред, которого невозможно достичь с помощью ключа `.p8`.


## Руководства по конфигурации

<CardGrid>
  <LinkCard title="Конфигурация на основе сертификатов" href="ios-platform-configuration" />
  <LinkCard title="Конфигурация на основе токенов" href="ios-token-based-configuration" />
  <LinkCard title="Конфигурация VoIP-сертификата для iOS" href="ios-voip-certificate-configuration" />
  <LinkCard title="Конфигурация пропуска Apple Wallet для iOS" href="ios-wallet-pass-configuration" />
</CardGrid>