rzaripov.kz

Интеграция Apple Sign-In в приложение на Swift

Авторизация через Apple Sign-In даёт пользователю возможность войти в приложение без отдельной учётной записи и пароля. Нативная кнопка Apple использует существующий Apple ID, а разработчик получает защищённые токены для подтверждения личности. Такой подход уменьшает количество форм регистрации, повышает доверие к приложению и упрощает повторный вход на разных устройствах.

Для нативного приложения на iOS интеграция выполняется через фреймворк AuthenticationServices без сторонних библиотек. Клиент создаёт запрос и показывает системный интерфейс, а сервер проверяет полученный токен, обменивает код авторизации и создаёт собственную сессию пользователя.

Критерий Вход через Apple ID Вход по паролю OAuth через внешнего провайдера
Учётные данные Используется существующий Apple ID Требуется отдельный пароль Зависит от выбранного провайдера
Конфиденциальность Apple может передать скрытый адрес электронной почты Адрес виден приложению Правила определяются провайдером
Серверная проверка Проверка подписанного JWT и кода авторизации Проверка хеша пароля Проверка токена и параметров OAuth
Основной риск Подмена или повтор токена Подбор пароля и утечка базы Ошибки redirect_uri и scopes
Гибкость Используется только с Apple ID Подходит для собственной учётной записи Возможны разные внешние поставщики

Зачем нужен вход через Apple

Apple Sign-In особенно полезен приложениям, которым требуется быстрая авторизация без длинных форм. Пользователь подтверждает личность знакомым системным интерфейсом, а приложение может запросить имя и адрес электронной почты. Если пользователь предпочитает скрыть адрес, Apple передаёт специальный relay-адрес, который следует обрабатывать как временный идентификатор для обмена сообщениями.

Подход необходимо выбирать с учётом модели учётных записей и правил публикации. Если приложение предлагает вход через сторонние социальные сети, Apple рекомендует предоставлять эквивалентный вариант через Sign in with Apple. При этом приложение с собственной системой пользователей может использовать Apple Sign-In как дополнительный способ входа, не отказываясь от пароля или одноразового кода.

Подготовка проекта и тестовой среды

В Xcode необходимо указать реальный идентификатор пакета, включить для него возможность Sign In with Apple в Apple Developer и выбрать поддерживаемую минимальную версию iOS. Capability добавляет системную авторизацию и требует согласования с идентификатором, который затем проверяется в audience токена. Нативному приложению отдельный идентификатор для веб-версии не нужен, но он может понадобиться позднее.

Для проверки требуется реальный Apple ID с включённой двухфакторной аутентификацией. Sandbox-окружение полезно для проверкиCodes ошибок, однако финальное поведение следует тестировать на физическом устройстве. При веб-расширении redirect_uri должен вести на зарегистрированный HTTPS-домен. Публичная сторонняя страница не становится доверенным адресом возврата сама по себе: необходимо проверить владение доменом, правила перенаправления, параметры state и защиту кода авторизации.

Ключи, токены и проверка на сервере

Для серверного обмена создаётся ключ Apple Sign In с ролью Sign In with Apple. Он сохраняется в формате .p8, а связанные с ним Team ID и Key ID записываются в конфигурацию сервера. Приватный ключ нельзя помещать в мобильное приложение или хранить в репозитории. Из него формируется короткоживущий client secret в формате JWT с полями issuer, subject, audience, issued at и сроком действия.

Идентификационный токен представляет собой JWT, подписанный Apple. Сервер проверяет подпись, issuer, audience, время действия и nonce, а затем сопоставляет пользователя с локальной учётной записью. Значение email из тела токена нельзя считать достаточным доказательством личности: основой служит подпись и проверка заявленного nonce. Одноразовое значение создаётся криптографически, в запрос передаётся его SHA-256-хеш, а сервер сравнивает хеш исходного значения с соответствующим claim токена.

Реализация входа в Swift

Класс координатора запрашивает имя и адрес электронной почты, создаёт nonce и передаёт управление системному контроллеру. После завершенияAuthorizationServices возвращает идентификатор пользователя, JWT, код авторизации и, при первом предоставлении разрешений, сведения о профиле.

import AuthenticationServices
import CryptoKit
import Foundation
import Security
import SwiftUI
import UIKit

@MainActor
final class AppleSignInModel: NSObject, ObservableObject,
    ASAuthorizationControllerDelegate,
    ASAuthorizationControllerPresentationContextProviding {

    @Published var status = ""
    private var controller: ASAuthorizationController?
    private var rawNonce: String?

    func start() {
        let nonce = Self.makeNonce()
        rawNonce = nonce

        let request = ASAuthorizationAppleIDProvider().createRequest()
        request.requestedScopes = [.fullName, .email]
        request.nonce = Self.sha256(nonce)

        let controller = ASAuthorizationController(
            authorizationRequests: [request]
        )
        controller.delegate = self
        controller.presentationContextProvider = self
        self.controller = controller
        controller.performRequests()
    }

    func authorizationController(
        controller: ASAuthorizationController,
        didCompleteWithAuthorization authorization: ASAuthorization
    ) {
        guard let credential =
                authorization.credential as? ASAuthorizationAppleIDCredential,
              let tokenData = credential.identityToken,
              let codeData = credential.authorizationCode,
              let nonce = rawNonce else {
            status = "Apple не вернул необходимые данные"
            return
        }

        let identityToken = String(data: tokenData, encoding: .utf8) ?? ""
        let authorizationCode = String(data: codeData, encoding: .utf8) ?? ""

        // Передайте токен, код и nonce серверу по HTTPS.
        status = "Данные готовы к серверной проверке"
    }

    func authorizationController(
        controller: ASAuthorizationController,
        didCompleteWithError error: Error
    ) {
        let authorizationError = error as? ASAuthorizationError
        if authorizationError?.code == .canceled {
            status = "Вход отменён"
        } else {
            status = "Не удалось выполнить вход"
        }
    }

    func presentationAnchor(
        for controller: ASAuthorizationController
    ) -> ASPresentationAnchor {
        UIApplication.shared.connectedScenes
            .compactMap { $0 as? UIWindowScene }
            .flatMap { $0.windows }
            .first { $0.isKeyWindow } ?? ASPresentationAnchor()
    }

    private static func makeNonce() -> String {
        var bytes = [UInt8](repeating: 0, count: 32)
        let result = SecRandomCopyBytes(
            kSecRandomDefault,
            bytes.count,
            &bytes
        )

        guard result == errSecSuccess else {
            fatalError("Не удалось создать одноразовое значение")
        }

        return Data(bytes).base64EncodedString()
    }

    private static func sha256(_ value: String) -> String {
        SHA256.hash(data: Data(value.utf8))
            .map { String(format: "%02x", $0) }
            .joined()
    }
}

В SwiftUI кнопка создаётся через SignInWithAppleButton, а её обработчик вызывает start(). Идентификатор credential.user следует сохранить как связь между локальным профилем и учётной записью Apple. Имя и адрес электронной почты могут отсутствовать при повторном входе, поэтому приложение должно рассчитывать на идентификатор пользователя и данные, полученные ранее.

Обработка ошибок и серверной сессии

Сервер принимает код авторизации, identity token и исходный nonce по защищённому соединению. Затем он обменивает код на токены у Apple, проверяет подпись JWT и создаёт собственную сессию. Ошибки различают по типу: отмену пользователя, временный сбой сети, невозможность обработки запроса и отказ Apple. Эти состояния влияют на текст интерфейса, но не отменяют необходимость серверной проверки.

После успешного входа Apple Credential State позволяет определить, остаётся ли разрешение действительным. Состояния authorized, revoked, transferred и notFound обрабатываются по-разному: отзыв доступа требует повторной авторизации, а перенос учётной записи может потребовать создания новой связи. Секреты и identifiers сессии хранятся в Keychain, а краткоживущий identity token не используется как долгосрочный идентификатор пользователя.

Проверка перед выпуском и проекты разработчика

Перед релизом следует проверить первый вход, повторный вход, отмену, отсутствие разрешений на профиль, скрытый адрес электронной почты и отзыв доступа. Полезно протестировать смену языка, устройство с включённой двухфакторной аутентификацией и истечение серверной сессии. Политика конфиденциальности должна объяснять сохраняемые идентификаторы и цели обработки данных, а демонстрационный сценарий для проверяющих не должен обходить реальный серверный обмен токенами.

Опыт Равиля Зарипова из Алматы охватывает разработку приложений для Android, iOS, Windows, macOS и Linux, включая Delphi, FireMonkey, Kotlin, Swift, PHP и базы данных. Другие реализации и кроссплатформенные проекты собраны в каталоге проектов. Нативная авторизация на Swift дополняет такой стек разработки безопасным входом, серверной проверкой токенов и предсказуемым управлением пользовательскими сессиями.