> For the complete documentation index, see [llms.txt](https://docs.iexexchanger.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.iexexchanger.com/guide/polzovateli/vkhod-cherez-servisy/nastroika-vkhoda-cherez-apple.md).

# Настройка входа через Apple

Для подключения Apple ID потребуется активный аккаунт Apple Developer.

### Шаг 1. Откройте Apple Developer

Перейдите:

```
https://developer.apple.com/account/
```

Откройте раздел: **Certificates, Identifiers & Profiles**

***

### Шаг 2. Создайте App ID

Создайте новый App ID или используйте существующий.

Обязательно включите возможность: **Sign in with Apple**

***

### Шаг 3. Создайте Services ID

Откройте: `Identifiers → Services IDs`

Создайте новый Services ID.

Пример идентификатора:

```
com.example.exchange.service
```

После создания включите: **Sign in with Apple**

***

### Шаг 4. Укажите домен и Return URL

В настройках Services ID заполните:

#### Domain

```
example.com
```

#### Return URL

Скопируйте Return URL из админки и вставьте его без изменений.

***

### Шаг 5. Создайте ключ

Перейдите: **Keys**

Создайте новый ключ и включите: **Sign in with Apple**

После создания сохраните:

* Team ID
* Key ID
* Private Key (.p8)

Важно: файл `.p8` обычно можно скачать только один раз.

***

### Шаг 6. Заполните настройки в админке

Откройте: **«Пользователи» — «Вход через сервисы» — «Apple»**

Заполните:

* Client ID
* Team ID
* Key ID
* Private Key (.p8)

Включите сервис и сохраните изменения.

***

### Шаг 7. Выполните проверку

Нажмите: **Проверить**

После успешной проверки выполните тестовый вход через Apple ID на клиентской части сайта.

***

### Частая ошибка

<details>

<summary>Invalid Redirect URL</summary>

Причина: **Return URL в Apple отличается от Return URL из админки.**

Решение: **Проверьте домен и полностью замените URL на тот, который отображается в системе.**

</details>

***

### Рекомендации

* Используйте только HTTPS.
* Храните файл `.p8` в безопасном месте.
* Не публикуйте Team ID, Key ID и Private Key.
* После смены домена обязательно обновите настройки Apple Developer.
* Перед запуском выполните тестовую авторизацию на реальном сайте.