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

Firebase SDK를 사용하여 웹 기반 일반 OAuth 로그인을 앱에 통합하여 사용자가 Microsoft Azure Active Directory와 같은 OAuth 공급자를 사용하여 Firebase에 인증하도록 할 수 있습니다.

시작하기 전에

Microsoft 계정(Azure Active Directory 및 개인 Microsoft 계정)을 사용하여 사용자를 로그인하려면 먼저 Microsoft를 Firebase 프로젝트의 로그인 공급자로 활성화해야 합니다.

1. Apple 프로젝트에 Firebase를 추가합니다 .
2. Firebase 콘솔 에서 인증 섹션을 엽니다.
3. 로그인 방법 탭에서 Microsoft 공급자를 활성화합니다.
4. 해당 공급자의 개발자 콘솔에서 공급자 구성에 클라이언트 ID 및 클라이언트 암호 를 추가합니다.
   1. Microsoft OAuth 클라이언트를 등록하려면 빠른 시작: Azure Active Directory v2.0 엔드포인트에 앱 등록 의 지침을 따르세요. 이 엔드포인트는 Microsoft 개인 계정과 Azure Active Directory 계정을 사용한 로그인을 지원합니다. Azure Active Directory v2.0에 대해 자세히 알아보세요 .
   2. 이러한 제공업체에 앱을 등록할 때 프로젝트의 *.firebaseapp.com 도메인을 앱의 리디렉션 도메인으로 등록해야 합니다.
5. 저장 을 클릭합니다.

Firebase SDK로 로그인 흐름 처리

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

1. Xcode 프로젝트에 사용자 지정 URL 체계를 추가합니다.

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

      완료되면 구성은 다음과 유사하게 표시되어야 합니다(단, 애플리케이션별 값 포함).

      

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

   빠른

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

   목표-C

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

3. 선택사항 : OAuth 요청과 함께 전송하려는 추가 사용자 정의 OAuth 매개변수를 지정하십시오.

   빠른

       provider.customParameters = [
         "prompt": "consent",
         "login_hint": "[e-mail]"
       ]
       

   목표-C

       [provider setCustomParameters:@{@"prompt": @"consent", @"login_hint": @"[e-mail]"}];
       

   Microsoft에서 지원하는 매개변수는 Microsoft OAuth 설명서 를 참조하십시오. setCustomParameters 로 Firebase 필수 매개변수를 전달할 수 없습니다. 이러한 매개변수는 client_id , response_type , redirect_uri , state , scope 및 response_mode 입니다.

   특정 Azure AD 테넌트의 사용자만 애플리케이션에 로그인하도록 허용하려면 Azure AD 테넌트의 친숙한 도메인 이름이나 테넌트의 GUID 식별자를 사용할 수 있습니다. 이는 사용자 정의 매개변수 개체에 "테넌트" 필드를 지정하여 수행할 수 있습니다.

   빠른

       provider.customParameters = [
         // Optional "tenant" parameter in case you are using an Azure AD
         // tenant. eg. '8eaef023-2b34-4da1-9baa-8bc8c9d6a490' or
         // 'contoso.onmicrosoft.com' or "common" for tenant-independent
         // tokens. The default value is "common".
         "tenant": "TENANT_ID"
       ]
       

   목표-C

       // Optional "tenant" parameter in case you are using an Azure AD tenant.
       // eg. '8eaef023-2b34-4da1-9baa-8bc8c9d6a490' or
       // 'contoso.onmicrosoft.com' or "common" for tenant-independent tokens.
       // The default value is "common".
       provider.customParameters = @{@"tenant": @"TENANT_ID"};
       

4. 선택 사항 : 인증 공급자에게 요청하려는 기본 프로필 외에 추가 OAuth 2.0 범위를 지정합니다.

   빠른

       provider.scopes = ["mail.read", "calendars.read"]
       

   목표-C

       [provider setScopes:@[@"mail.read", @"calendars.read"]];
       

   자세한 내용은 Microsoft 권한 및 동의 문서 를 참조하십시오.

5. 선택 사항 : 사용자에게 reCAPTCHA를 표시할 때 앱이 SFSafariViewController 또는 UIWebView 를 표시하는 방식을 사용자 지정하려면 AuthUIDelegate 프로토콜을 준수하는 사용자 지정 클래스를 만들고 이를 credentialWithUIDelegate 에 전달합니다.

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

   빠른

       // Replace nil with the custom class that conforms to AuthUIDelegate
       // you created in last step to use a customized web view.
       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.
             // OAuth access token can also be retrieved:
             // (authResult.credential as? OAuthCredential)?.accessToken
             // OAuth ID token can also be retrieved:
             // (authResult.credential as? 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.
             // OAuth access token can also be retrieved:
             // ((FIROAuthCredential *)authResult.credential).accessToken
             // OAuth ID token can also be retrieved:
             // ((FIROAuthCredential *)authResult.credential).idToken
           }];
         }
       }];
       

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

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

   https://graph.microsoft.com/v1.0/me
   

   Firebase 인증이 지원하는 다른 공급자와 달리 Microsoft는 사진 URL을 제공하지 않으며 대신 Microsoft Graph API 를 통해 프로필 사진에 대한 이진 데이터를 요청해야 합니다.

   OAuth 액세스 토큰 외에 사용자의 OAuth ID 토큰 도 OAuthCredential 개체에서 검색할 수 있습니다. ID 토큰의 sub 클레임은 앱별로 다르며 Firebase 인증에서 사용하고 user.providerData[0].uid 를 통해 액세스할 수 있는 연합 사용자 식별자와 일치하지 않습니다. 대신 oid 클레임 필드를 사용해야 합니다. Azure AD 테넌트를 사용하여 로그인하는 경우 oid 클레임이 정확히 일치합니다. 그러나 비 테넌트의 경우 oid 필드가 채워집니다. 연합 ID 4b2eabcdefghijkl 의 경우 oid 는 00000000-0000-0000-4b2e-abcdefghijkl 형식을 갖습니다.

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

   빠른

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

   목표-C

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

8. 최근 로그인이 필요한 중요한 작업에 대한 새로운 자격 증명을 검색하는 데 사용할 수 있는 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 can also be retrieved:
         // (authResult.credential as? OAuthCredential)?.accessToken
         // OAuth ID token can also be retrieved:
         // (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 can also be retrieved:
         // ((FIROAuthCredential *)authResult.credential).accessToken
         // OAuth ID token can also be retrieved:
         // ((FIROAuthCredential *)authResult.credential).idToken
       }];
       

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

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

빠른

  // 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;
        }
      }];
    }
  }];
  

고급: 로그인 흐름을 수동으로 처리

OAuth 액세스 토큰 기반 자격 증명으로 직접 로그인할 수 있는 Google, Facebook 및 Twitter와 같이 Firebase에서 지원하는 다른 OAuth 제공업체와 달리 Firebase 인증은 Microsoft와 같은 제공업체에 동일한 기능을 지원하지 않습니다. Microsoft OAuth 액세스 토큰의 대상을 확인하기 위한 Firebase 인증 서버. 이는 중요한 보안 요구 사항이며 한 프로젝트(공격자)에 대해 얻은 Microsoft OAuth 액세스 토큰을 사용하여 다른 프로젝트(피해자)에 로그인할 수 있는 재생 공격에 응용 프로그램 및 웹 사이트를 노출할 수 있습니다. 대신 Firebase Auth는 Firebase 콘솔에 구성된 OAuth 클라이언트 ID 및 암호를 사용하여 전체 OAuth 흐름 및 인증 코드 교환을 처리하는 기능을 제공합니다. 인증 코드는 특정 클라이언트 ID/암호와 함께만 사용할 수 있으므로 한 프로젝트에서 얻은 인증 코드를 다른 프로젝트에서 사용할 수 없습니다.

이러한 공급자를 지원되지 않는 환경에서 사용해야 하는 경우 타사 OAuth 라이브러리 및 Firebase 사용자 지정 인증 을 사용해야 합니다. 전자는 공급자를 인증하는 데 필요하고 후자는 공급자의 자격 증명을 사용자 지정 토큰으로 교환하는 데 필요합니다.

사용자가 처음으로 로그인하면 새 사용자 계정이 생성되고 사용자가 로그인할 때 사용한 자격 증명(즉, 사용자 이름과 암호, 전화 번호 또는 인증 공급자 정보)에 연결됩니다. 이 새 계정은 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;
}

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