# Настройка для iOS на основе сертификата

<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> 

Следуйте этому руководству, чтобы настроить платформу iOS вручную.

<Aside type="note">
Убедитесь, что вы создали профиль подготовки (provisioning profile) для вашего приложения, чтобы отправить его в App Store. Подробнее читайте в [документации для разработчиков Apple](https://developer.apple.com/help/account/provisioning-profiles/create-an-app-store-provisioning-profile).
</Aside>

## Создание файла запроса на подпись сертификата

1. Запустите **Связку ключей (Keychain Access)**, перейдите в **Ассистент сертификации (Certificate Assistant)** и нажмите **Запросить сертификат у центра сертификации (Request a Certificate From a Certificate Authority)**:

<img src="/ios-configuration-ios-platform-configuration-1.webp"
     alt="Связка ключей в macOS, показывающая меню Ассистента сертификации для запроса CSR для сертификата APNs"/>

2. Введите необходимую информацию и выберите **Сохранить на диск (Saved to disk)**. Поле CA email следует оставить пустым. Нажмите **Продолжить (Continue)** и **Сохранить (Save)** запрос сертификата с предложенным именем.

<img src="/ios-configuration-ios-platform-configuration-2.webp"
     alt="Создание CSR в Связке ключей"/>

## Создание сертификата APNs на портале разработчиков Apple

1. Войдите на [портал разработчиков Apple](https://developer.apple.com/account/) и откройте **Certificates, Identifiers & Profiles** на вкладке **Account**. Нажмите **Add**:

<img src="/ios-configuration-ios-platform-configuration-3.webp"
     alt="Портал разработчиков Apple — панель Certificates, Identifiers & Profiles с кнопкой Add"/>

2. Выберите нужный тип сертификата и нажмите **Continue** внизу страницы.

<Aside type="note">
Вы можете выбрать тип сертификата **Sandbox & Production**, как показано на скриншоте ниже, а затем выбрать соответствующий **шлюз (Gateway)** при настройке платформы iOS в панели управления Pushwoosh. При необходимости вы также можете создать сертификаты Sandbox и Production отдельно.
</Aside>

<img src="/ios-configuration-ios-platform-configuration-4.webp"
     alt="Выбор типа сертификата APNs SSL (Sandbox & Production) на портале разработчиков Apple"/>

3. На следующей странице выберите **App ID** вашего проекта, затем нажмите **Continue**.

<img src="/ios-configuration-ios-platform-configuration-5.webp"
     alt="Выбор App ID для выпуска сертификата APNs на портале разработчиков Apple"/>

<Aside>
Вы можете пропустить раздел **About Creating a Certificate Signing Request (CSR)**, так как вы уже создали его.
</Aside>

4. Выберите **Certificate Signing Request**, который вы создали ранее.

<img src="/ios-configuration-ios-platform-configuration-6.webp"
     alt="Загрузка файла CSR"/>

5. Загрузите сертификат и добавьте его в **Связку ключей (Keychain Access)**. Как только вы нажмете на сертификат, запустится **Связка ключей**.

<img src="/ios-configuration-ios-platform-configuration-7.webp"
     alt="Загрузка сертификата с портала разработчиков Apple"/>

## Экспорт закрытого ключа (.p12)

В **Связке ключей (Keychain Access)** щелкните правой кнопкой мыши по только что добавленному сертификату и выберите «Экспортировать».

<img src="/ios-configuration-ios-platform-configuration-8.webp"
     alt="Экспорт закрытого ключа в формате .p12 из Связки ключей"/>

Сохраните файл **Personal Information Exchange (.p12)**. Вам будет предложено установить пароль.

<Aside type="caution" title="Важно">
Обязательно запомните пароль от закрытого ключа, он понадобится вам позже.
</Aside>

После ввода пароля нажмите **Разрешить (Allow)**, чтобы завершить экспорт закрытого ключа.

## Настройка платформы iOS в Pushwoosh

В вашем проекте Pushwoosh перейдите в раздел **Configure Platforms** и нажмите **Connect** в строке iOS:

<img src="/ios-configuration-ios-platform-configuration-9.webp" alt="Панель управления Pushwoosh, показывающая строку iOS с кнопкой Connect"/>

В открывшейся форме выберите **ручную настройку на основе сертификата (certificate-based manual configuration)** и нажмите **Далее (Next)**:

<img src="/ios-configuration-ios-platform-configuration-10.webp" alt="Форма Pushwoosh с выбранной ручной настройкой на основе сертификата"/>

В открывшемся окне сделайте следующее:

* Загрузите файл сертификата (.p12)
* Введите **пароль от закрытого ключа (Private key password)**
* Выберите **шлюз (Gateway)**

<img src="/ios-configuration-ios-platform-configuration-11.webp" alt="Поля для загрузки файла .p12, ввода пароля и выбора шлюза в Pushwoosh"/>

Нажмите **Configure**, чтобы завершить настройку.