使用自訂身份驗證系統在 Apple 平台上透過 Firebase 進行身份驗證

在你開始之前

使用 Swift Package Manager 安裝和管理 Firebase 相依性。

1. 在 Xcode 中，開啟應用程式項目，導覽至File > Add Packages 。
2. 出現提示時，新增 Firebase Apple 平台 SDK 儲存庫：

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

3. 選擇 Firebase 身份驗證庫。
4. 將-ObjC標誌新增至目標建置設定的「其他連結器標誌」部分。
5. 完成後，Xcode 將自動開始在背景解析並下載您的依賴項。

接下來，執行一些設定步驟：

1. 取得項目的伺服器金鑰：
   1. 前往項目設定中的服務帳戶頁面。
   2. 點選服務帳戶頁面Firebase Admin SDK部分底部的產生新私鑰。
   3. 新服務帳戶的公鑰/私鑰對會自動儲存在您的電腦上。將此文件複製到您的身份驗證伺服器。

使用 Firebase 進行身份驗證

1. 在UIApplicationDelegate中導入FirebaseCore模組，以及應用程式委託使用的任何其他Firebase 模組。例如，要使用 Cloud Firestore 和身份驗證：

   斯威夫特使用者介面

   import SwiftUI
   import FirebaseCore
   import FirebaseFirestore
   import FirebaseAuth
   // ...
         

   迅速

   import FirebaseCore
   import FirebaseFirestore
   import FirebaseAuth
   // ...
         

   Objective-C

   @import FirebaseCore;
   @import FirebaseFirestore;
   @import FirebaseAuth;
   // ...
         

2. 在應用程式委託的application(_:didFinishLaunchingWithOptions:)方法中設定FirebaseApp共享實例：

   斯威夫特使用者介面

   // Use Firebase library to configure APIs
   FirebaseApp.configure()

   迅速

   // Use Firebase library to configure APIs
   FirebaseApp.configure()

   Objective-C

   // Use Firebase library to configure APIs
   [FIRApp configure];

3. 如果您使用 SwiftUI，則必須建立應用程式委託並透過UIApplicationDelegateAdaptor或NSApplicationDelegateAdaptor將其附加到您的App結構。您還必須停用應用程式委託調配。有關更多信息，請參閱SwiftUI 說明。

   斯威夫特使用者介面

   @main
   struct YourApp: App {
     // register app delegate for Firebase setup
     @UIApplicationDelegateAdaptor(AppDelegate.self) var delegate
   
     var body: some Scene {
       WindowGroup {
         NavigationView {
           ContentView()
         }
       }
     }
   }
         

4. 當使用者登入您的應用程式時，將他們的登入憑證（例如使用者名稱和密碼）發送到您的身份驗證伺服器。您的伺服器檢查憑證並傳回自訂令牌（如果它們有效）。
5. 從身份驗證伺服器收到自訂令牌後，將其傳遞給signInWithCustomToken以登入使用者：

   迅速

   Auth.auth().signIn(withCustomToken: customToken ?? "") { user, error in
     // ...
   }

   Objective-C

   [[FIRAuth auth] signInWithCustomToken:customToken
                              completion:^(FIRAuthDataResult * _Nullable authResult,
                                           NSError * _Nullable error) {
     // ...
   }];

下一步

使用者首次登入後，系統會建立新的使用者帳戶，並將其連結到使用者登入時所使用的憑證（即使用者名稱和密碼、電話號碼或驗證提供者資訊）。此新帳戶將作為 Firebase 專案的一部分存儲，並且可用於識別專案中每個應用程式中的用戶，無論用戶如何登入。

• 在您的應用程式中，您可以從User物件取得使用者的基本個人資料資訊。請參閱管理用戶。

• 在 Firebase 即時資料庫和雲端儲存安全性規則中，您可以從auth變數取得登入使用者的唯一使用者 ID，並使用它來控制使用者可以存取哪些資料。

您可以透過將身分驗證提供者憑證連結到現有使用者帳戶，允許使用者使用多個驗證提供者登入您的應用程式。

若要登出用戶，請呼叫signOut:

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

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

您可能還需要為所有身份驗證錯誤新增錯誤處理代碼。請參閱處理錯誤。