콘솔로 이동

iOS에서 GitHub로 인증하기

앱에 GitHub 인증을 통합하여 사용자가 GitHub 계정을 통해 Firebase에 인증하도록 할 수 있습니다.

인증을 마친 사용자는 Firebase 실시간 데이터베이스와 Cloud Storage에 있는 사용자 전용 데이터에 액세스할 수 있습니다.

시작하기 전에

  1. iOS 프로젝트에 Firebase를 추가합니다. Podfile에 다음 pod를 추가합니다.
    pod 'Firebase/Auth'
  2. GitHub에서 개발자 애플리케이션으로 앱을 등록하고 앱의 OAuth 2.0 클라이언트 ID클라이언트 비밀번호를 가져옵니다.
  3. 다음과 같이 GitHub 인증을 사용 설정합니다.
    1. Firebase 콘솔에서 인증 섹션을 엽니다.
    2. 로그인 방법 탭에서 GitHub 로그인 방법을 사용 설정하고 GitHub에서 받은 OAuth 2.0 클라이언트 ID클라이언트 비밀번호를 지정합니다.
    3. 그런 다음 GitHub 앱 구성의 앱 설정 페이지에서 Firebase OAuth 리디렉션 URI(예: my-app-12345.firebaseapp.com/__/auth/handler)가 승인 콜백 URL로 설정되어 있는지 확인합니다.

Firebase로 인증하기

  1. 개발자 문서를 참고해 앱에 GitHub 인증을 통합합니다. 웹 애플리케이션 흐름을 사용해서 앱에 맞춤 URL 스키마를 설정합니다. GitHub에서 받은 OAuth 2.0 콜백을 처리하기 위한 것입니다. GitHub 로그인 흐름의 끝에서 OAuth 2.0 액세스 토큰을 받을 수 있습니다.
  2. UIApplicationDelegate에서 Firebase 모듈을 가져옵니다.

    Swift

    import Firebase
    

    Objective-C

    @import Firebase;
    
  3. FirebaseApp 공유 인스턴스를 구성합니다. 일반적으로 애플리케이션의 application:didFinishLaunchingWithOptions: 메소드에서 구성합니다.

    Swift

    // Use Firebase library to configure APIs
    FirebaseApp.configure()

    Objective-C

    // Use Firebase library to configure APIs
    [FIRApp configure];
  4. 사용자가 GitHub에 정상적으로 로그인한 후에 didCompleteWithResult:error: 구현 코드에서 OAuth 2.0 액세스 토큰을 Firebase 사용자 인증 정보로 교환합니다.

    Swift

    let credential =
        GitHubAuthProvider.credential(withToken: accessToken)
    

    Objective-C

    FIRAuthCredential *credential =
        [FIRGitHubAuthProvider credentialWithToken:accessToken];
    
  5. 마지막으로 Firebase 사용자 인증 정보를 사용해 Firebase에 인증합니다.

    Swift

    Auth.auth().signInAndRetrieveData(with: credential) { (authResult, error) in
      if let error = error {
        // ...
        return
      }
      // User is signed in
      // ...
    }

    Objective-C

    [[FIRAuth auth] signInAndRetrieveDataWithCredential:credential
                                             completion:^(FIRAuthDataResult * _Nullable authResult,
                                                          NSError * _Nullable error) {
      if (error) {
        // ...
        return;
      }
      // User successfully signed in. Get user data from the FIRUser object
      if (authResult == nil) { return; }
      FIRUser *user = authResult.user;
      // ...
    }];

다음 단계

사용자가 처음으로 로그인하면 신규 사용자 계정이 생성되고 사용자 인증 정보(사용자가 로그인할 때 사용한 사용자 이름과 비밀번호, 전화번호 또는 인증 제공업체 정보)에 연결됩니다. 이 신규 계정은 Firebase 프로젝트에 저장되며 사용자의 로그인 방법과 무관하게 프로젝트 내의 모든 앱에서 사용자 본인 확인에 사용할 수 있습니다.

  • 앱에서 FIRUser 객체로부터 사용자의 기본 프로필 정보를 가져올 수 있습니다. 사용자 관리를 참고하세요.

  • Firebase 실시간 데이터베이스와 Cloud Storage 보안 규칙에서 로그인한 사용자의 고유 사용자 ID를 auth 변수로부터 가져온 후 이 ID를 통해 사용자가 액세스할 수 있는 데이터를 관리할 수 있습니다.

인증 제공업체의 사용자 인증 정보를 기존 사용자 계정에 연결하면 사용자가 여러 인증 제공업체를 통해 앱에 로그인할 수 있습니다.

사용자를 로그아웃시키려면 signOut:을 호출합니다.

Swift

    let firebaseAuth = Auth.auth()
do {
  try firebaseAuth.signOut()
} catch let signOutError as NSError {
  print ("Error signing out: %@", signOutError)
}  

Objective-C

    NSError *signOutError;
BOOL status = [[FIRAuth auth] signOut:&signOutError];
if (!status) {
  NSLog(@"Error signing out: %@", signOutError);
  return;
}

또한 모든 인증 오류에 대한 오류 처리 코드를 추가할 수도 있습니다. 오류 처리를 참조하세요.