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

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

Identity Platform을 사용한 Firebase 인증으로 업그레이드한 경우 선택한 OpenID Connect(OIDC) 호환 제공업체를 사용하여 Firebase로 사용자를 인증할 수 있습니다. 이를 통해 Firebase에서 기본적으로 지원하지 않는 ID 공급자를 사용할 수 있습니다.

시작하기 전에

OIDC 공급자를 사용하여 사용자를 로그인하려면 먼저 공급자로부터 몇 가지 정보를 수집해야 합니다.

  • 클라이언트 ID : 앱을 식별하는 공급자 고유의 문자열입니다. 공급자는 지원하는 각 플랫폼에 대해 다른 클라이언트 ID를 할당할 수 있습니다. 이것은 공급자가 발급한 ID 토큰의 aud 클레임 값 중 하나입니다.

  • 클라이언트 비밀 : 공급자가 클라이언트 ID의 소유권을 확인하는 데 사용하는 비밀 문자열입니다. 모든 클라이언트 ID에 대해 일치하는 클라이언트 암호가 필요합니다. (이 값은 인증 코드 흐름 을 사용하는 경우에만 필요하며 이는 강력히 권장됩니다.)

  • 발급자 : 공급자를 식별하는 문자열입니다. 이 값은 /.well-known/openid-configuration 과 함께 추가될 때 공급자의 OIDC 검색 문서의 위치인 URL이어야 합니다. 예를 들어 발급자가 https://auth.example.com 인 경우 검색 문서는 https://auth.example.com/.well-known/openid-configuration 에서 사용할 수 있어야 합니다.

위의 정보가 있으면 Firebase 프로젝트의 로그인 공급자로 OpenID Connect를 활성화합니다.

  1. iOS 프로젝트에 Firebase를 추가합니다 .

  2. Identity Platform을 사용한 Firebase 인증으로 업그레이드하지 않았다면 업그레이드하세요. OpenID Connect 인증은 업그레이드된 프로젝트에서만 사용할 수 있습니다.

  3. Firebase 콘솔의 로그인 공급자 페이지에서 새 공급자 추가 를 클릭한 다음 OpenID Connect 를 클릭합니다.

  4. 인증 코드 흐름 을 사용할지 또는 암시적 권한 부여 흐름 을 사용할지 선택합니다.

    공급자가 지원하는 경우 항상 코드 흐름을 사용해야 합니다 . 암시적 흐름은 덜 안전하므로 사용하지 않는 것이 좋습니다.

  5. 이 공급자에 이름을 지정합니다. oidc.example-provider 와 같은 생성된 제공자 ID를 확인하세요. 앱에 로그인 코드를 추가할 때 이 ID가 필요합니다.

  6. 클라이언트 ID와 클라이언트 암호, 공급자의 발급자 문자열을 지정합니다. 이러한 값은 공급자가 할당한 값과 정확히 일치해야 합니다.

  7. 변경 사항을 저장합니다.

Firebase SDK로 로그인 흐름 처리

OIDC 공급자를 사용하여 Firebase로 사용자를 인증하는 가장 쉬운 방법은 Firebase SDK로 전체 로그인 흐름을 처리하는 것입니다.

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

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

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

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

  2. Firebase 콘솔에서 얻은 공급자 ID를 사용하여 OAuthProvider 의 인스턴스를 만듭니다.

    빠른

    var provider = OAuthProvider(providerID: "oidc.example-provider")
    

    오브젝티브-C

    FIROAuthProvider *provider = [FIROAuthProvider providerWithProviderID:@"oidc.example-provider"];
    
  3. 선택 사항 : OAuth 요청과 함께 보낼 추가 사용자 지정 OAuth 매개변수를 지정합니다.

    빠른

    provider.customParameters = [
      "login_hint": "user@example.com"
    ]
    

    오브젝티브-C

    [provider setCustomParameters:@{@"login_hint": @"user@example.com"}];
    

    지원하는 매개변수에 대해서는 공급자에게 문의하십시오. setCustomParameters 를 사용하여 Firebase 필수 매개변수를 전달할 수 없습니다. 이러한 매개변수는 client_id , response_type , redirect_uri , state , scoperesponse_mode 입니다.

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

    빠른

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

    오브젝티브-C

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

    지원하는 범위에 대해서는 공급자에게 문의하십시오.

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

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

    빠른

    // If you created a custom class that conforms to AuthUIDelegate,
    // pass it instead of nil:
    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

    // If you created a custom class that conforms to AuthUIDelegate,
    // pass it instead of nil:
    [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
        }];
      }
    }];
    
  7. 위의 예는 로그인 흐름에 중점을 두고 있지만 linkWithCredential 을 사용하여 linkWithCredential 공급자를 기존 사용자에 연결할 수도 있습니다. 예를 들어 여러 공급자를 동일한 사용자에게 연결하여 둘 중 하나로 로그인하도록 할 수 있습니다.

    빠른

    Auth().currentUser.link(withCredential: credential) { authResult, error in
      if error != nil {
        // Handle error.
      }
      // OIDC 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.
      }
      // OIDC 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
    }];
    

수동으로 로그인 흐름 처리

앱에서 이미 OpenID Connect 로그인 흐름을 구현한 경우 ID 토큰을 직접 사용하여 Firebase에 인증할 수 있습니다.

빠른

let credential = OAuthProvider.credential(
    withProviderID: "oidc.example-provider",  // As registered in Firebase console.
    idToken: idToken,  // ID token from OpenID Connect flow.
    rawNonce: nil
)
Auth.auth().signIn(with: credential) { authResult, error in
    if error {
        // Handle error.
        return
    }
    // User is signed in.
    // IdP data available in authResult?.additionalUserInfo?.profile
}

오브젝티브-C

FIROAuthCredential *credential =
    [FIROAuthProvider credentialWithProviderID:@"oidc.example-provider"  // As registered in Firebase console.
                                       IDToken:idToken  // ID token from OpenID Connect flow.
                                      rawNonce:nil];
[[FIRAuth auth] signInWithCredential:credential
                          completion:^(FIRAuthDataResult * _Nullable authResult,
                                      NSError * _Nullable error) {
    if (error != nil) {
        // Handle error.
        return;
    }
    // User is signed in.
    // IdP data available in authResult.additionalUserInfo.profile
}];

다음 단계

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

  • 앱에서 FIRUser 개체에서 사용자의 기본 프로필 정보를 가져올 수 있습니다. 사용자 관리 를 참조하십시오.

  • 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;
}

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