[TIL] Sign In with Apple

[samsung-ga]

Sign In with Apple

iOS 13.0+ | Xcode 11.3+ 이후부터 사용 가능

🚀 개념 설명

• 애플은 2019년 애플 로그인 기능을 발표했다.
• 다른 소셜 로그인 서비스를 사용하고 있다면 애플 로그인은 필수로 적용해야한다.

🚀 사용법

1. Capability 추가

• Xcode Project의 Signing & Capabilites를 열어 왼쪽 상단의 + Capability를 선택한다.

• 이후 Sign In with Apple을 검색하여 클릭하여 추가한다.
  

  

  
  

• 위 Xcode Project에서 Capabilites를 추가하면 자동으로 Apple Developer에도 추가가 되지만, 만일 되지 않았다면 아래 방법을 진행한다.

• Apple Developer - Certificates, Identifiers & Profiles 메뉴에서 애플로그인을 추가할 앱에 아래와 같이 Sign in with Apple을 선택한다.

2. 버튼 추가하기

• ASAuthorizationAppleIDButton 클래스를 사용하여 시스템이 제공해 주는 로그인 버튼을 생성하는 방법이 있다.
• 또는, 직접 커스텀하여 넣는 방법도 있다. (HIG에 Sign In with Apple 버튼 디자인 기준이 세세하게 명시되어 있음) 애플 로그인 버튼 HIG 링크

  let authorizationButton = ASAuthorizationAppleIDButton(type: .signIn, style: .white)
  authorizationButton.addTarget(self, action: #selector(handleAuthorizationAppleIDButtonPress), for: .touchUpInside)

3. Apple Login 인증 창 띄우기

• AuthenticationServices 프레임워크를 import 한다.

• 아래 코드를 작성한다.

  @objc
  private func authorizationButtonDidTapped() {
  let appleIDProvider = ASAuthorizationAppleIDProvider()
  let request = appleIDProvider.createRequest()
  request.requestedScopes = [.fullName, .email]
  
  let authorizationController = ASAuthorizationController(authorizationRequests: [request])
  authorizationController.delegate = self
  authorizationController.presentationContextProvider = self
  authorizationController.performRequests()
  }

• 코드 설명을 하면 아래와 같다.
  1. provider 객체에 의해 생성된 권한 요청의 scopes를 지정한다. 이 때, fullname과 email 두 가지 정보를 요구할 수 있다.
  2. 권한 요청을 이용하여 controller를 생성하고, controller의 delegate와 presentationContextProvider를 지정한다. (delegate에 의해 채택해야할 프로토콜에 대해서는 다음 단계에서 설명한다.)
  3. 마지막으로 performRequests()를 통해 요청을 보낸다.
• ASAuthorizationControllerPresentationContextProviding 프로토콜을 채택하고 인증창을 띄워야 할 뷰의 window를 반환한다.

Apple Login 인증 창에서 사용자의 email과 FullName을 보여준다. 이 때 사용자는 이메일 공유방법을 선택할 수 있는데, 이메일 가리기를 선택하게 되면 실제 이메일을 사용하여 ~@privaterelay.appleid.com 의 형태로 임의로 생성된 이메일 주소를 받는다. ⚠️ 최초 애플 로그인을 시도 시에만 email과 fullName을 애플에서 제공되며, 두 번째 인증부터는 제공되지 않는다.

4. Apple Login 인증 결과 다루기

• Apple ID의 인증 결과 및 요청 값인 email과 fullName을 전달받기 위해 ASAuthorizationControllerDelegate를 채택한다.
• 인증이 성공하면 didCompleteWithAuthorization, 실패하면 didCompleteWithAuthorization가 호출된다.
• 인증을 마치면 credential에서 요청한 정보들인 userIdentifier, email, fullName을 받을 수 있다.

  userIdentifier는 Apple ID의 고유한 값으로 변경되지 않는다.

5. 세션 변경 처리하기 & 자동 로그인

• 사용자가 중간에 Apple ID 사용중단 버튼을 클릭하게 될 경우, 혹은 자동 로그인을 구현해야하는 상황
• 이전에 조회한 사용자 정보 값을 appleIDCredential.user를 통해 현재 어떤 인증 상태인지 알 수 있다.
• 아래 코드와 같이 ASAuthorizationAppleIDProvider 내의 getCredentialState 를 사용하여 현재 사용자 인증 상태를 조회할 수 있다.

  // 🚀 여기서는 UserIdentifier를 KeychainItem에 저장한 상황이다.
  func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
      let appleIDProvider = ASAuthorizationAppleIDProvider()
      appleIDProvider.getCredentialState(forUserID: KeychainItem.currentUserIdentifier) { (credentialState, error) in
          switch credentialState {
          case .authorized:
              break // ✅ 인증 성공 상태
          case .revoked, .notFound: 
              // ✅ 인증 만료 상태
              DispatchQueue.main.async {
                  self.window?.rootViewController?.showLoginViewController()
              }
          default:
              break
          }
      }
      return true
  }

• 사용 중단 후 앱을 재실행한 경우, 혹은 앱을 사용하던 도중에 사용중단이 되는 경우 두가지 케이스 모두 처리해야 한다.
• 즉, SceneDelegate의 Life Cycle일 경우 scene 메서드와 sceneDidBecomeActive 메서드에서 처리해야 한다.
• notFound일 경우는 애플 로그인 시스템에 문제가 있을 때, 혹은 잘못된 UserIdentifier로 credentialState를 조회할 때이다.

🚀 몇가지 객체 정의

• ASAuthorizationAppleIDButton : 애플에서 제공해주는 Apple Login 버튼 객체
• ASAuthorizationAppleIDProvider : Apple ID를 기반으로 사용자 인증 요청을 생성하는 메커니즘를 담고 있는 객체 | request를 만들기 위해 provider 객체를 생성하고, request를 이용하여 ASAuthorizationController를 생성한다.

  // ✅ 이전 값에 의존하고 있는 controller, request
  let provider = ASAuthorizationAppleIDProvider()
  let request = provider.createRequest()
  let controller = ASAuthorizationController(authorizationRequests: [request])

• ASAuthorizationController : provider 객체에 의해 생성된 권한 요청을 관리하는 controller 객체

Reference

• Apple Documentation - Sign In With Apple
• 브랜디 애플 로그인 글

[samsung-ga]

다수의 소셜 로그인 방법이 존재하기 때문에 코드가 복잡해질 것을 방지하기 위해여 애플 로그인만을 담당하는 Manager를 별도로 생성하는 방법
AppleLoginManager.swift

protocol AppleLoginManagerDelegate: AnyObject {
    func appleLoginFail()
    func appleLoginSuccess()
}

final class AppleLoginManager: NSObject {
    weak var viewController: UIViewController?
    weak var delegate: AppleLoginManagerDelegate?

    func setAppleLoginPresentationAnchorView(_ viewController: UIViewController) {
        self.viewController = viewController
    }
}

extension AppleLoginManager: ASAuthorizationControllerPresentationContextProviding {
    func presentationAnchor(for controller: ASAuthorizationController) -> ASPresentationAnchor {
        return viewController!.view.window!
    }
}

extension AppleLoginManager: ASAuthorizationControllerDelegate {
    func authorizationController(controller: ASAuthorizationController, didCompleteWithAuthorization authorization: ASAuthorization) {
        if let appleIDCredential = authorization.credential as? ASAuthorizationAppleIDCredential {
            let userIdentifier = appleIDCredential.user
            let userName = appleIDCredential.fullName
            let userEmail = appleIDCredential.email

            delegate?.appleLoginSuccess()

        }
    }

    func authorizationController(controller: ASAuthorizationController, didCompleteWithError error: Error) {
        delegate?.appleLoginFail()
    }
}

• iOS Sign in with Apple 적용하기