在 iOS 上使用 GitHub 进行身份验证

您可以将 GitHub 身份验证集成到您的应用中,让您的用户可使用自己的 GitHub 帐号进行 Firebase 身份验证。

通过身份验证后,用户即可访问 Firebase 实时数据库和 Cloud Storage 中仅限用户访问的数据。

开始之前

  1. 将 Firebase 添加到您的 iOS 项目。在您的 Podfile 中添加以下 pod:
    pod 'Firebase/Auth'
    
  2. 在 GitHub 上将您的应用注册为开发者应用,并获取您的应用的 OAuth 2.0 客户端 ID客户端密钥
  3. 启用 GitHub 身份验证:
    1. Firebase 控制台中,打开 Auth(身份验证)部分。
    2. 登录方法标签上,启用 GitHub 登录方法,并指定您之前从 GitHub 获得的 OAuth 2.0 客户端 ID客户端密钥
    3. 然后,请务必转到您的 GitHub 应用配置,在您的应用的设置页面中,将 Firebase OAuth 重定向 URI(例如 my-app-12345.firebaseapp.com/__/auth/handler)设为您的授权回调网址

进行 Firebase 身份验证

  1. 开发者文档中的说明操作,将 GitHub 身份验证集成到您的应用中。使用网络应用流程,并在您的应用中设置自定义网址架构,以处理来自 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: 的实现代码中用从 GitHub 获取的 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 安全规则中,您可以从 auth 变量获取已登录用户的唯一用户 ID,然后用此 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;
}

您可能还需要添加适用于所有身份验证错误的错误处理代码。请参阅处理错误

发送以下问题的反馈:

此网页
需要帮助?请访问我们的支持页面