Google은 흑인 공동체를 위한 인종적 평등을 추구하기 위해 노력하고 있습니다. 자세히 알아보기

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": "user@firstadd.onmicrosoft.com"
        ]
        

    목표-C

        [provider setCustomParameters:@{@"prompt": @"consent", @"login_hint": @"user@firstadd.onmicrosoft.com"}];
        

    Microsoft에서 지원하는 매개변수는 Microsoft OAuth 설명서 를 참조하십시오. setCustomParameters 로 Firebase 필수 매개변수를 전달할 수 없습니다. 이러한 매개변수는 client_id , response_type , redirect_uri , state , scoperesponse_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 의 경우 oid00000000-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 프로젝트의 일부로 저장되며 사용자 로그인 방법에 관계없이 프로젝트의 모든 앱에서 사용자를 식별하는 데 사용할 수 있습니다.

  • 앱에서 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;
}

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