이 페이지는 Cloud Translation API를 통해 번역되었습니다.

Apple 플랫폼에서 GitHub를 사용하여 인증

Firebase SDK를 사용하여 일반 OAuth 로그인을 앱에 통합하여 사용자가 GitHub와 같은 OAuth 제공업체를 사용하여 Firebase에 인증하도록 하여 종단 간 로그인 흐름을 수행할 수 있습니다.

시작하기 전에

GitHub 계정을 사용하여 사용자를 로그인하려면 먼저 Firebase 프로젝트의 로그인 공급자로 GitHub를 활성화해야 합니다.

Swift Package Manager를 사용하여 Firebase 종속 항목을 설치하고 관리합니다.

Xcode에서 앱 프로젝트를 연 상태에서 File > Add Packages 로 이동합니다.
메시지가 표시되면 Firebase Apple 플랫폼 SDK 저장소를 추가합니다.

  https://github.com/firebase/firebase-ios-sdk

Firebase 인증 라이브러리를 선택합니다.
완료되면 Xcode는 자동으로 백그라운드에서 종속성을 해결하고 다운로드하기 시작합니다.

이제 몇 가지 구성 단계를 수행합니다.

Firebase 콘솔 에서 인증 섹션을 엽니다.
로그인 방법 탭에서 GitHub 공급자를 활성화합니다.
해당 공급자의 개발자 콘솔에서 공급자 구성에 클라이언트 ID 및 클라이언트 암호 를 추가합니다.
1. GitHub에서 앱을 개발자 애플리케이션으로 등록 하고 앱의 OAuth 2.0 클라이언트 ID 및 클라이언트 암호 를 가져옵니다.
2. GitHub 앱 구성의 앱 설정 페이지에서 Firebase OAuth 리디렉션 URI (예: my-app-12345.firebaseapp.com/__/auth/handler )가 승인 콜백 URL 로 설정되어 있는지 확인하세요.
저장 을 클릭합니다.

Firebase SDK로 로그인 흐름 처리

Firebase Apple 플랫폼 SDK로 로그인 흐름을 처리하려면 다음 단계를 따르세요.

Xcode 프로젝트에 사용자 지정 URL 체계를 추가합니다.
1. 프로젝트 구성 열기: 왼쪽 트리 보기에서 프로젝트 이름을 두 번 클릭합니다. 대상 섹션에서 앱 을 선택한 다음 정보 탭을 선택하고 URL 유형 섹션을 확장합니다.
2. + 버튼을 클릭하고 반전된 클라이언트 ID에 대한 URL 체계를 추가합니다. 이 값을 찾으려면 GoogleService-Info.plist 구성 파일을 열고 REVERSED_CLIENT_ID 키를 찾으십시오. 해당 키의 값을 복사하여 구성 페이지의 URL 체계 상자에 붙여넣습니다. 다른 필드는 비워 둡니다.
  완료되면 구성은 다음과 유사하게 표시되어야 합니다(단, 애플리케이션별 값 포함).

공급자 ID github.com 을 사용하여 OAuthProvider 인스턴스를 만듭니다.

빠른

    var provider = OAuthProvider(providerID: "github.com")

목표-C

    FIROAuthProvider *provider = [FIROAuthProvider providerWithProviderID:@"github.com"];

선택사항 : OAuth 요청과 함께 전송하려는 추가 사용자 정의 OAuth 매개변수를 지정하십시오.
빠른
```
    provider.customParameters = [
      "allow_signup": "false"
    ]
    
```
목표-C
```
    [provider setCustomParameters:@{@"allow_signup": @"false"}];
    
```
GitHub에서 지원하는 매개변수는 GitHub OAuth 문서 를 참조하세요. setCustomParameters 로 Firebase 필수 매개변수를 전달할 수 없습니다. 이러한 매개변수는 client_id , redirect_uri , response_type , scope 및 state 입니다.
선택 사항 : 인증 공급자에게 요청하려는 기본 프로필 외에 추가 OAuth 2.0 범위를 지정합니다. 애플리케이션이 GitHub API의 비공개 사용자 데이터에 액세스해야 하는 경우 GitHub 개발자 콘솔의 API 권한 에서 GitHub API에 액세스할 수 있는 권한을 요청해야 합니다. 요청된 OAuth 범위는 앱의 API 권한에 사전 구성된 범위와 정확히 일치해야 합니다.
빠른
```
    // Request read access to a user's email addresses.
    // This must be preconfigured in the app's API permissions.
    provider.scopes = ["user:email"]
    
```
목표-C
```
    // Request read access to a user's email addresses.
    // This must be preconfigured in the app's API permissions.
    [provider setScopes:@[@"user:email"]];
    
```
자세한 내용은 GitHub 범위 문서 를 참조하세요.
선택 사항 : 사용자에게 reCAPTCHA를 표시할 때 앱이 SFSafariViewController 또는 UIWebView 를 표시하는 방식을 사용자 지정하려면 AuthUIDelegate 프로토콜을 준수하는 사용자 지정 클래스를 만들고 이를 credentialWithUIDelegate 에 전달합니다.

OAuth 공급자 개체를 사용하여 Firebase에 인증합니다.

빠른

    provider.getCredentialWith(nil) { credential, error in
      if error != nil {
        // Handle error.
      }
      if credential != nil {
        Auth().signIn(with: credential) { authResult, error in
          if error != nil {
            // Handle error.
          }
          // User is signed in.
          // IdP data available in authResult.additionalUserInfo.profile.

          guard let oauthCredential = authResult.credential as? OAuthCredential else { return }
          // GitHub OAuth access token can also be retrieved by:
          // oauthCredential.accessToken
          // GitHub OAuth ID token can be retrieved by calling:
          // oauthCredential.idToken
        }
      }
    }

목표-C

    [provider getCredentialWithUIDelegate:nil
                               completion:^(FIRAuthCredential *_Nullable credential,
                                            NSError *_Nullable error) {
      if (error) {
       // Handle error.
      }
      if (credential) {
        [[FIRAuth auth] signInWithCredential:credential
                                  completion:^(FIRAuthDataResult *_Nullable authResult,
                                            NSError *_Nullable error) {
          if (error) {
            // Handle error.
          }
          // User is signed in.
          // IdP data available in authResult.additionalUserInfo.profile.

          FIROAuthCredential *oauthCredential = (FIROAuthCredential *)authResult.credential;
          // GitHub OAuth access token can also be retrieved by:
          // oauthCredential.accessToken
          // GitHub OAuth ID token can be retrieved by calling:
          // oauthCredential.idToken
        }];
      }
    }];

OAuth 액세스 토큰을 사용하여 GitHub API 를 호출할 수 있습니다.

예를 들어 기본 프로필 정보를 얻으려면 Authorization 헤더에 액세스 토큰을 전달하여 REST API를 호출할 수 있습니다.

https://api.github.com/user

위의 예는 로그인 흐름에 중점을 두지만 GitHub 공급자를 기존 사용자에 연결할 수도 있습니다. 예를 들어 동일한 사용자에게 여러 공급자를 연결하여 둘 중 하나로 로그인할 수 있습니다.

빠른

    Auth().currentUser.link(withCredential: credential) { authResult, error in
      if error != nil {
        // Handle error.
      }
      // GitHub credential is linked to the current user.
      // IdP data available in authResult.additionalUserInfo.profile.
      // GitHub OAuth access token can also be retrieved by:
      // (authResult.credential as? OAuthCredential)?.accessToken
      // GitHub OAuth ID token can be retrieved by calling:
      // (authResult.credential as? OAuthCredential)?.idToken
    }

목표-C

    [[FIRAuth auth].currentUser
        linkWithCredential:credential
                completion:^(FIRAuthDataResult * _Nullable authResult, NSError * _Nullable error) {
      if (error) {
        // Handle error.
      }
      // GitHub credential is linked to the current user.
      // IdP data available in authResult.additionalUserInfo.profile.
      // GitHub OAuth access token is can also be retrieved by:
      // ((FIROAuthCredential *)authResult.credential).accessToken
      // GitHub OAuth ID token can be retrieved by calling:
      // ((FIROAuthCredential *)authResult.credential).idToken
    }];

최근 로그인이 필요한 중요한 작업에 대한 새로운 자격 증명을 검색하는 데 사용할 수 있는 reauthenticateWithCredential 과 동일한 패턴을 사용할 수 있습니다.

빠른

    Auth().currentUser.reauthenticateWithCredential(withCredential: credential) { authResult, error in
      if error != nil {
        // Handle error.
      }
      // User is re-authenticated with fresh tokens minted and
      // should be able to perform sensitive operations like account
      // deletion and email or password update.
      // IdP data available in result.additionalUserInfo.profile.
      // Additional OAuth access token is can also be retrieved by:
      // (authResult.credential as? OAuthCredential)?.accessToken
      // GitHub OAuth ID token can be retrieved by calling:
      // (authResult.credential as? OAuthCredential)?.idToken
    }

목표-C

    [[FIRAuth auth].currentUser
        reauthenticateWithCredential:credential
                          completion:^(FIRAuthDataResult * _Nullable authResult, NSError * _Nullable error) {
      if (error) {
        // Handle error.
      }
      // User is re-authenticated with fresh tokens minted and
      // should be able to perform sensitive operations like account
      // deletion and email or password update.
      // IdP data available in result.additionalUserInfo.profile.
      // Additional OAuth access token is can also be retrieved by:
      // ((FIROAuthCredential *)authResult.credential).accessToken
      // GitHub OAuth ID token can be retrieved by calling:
      // ((FIROAuthCredential *)authResult.credential).idToken
    }];

자격 증명이 다른 계정 존재 오류 처리

Firebase 콘솔 에서 이메일 주소당 하나의 계정 설정을 활성화한 경우 사용자가 다른 Firebase 사용자의 제공업체(예: Google)에 이미 존재하는 이메일을 사용하여 제공업체(예: GitHub)에 로그인하려고 하면 오류가 발생합니다. FIRAuthErrorCodeAccountExistsWithDifferentCredential 은 임시 FIRAuthCredential 개체(GitHub 자격 증명)와 함께 발생합니다. 원하는 공급자에 대한 로그인을 완료하려면 사용자는 먼저 기존 공급자(Google)에 로그인한 다음 이전 FIRAuthCredential (GitHub 자격 증명)에 연결해야 합니다. 이것은 아래 그림과 같이 보일 것입니다:

빠른

  // Sign-in with an OAuth credential.
  provider.getCredentialWith(nil) { credential, error in
    // An account with the same email already exists.
    if (error as NSError?)?.code == AuthErrorCode.accountExistsWithDifferentCredential.rawValue {
      // Get pending credential and email of existing account.
      let existingAcctEmail = (error! as NSError).userInfo[AuthErrorUserInfoEmailKey] as! String
      let pendingCred = (error! as NSError).userInfo[AuthErrorUserInfoUpdatedCredentialKey] as! AuthCredential
      // Lookup existing account identifier by the email.
      Auth.auth().fetchProviders(forEmail:existingAcctEmail) { providers, error in
        // Existing email/password account.
        if (providers?.contains(EmailAuthProviderID))! {
          // Existing password account for email. Ask user to provide the password of the
          // existing account.
          // Sign in with existing account.
          Auth.auth().signIn(withEmail:existingAcctEmail, password:password) { user, error in
            // Successfully signed in.
            if user != nil {
              // Link pending credential to account.
              Auth.auth().currentUser?.linkAndRetrieveData(with: pendingCred) { result, error in
                // ...
              }
            }
          }
        }
      }
      return
    }

    // Other errors.
    if error != nil {
      // handle the error.
      return
    }

    // Sign in with the credential.
    if credential != nil {
      Auth.auth().signInAndRetrieveData(with: credential!) { result, error in
        if error != nil {
          // handle the error.
          return
        }
      }
    }
  }

목표-C

  // Sign-in with an OAuth credential.
  [provider getCredentialWithUIDelegate:nil
                             completion:^(FIRAuthCredential *_Nullable credential, NSError *_Nullable error) {
    // An account with the same email already exists.
    if (error.code == FIRAuthErrorCodeAccountExistsWithDifferentCredential) {
      // Get pending credential and email of existing account.
      NSString *existingAcctEmail = error.userInfo[FIRAuthErrorUserInfoEmailKey];
      FIRAuthCredential *pendingCred = error.userInfo[FIRAuthErrorUserInfoUpdatedCredentialKey];
      // Lookup existing account identifier by the email.
      [[FIRAuth auth] fetchProvidersForEmail:existingAcctEmail
                                 completion:^(NSArray<NSString *> *_Nullable providers,
                                              NSError *_Nullable error) {
        // Existing email/password account.
        if ( [providers containsObject:FIREmailAuthProviderID] ) {
          // Existing password account for email. Ask user to provide the password of the
          // existing account.

          // Sign in with existing account.
          [[FIRAuth auth] signInWithEmail:existingAcctEmail
                                 password:password
                               completion:^(FIRUser *user, NSError *error) {
            // Successfully signed in.
            if (user) {
              // Link pending credential to account.
              [[FIRAuth auth].currentUser linkWithCredential:pendingCred
                                                  completion:^(FIRUser *_Nullable user,
                                                               NSError *_Nullable error) {
                // ...
              }];
            }
          }];
        }
      }];
      return;
    }

    // Other errors.
    if (error) {
      // handle the error.
      return;
    }

    // Sign in with the credential.
    if (credential) {
      [[FIRAuth auth] signInAndRetrieveDataWithCredential:credential
          completion:^(FIRAuthDataResult *_Nullable authResult,
                       NSError *_Nullable error) {
        if (error) {
          // handle the error.
          return;
        }
      }];
    }
  }];

다음 단계

사용자가 처음으로 로그인하면 새 사용자 계정이 생성되고 사용자가 로그인할 때 사용한 자격 증명(즉, 사용자 이름과 암호, 전화 번호 또는 인증 공급자 정보)에 연결됩니다. 이 새 계정은 Firebase 프로젝트의 일부로 저장되며 사용자 로그인 방법에 관계없이 프로젝트의 모든 앱에서 사용자를 식별하는 데 사용할 수 있습니다.

앱에서 User 개체에서 사용자의 기본 프로필 정보를 가져올 수 있습니다. 사용자 관리 를 참조하십시오.
Firebase 실시간 데이터베이스 및 Cloud Storage 보안 규칙 에서 auth 변수에서 로그인한 사용자의 고유한 사용자 ID를 가져와 사용자가 액세스할 수 있는 데이터를 제어하는 데 사용할 수 있습니다.

인증 공급자 자격 증명을 기존 사용자 계정에 연결하여 사용자가 여러 인증 공급자를 사용하여 앱에 로그인하도록 허용할 수 있습니다.

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

빠른

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

목표-C

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

인증 오류의 전체 범위에 대한 오류 처리 코드를 추가할 수도 있습니다. 오류 처리 를 참조하십시오.