Authenticate with Firebase on Apple Platforms Using a Custom Authentication System (original) (raw)

You can integrate Firebase Authentication with a custom authentication system by modifying your authentication server to produce custom signed tokens when a user successfully signs in. Your app receives this token and uses it to authenticate with Firebase.

Before you begin

1. Create a Firebase project and register your app if you haven't already.
2. Use Swift Package Manager to install and manage Firebase dependencies.
   1. In Xcode, with your app project open, navigate to File > Add Packages.
   2. When prompted, add the Firebase Apple platforms SDK repository:
      https://github.com/firebase/firebase-ios-sdk.git
   3. Choose the Firebase Authentication library.
   4. Add the -ObjC flag to the Other Linker Flags section of your target's build settings.
   5. When finished, Xcode will automatically begin resolving and downloading your dependencies in the background.
3. Get your project's server keys:
   1. Go to the Service Accounts page in your project's settings.
   2. Click Generate New Private Key at the bottom of the_Firebase Admin SDK_ section of the Service Accounts page.
   3. The new service account's public/private key pair is automatically saved on your computer. Copy this file to your authentication server.
4. Import the FirebaseCore module in yourUIApplicationDelegate, as well as any otherFirebase modules your app delegate uses. For example, to use Cloud Firestore and Authentication:

SwiftUI

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

Swift

import FirebaseCore
import FirebaseFirestore
import FirebaseAuth
// ...

Objective-C

@import FirebaseCore;
@import FirebaseFirestore;
@import FirebaseAuth;
// ... 2. Configure aFirebaseApp shared instance in your app delegate'sapplication(_:didFinishLaunchingWithOptions:) method:

SwiftUI

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

Swift

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

Objective-C

// Use Firebase library to configure APIs
[FIRApp configure]; 3. If you're using SwiftUI, you must create an application delegate and attach it to your App struct via UIApplicationDelegateAdaptor orNSApplicationDelegateAdaptor. You must also disable app delegate swizzling. For more information, see the SwiftUI instructions.

SwiftUI

@main
struct YourApp: App {
// register app delegate for Firebase setup
@UIApplicationDelegateAdaptor(AppDelegate.self) var delegate
var body: some Scene {
WindowGroup {
NavigationView {
ContentView()
}
}
}
} 4. When users sign in to your app, send their sign-in credentials (for example, their username and password) to your authentication server. Your server checks the credentials and returns acustom token if they are valid. 5. After you receive the custom token from your authentication server, pass it to signInWithCustomToken to sign in the user:

Swift

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

Objective-C

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

Next steps

After a user signs in for the first time, a new user account is created and linked to the credentials—that is, the user name and password, phone number, or auth provider information—the user signed in with. This new account is stored as part of your Firebase project, and can be used to identify a user across every app in your project, regardless of how the user signs in.

• In your apps, you can get the user's basic profile information from theUser object. See Manage Users.
• In your Firebase Realtime Database and Cloud Storage Security Rules, you can get the signed-in user's unique user ID from the auth variable, and use it to control what data a user can access.

You can allow users to sign in to your app using multiple authentication providers by linking auth provider credentials to an existing user account.

To sign out a user, call 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; }

You may also want to add error handling code for the full range of authentication errors. See Handle Errors.