Настройка модуля «Вход с Apple»

Модуль добавляет кнопку «Войти с Apple» в форму авторизации сайта. Пользователь входит через Apple Account, а ADWOS CMS проверяет id_token на сервере.

Что получает CMS

• Sign in with Apple OAuth 2.0 и OpenID Connect. Поддерживается официальный web-flow Apple и нативный SDK для мобильных приложений.
• Проверка подписи id_token. Модуль валидирует iss, aud, срок действия и подпись через JWKS Apple.
• Hide My Email. Если пользователь выбрал «Скрыть e-mail», CMS сохранит relay-адрес Apple как обычный e-mail.
• Стабильная привязка по sub. Apple отдаёт имя только при первом входе, поэтому повторные входы связываются по постоянному идентификатору.
• Автоматическая регистрация. При первом успешном входе CMS создаёт пользователя и связывает его с Apple.

Установка в ADWOS CMS

• Откройте админ-панель сайта под пользователем с правами администратора.
• В разделе «Каталог» откройте «Маркетплейс» и найдите модуль по названию.
• Нажмите «Установить». Если модуль уже установлен, откройте его карточку.
• Откройте настройки модуля, заполните обязательные поля и сохраните изменения.
• Включите модуль и проверьте, что кнопка входа появилась в форме авторизации.

Поля в настройках модуля

• Client ID (Services ID): Services ID, который вы создали в Apple Developer (например org.adwos.signin). Используется как client_id в OAuth-обмене и как audience в id_token.
• Team ID: Team ID из Apple Developer (10 символов, например ABCDE12345). Виден в правом верхнем углу Developer Portal.
• Key ID: Key ID из Apple Developer, раздел Keys. Обычно это 10 символов, например XY7ABC1234. Значение храните только в защищённых настройках ADWOS CMS.
• Private Key (.p8 содержимое): Содержимое скачанного .p8 файла целиком (с заголовком -----BEGIN PRIVATE KEY----- и хвостом -----END PRIVATE KEY-----). Используется для подписи client_secret JWT. Значение храните только в защищённых настройках ADWOS CMS.
• Иконка модуля (свой SVG/PNG, опционально): Загрузите свой логотип. Если не задано — используется фирменная иконка по умолчанию. Рекомендуется квадратный SVG.

Как настроить

1. Откройте Apple Developer Console и раздел Identifiers.
2. Создайте App ID с capability Sign in with Apple.
3. Создайте Services ID. Это Client ID для web-входа.
4. В настройках Services ID добавьте домен сайта без https:// и Return URL из поля «Redirect URI» в настройках модуля.
5. В разделе Keys создайте ключ с capability Sign in with Apple, скачайте файл .p8 и сохраните Key ID.
6. Введите Client ID, Team ID, Key ID и содержимое Private Key в настройки ADWOS CMS.

Важно

Apple отдаёт имя пользователя только один раз, при первом согласии. Если имя важно для профиля, сохраните его сразу после первого входа.

Проверка после включения

• Откройте страницу входа в приватном окне браузера.
• Убедитесь, что кнопка провайдера отображается и открывает официальный домен авторизации.
• Проверьте, что Redirect URI в кабинете провайдера совпадает со значением в ADWOS CMS полностью.
• Полный вход проверяйте после активации ключей провайдера. Без рабочих ключей модуль должен показывать ошибку настройки, а не ломать страницу входа.