Platform
Технический гид: Настройка «Вход с Apple» в XCode

15min
Учебник по входу с Apple
Введение
Вход с Apple позволяет пользователям входить в приложения, используя свой Apple ID.
Эта функция доступна на iOS 13 и более поздних версиях, а также на Parse 3.5 и более поздних версиях.
Предварительные требования
Для завершения этого учебника вам потребуется:
Приложение, созданное на Back4App
Смотрите учебник по созданию нового приложения чтобы узнать, как создать приложение на Back4App.
Настройте поддомен для вашего приложения Back4app
Смотрите Активация вашего веб-хостинга и живого запроса чтобы узнать, как создать поддомен в Back4App.
Учетная запись разработчика Apple.
- Создайте новое приложение Back4App
Прежде всего, необходимо убедиться, что у вас есть существующее приложение, созданное на Back4App. Однако, если вы новый пользователь, вы можете ознакомиться с этим учебником чтобы узнать, как создать одно.
- Добавьте возможность Войти с помощью Apple в ваш проект XCode
В вашем проекте XCode нажмите на Цель (1) и перейдите на вкладку Подпись и возможности (2).
Нажмите кнопку + Возможность (3) и добавьте возможность Войти с помощью Apple (4).
Пока вы там, выберите ваш Идентификатор пакета (5) и сохраните эту информацию, потому что она нам понадобится позже.
﻿
- Создайте новый Идентификатор службы
Войдите в свой учетную запись разработчика Apple и перейдите в раздел Идентификаторы . Проверьте, есть ли ваш созданный Идентификатор пакета там
﻿
Нажмите на Идентификатор пакета и прокрутите вниз. Проверьте, выбран ли Войти с помощью Apple.
﻿
Нажмите Редактировать и убедитесь, что Включить как основной идентификатор приложения выбран
﻿
Если все верно, сохраните и выйдите.
- Настройка Parse Auth для Apple
Перейдите на сайт Back4App, войдите в систему и найдите ваше приложение. После этого нажмите на Настройки сервера найдите блок Вход через Apple и выберите Настройки.
Раздел Вход через Apple выглядит так:
﻿
Теперь вам просто нужно вставить ваш Bundle ID в поле ниже и нажать кнопку для сохранения.
﻿
Если у вас возникнут какие-либо проблемы при интеграции Apple Login, пожалуйста, свяжитесь с нашей командой через чат!
- Вариант 1 - Скачайте наш шаблон
В процессе настройки входа с помощью Apple требуется немного программирования, поэтому мы создали этот шаблон который вы можете скачать и изменить Bundle Identifier, App Id, и Client Key.
Код полностью документирован, поэтому это хорошая отправная точка.
Если вы предпочитаете прочитать этот документ, пожалуйста, переходите к следующему шагу.
- Вариант 2 - Написать код вручную
Внутри вашего представления добавьте фреймворк AuthenticationServices и создайте AuthDelegate, который будет обрабатывать PFUserAuthenticationDelegate:
Swift
 import AuthenticationServices
2
 class AuthDelegate:NSObject, PFUserAuthenticationDelegate {
     func restoreAuthentication(withAuthData authData: [String : String]?) -> Bool {
         return true
     }
  
     func restoreAuthenticationWithAuthData(authData: [String : String]?) -> Bool {
         return true
    }
}
 import AuthenticationServices
2
 class AuthDelegate:NSObject, PFUserAuthenticationDelegate {
     func restoreAuthentication(withAuthData authData: [String : String]?) -> Bool {
         return true
     }
  
     func restoreAuthenticationWithAuthData(authData: [String : String]?) -> Bool {
         return true
    }
}
﻿
- Реализуйте свои делегаты для ViewController
Реализуйте ASAuthorizationControllerDelegate и ASAuthorizationControllerPresentationContextProviding для ViewController:
Swift
 class ViewController: UIViewController, ASAuthorizationControllerDelegate, ASAuthorizationControllerPresentationContextProviding
 class ViewController: UIViewController, ASAuthorizationControllerDelegate, ASAuthorizationControllerPresentationContextProviding
﻿
- Добавьте кнопку Войти с помощью Apple
ViewDidAppear - хорошее место для этого. Если вы выберете другие места, не забудьте вызвать его только один раз:
Swift
 override func viewDidAppear(_ animated: Bool) {
         super.viewDidAppear(animated)
      
         // Sign In with Apple button
         let signInWithAppleButton = ASAuthorizationAppleIDButton()
6
         // set this so the button will use auto layout constraint
         signInWithAppleButton.translatesAutoresizingMaskIntoConstraints = false
9
        // add the button to the view controller root view
        self.view.addSubview(signInWithAppleButton)
12
        // set constraint
        NSLayoutConstraint.activate([
            signInWithAppleButton.leadingAnchor.constraint(equalTo: view.safeAreaLayoutGuide.leadingAnchor, constant: 50.0),
            signInWithAppleButton.trailingAnchor.constraint(equalTo: view.safeAreaLayoutGuide.trailingAnchor, constant: -50.0),
            signInWithAppleButton.bottomAnchor.constraint(equalTo: view.safeAreaLayoutGuide.bottomAnchor, constant: -70.0),
            signInWithAppleButton.heightAnchor.constraint(equalToConstant: 50.0)
        ])
20
        // the function that will be executed when user tap the button
        signInWithAppleButton.addTarget(self, action: #selector(appleSignInTapped), for: .touchUpInside)
    }
 override func viewDidAppear(_ animated: Bool) {
         super.viewDidAppear(animated)
      
         // Sign In with Apple button
         let signInWithAppleButton = ASAuthorizationAppleIDButton()
6
         // set this so the button will use auto layout constraint
         signInWithAppleButton.translatesAutoresizingMaskIntoConstraints = false
9
        // add the button to the view controller root view
        self.view.addSubview(signInWithAppleButton)
12
        // set constraint
        NSLayoutConstraint.activate([
            signInWithAppleButton.leadingAnchor.constraint(equalTo: view.safeAreaLayoutGuide.leadingAnchor, constant: 50.0),
            signInWithAppleButton.trailingAnchor.constraint(equalTo: view.safeAreaLayoutGuide.trailingAnchor, constant: -50.0),
            signInWithAppleButton.bottomAnchor.constraint(equalTo: view.safeAreaLayoutGuide.bottomAnchor, constant: -70.0),
            signInWithAppleButton.heightAnchor.constraint(equalToConstant: 50.0)
        ])
20
        // the function that will be executed when user tap the button
        signInWithAppleButton.addTarget(self, action: #selector(appleSignInTapped), for: .touchUpInside)
    }
﻿
appleSignInTapped в последней строке также должен быть определен внутри класса ViewController:
Swift
// This is the function that will be executed when user taps the button
     @objc func appleSignInTapped() {
         let provider = ASAuthorizationAppleIDProvider()
         let request = provider.createRequest()
         // request full name and email from the user's Apple ID
         request.requestedScopes = [.fullName, .email]
7
         // pass the request to the initializer of the controller
         let authController = ASAuthorizationController(authorizationRequests: [request])
      
        // similar to delegate, this will ask the view controller
        // which window to present the ASAuthorizationController
        authController.presentationContextProvider = self
      
        // delegate functions will be called when user data is
        // successfully retrieved or error occured
        authController.delegate = self
        
        // show the Sign-in with Apple dialog
        authController.performRequests()
    }
// This is the function that will be executed when user taps the button
     @objc func appleSignInTapped() {
         let provider = ASAuthorizationAppleIDProvider()
         let request = provider.createRequest()
         // request full name and email from the user's Apple ID
         request.requestedScopes = [.fullName, .email]
7
         // pass the request to the initializer of the controller
         let authController = ASAuthorizationController(authorizationRequests: [request])
      
        // similar to delegate, this will ask the view controller
        // which window to present the ASAuthorizationController
        authController.presentationContextProvider = self
      
        // delegate functions will be called when user data is
        // successfully retrieved or error occured
        authController.delegate = self
        
        // show the Sign-in with Apple dialog
        authController.performRequests()
    }
﻿
- presentationContextProvider
Провайдер контекста презентации (ASAuthorizationControllerPresentationContextProviding) запросит, в каком окне должно отображаться диалоговое окно авторизации. Поскольку мы собираемся отображать его в том же окне, мы должны вернуть self.view.window:
Swift
 func presentationAnchor(for controller: ASAuthorizationController) -> ASPresentationAnchor {
         // return the current view window
         return self.view.window!
     }
 func presentationAnchor(for controller: ASAuthorizationController) -> ASPresentationAnchor {
         // return the current view window
         return self.view.window!
     }
﻿
- Обработка делегата ASAuthorizationControllerDelegate
Существует несколько вариантов, которые мы должны обработать, когда вызывается делегат, поэтому давайте добавим немного кода, чтобы обрабатывать эти варианты отдельно:
Swift
 func authorizationController(controller: ASAuthorizationController, didCompleteWithError error: Error) {
         print("authorization error")
         guard let error = error as? ASAuthorizationError else {
             return
         }
6
         switch error.code {
         case .canceled:
             // user press "cancel" during the login prompt
            print("Canceled")
        case .unknown:
            // user didn't login their Apple ID on the device
           print("Unknown")
        case .invalidResponse:
            // invalid response received from the login
            print("Invalid Respone")
        case .notHandled:
            // authorization request not handled, maybe internet failure during login
            print("Not handled")
        case .failed:
            // authorization failed
            print("Failed")
        @unknown default:
            print("Default")
        }
    }
 func authorizationController(controller: ASAuthorizationController, didCompleteWithError error: Error) {
         print("authorization error")
         guard let error = error as? ASAuthorizationError else {
             return
         }
6
         switch error.code {
         case .canceled:
             // user press "cancel" during the login prompt
            print("Canceled")
        case .unknown:
            // user didn't login their Apple ID on the device
           print("Unknown")
        case .invalidResponse:
            // invalid response received from the login
            print("Invalid Respone")
        case .notHandled:
            // authorization request not handled, maybe internet failure during login
            print("Not handled")
        case .failed:
            // authorization failed
            print("Failed")
        @unknown default:
            print("Default")
        }
    }
﻿
- Обработка делегата для didCompleteWithAuthorization
Когда мы успешно аутентифицируемся, мы можем получить авторизованную информацию:
Swift
    func authorizationController(controller: ASAuthorizationController, didCompleteWithAuthorization authorization: ASAuthorization) {
      
            if let appleIDCredential = authorization.credential as? ASAuthorizationAppleIDCredential {
                // unique ID for each user, this uniqueID will always be returned
                let userID = appleIDCredential.user
                print("UserID: " + userID)
          
                // if needed, save it to user defaults by uncommenting the line below
                //UserDefaults.standard.set(appleIDCredential.user, forKey: "userID")
          
               // optional, might be nil
               let email = appleIDCredential.email
               print("Email: " + (email ?? "no email") )
          
               // optional, might be nil
               let givenName = appleIDCredential.fullName?.givenName
               print("Given Name: " + (givenName ?? "no given name") )
          
               // optional, might be nil
               let familyName = appleIDCredential.fullName?.familyName
               print("Family Name: " + (familyName ?? "no family name") )
          
               // optional, might be nil
               let nickName = appleIDCredential.fullName?.nickname
               print("Nick Name: " + (nickName ?? "no nick name") )
               /*
                   useful for server side, the app can send identityToken and authorizationCode
                   to the server for verification purpose
               */
               var identityToken : String?
               if let token = appleIDCredential.identityToken {
                   identityToken = String(bytes: token, encoding: .utf8)
                   print("Identity Token: " + (identityToken ?? "no identity token"))
               }
35
               var authorizationCode : String?
               if let code = appleIDCredential.authorizationCode {
                   authorizationCode = String(bytes: code, encoding: .utf8)
                   print("Authorization Code: " + (authorizationCode ?? "no auth code") )
               }
41
               // do what you want with the data here
          
         }    
     }
    func authorizationController(controller: ASAuthorizationController, didCompleteWithAuthorization authorization: ASAuthorization) {
      
            if let appleIDCredential = authorization.credential as? ASAuthorizationAppleIDCredential {
                // unique ID for each user, this uniqueID will always be returned
                let userID = appleIDCredential.user
                print("UserID: " + userID)
          
                // if needed, save it to user defaults by uncommenting the line below
                //UserDefaults.standard.set(appleIDCredential.user, forKey: "userID")
          
               // optional, might be nil
               let email = appleIDCredential.email
               print("Email: " + (email ?? "no email") )
          
               // optional, might be nil
               let givenName = appleIDCredential.fullName?.givenName
               print("Given Name: " + (givenName ?? "no given name") )
          
               // optional, might be nil
               let familyName = appleIDCredential.fullName?.familyName
               print("Family Name: " + (familyName ?? "no family name") )
          
               // optional, might be nil
               let nickName = appleIDCredential.fullName?.nickname
               print("Nick Name: " + (nickName ?? "no nick name") )
               /*
                   useful for server side, the app can send identityToken and authorizationCode
                   to the server for verification purpose
               */
               var identityToken : String?
               if let token = appleIDCredential.identityToken {
                   identityToken = String(bytes: token, encoding: .utf8)
                   print("Identity Token: " + (identityToken ?? "no identity token"))
               }
35
               var authorizationCode : String?
               if let code = appleIDCredential.authorizationCode {
                   authorizationCode = String(bytes: code, encoding: .utf8)
                   print("Authorization Code: " + (authorizationCode ?? "no auth code") )
               }
41
               // do what you want with the data here
          
         }    
     }
﻿
Это место, где мы также можем добавить код для входа в Parse. Так что сразу после делайте что хотите с данными здесь комментария, давайте добавим:
Swift
 PFUser.logInWithAuthType(inBackground: "apple", authData: ["token": String(identityToken!), "id": userID]).continueWith { task -> Any? in
                 if ((task.error) != nil){
                     //DispatchQueue.main.async {
                         print("Could not login.\nPlease try again.")
                         print("Error with parse login after SIWA: \(task.error!.localizedDescription)")
                     //}
                     return task
                 }
                 print("Successfuly signed in with Apple")
                return nil
            }
 PFUser.logInWithAuthType(inBackground: "apple", authData: ["token": String(identityToken!), "id": userID]).continueWith { task -> Any? in
                 if ((task.error) != nil){
                     //DispatchQueue.main.async {
                         print("Could not login.\nPlease try again.")
                         print("Error with parse login after SIWA: \(task.error!.localizedDescription)")
                     //}
                     return task
                 }
                 print("Successfuly signed in with Apple")
                return nil
            }
﻿
И, конечно, добавьте фреймворк Parse:
Swift
 import Parse
 import Parse
﻿
Настройка верификации почты в Parse Server
Настройка Instagram OAuth в Back4App: полное руководство
Технический гид: Настройка «Вход с Apple» в XCode

Учебник по входу с Apple

Введение

Предварительные требования

1 - Создайте новое приложение Back4App

2 - Добавьте возможность Войти с помощью Apple в ваш проект XCode

3 - Создайте новый Идентификатор службы

4 - Настройка Parse Auth для Apple

5 - Вариант 1 - Скачайте наш шаблон

6 - Вариант 2 - Написать код вручную

7 - Реализуйте свои делегаты для ViewController

8 - Добавьте кнопку Войти с помощью Apple

9 - presentationContextProvider

10 - Обработка делегата ASAuthorizationControllerDelegate

11 - Обработка делегата для didCompleteWithAuthorization
