Autenticati con Firebase su piattaforme Apple utilizzando un sistema di autenticazione personalizzato

Puoi integrare Firebase Authentication con un sistema di autenticazione personalizzato modificando il tuo server di autenticazione in modo da produrre token firmati personalizzati quando un utente accede correttamente. La tua app riceve questo token e lo utilizza per l'autenticazione con Firebase.

Prima di iniziare

Utilizza Swift Package Manager per installare e gestire le dipendenze di Firebase.

Visita la nostra guida all'installazione per conoscere i diversi modi in cui puoi aggiungere SDK Firebase al tuo progetto Apple, inclusa l'importazione diretta di framework e l'utilizzo di CocoaPods.

1. In Xcode, con il progetto dell'app aperto, vai a File > Add Packages .
2. Quando richiesto, aggiungi il repository SDK delle piattaforme Firebase Apple:

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

Nota: i nuovi progetti devono utilizzare la versione SDK predefinita (più recente), ma puoi scegliere una versione precedente se necessario.
3. Scegli la libreria Firebase Authentication.
4. Al termine, Xcode inizierà automaticamente a risolvere e scaricare le tue dipendenze in background.

Quindi, esegui alcuni passaggi di configurazione:

1. Ottieni le chiavi del server del tuo progetto:
   1. Vai alla pagina Account di servizio nelle impostazioni del tuo progetto.
   2. Fai clic su Genera nuova chiave privata nella parte inferiore della sezione Firebase Admin SDK della pagina Account di servizio .
   3. La coppia di chiavi pubblica/privata del nuovo account di servizio viene salvata automaticamente sul tuo computer. Copia questo file sul tuo server di autenticazione.

Autenticazione con Firebase

1. Importa il modulo FirebaseCore nel tuo UIApplicationDelegate , così come qualsiasi altro modulo Firebase utilizzato dal delegato dell'app. Ad esempio, per utilizzare Cloud Firestore e l'autenticazione:

   SwiftUI

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

   Rapido

   import FirebaseCore
   import FirebaseFirestore
   import FirebaseAuth
   // ...
         

   Obiettivo-C

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

2. Configura un'istanza condivisa FirebaseApp nel metodo application(_:didFinishLaunchingWithOptions:) del delegato dell'app:

   SwiftUI

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

   Rapido

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

   Obiettivo-C

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

3. Se utilizzi SwiftUI, devi creare un delegato dell'applicazione e allegarlo alla struttura App tramite UIApplicationDelegateAdaptor o NSApplicationDelegateAdaptor . È inoltre necessario disabilitare lo scorrimento del delegato dell'app. Per ulteriori informazioni, consulta le istruzioni SwiftUI .

   SwiftUI

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

4. Quando gli utenti accedono alla tua app, invia le loro credenziali di accesso (ad esempio nome utente e password) al tuo server di autenticazione. Il tuo server controlla le credenziali e restituisce un token personalizzato se sono valide.
5. Dopo aver ricevuto il token personalizzato dal tuo server di autenticazione, passalo a signInWithCustomToken per accedere all'utente:

   Rapido

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

   Obiettivo-C

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

Prossimi passi

Dopo che un utente ha effettuato l'accesso per la prima volta, viene creato un nuovo account utente e collegato alle credenziali, ovvero nome utente e password, numero di telefono o informazioni sul provider di autenticazione, con cui l'utente ha eseguito l'accesso. Questo nuovo account viene archiviato come parte del tuo progetto Firebase e può essere utilizzato per identificare un utente in ogni app del tuo progetto, indipendentemente da come l'utente accede.

• Nelle tue app puoi ottenere le informazioni di base sul profilo User dall'oggetto Utente. Vedere Gestire gli utenti .

• In Firebase Realtime Database and Cloud Storage Security Rules , puoi ottenere l'ID utente univoco dell'utente che ha eseguito l'accesso dalla variabile auth e utilizzarlo per controllare a quali dati può accedere un utente.

Puoi consentire agli utenti di accedere alla tua app utilizzando più provider di autenticazione collegando le credenziali del provider di autenticazione a un account utente esistente.

Per disconnettere un utente, chiama signOut: .

Rapido

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

Obiettivo-C

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

Potresti anche voler aggiungere il codice di gestione degli errori per l'intera gamma di errori di autenticazione. Vedere Gestione degli errori .