Интеграция 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 дополняет такой стек разработки безопасным входом, серверной проверкой токенов и предсказуемым управлением пользовательскими сессиями.