Eseguire l'autenticazione con Firebase sulle piattaforme Apple utilizzando un sistema di autenticazione personalizzato

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

Prima di iniziare

1. Crea un progetto Firebase e registra la tua app se non l'hai ancora fatto.

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

   Consulta la nostra guida all'installazione per scoprire i diversi modi in cui puoi aggiungere gli SDK Firebase al tuo progetto Apple, tra cui l'importazione diretta dei framework e l'utilizzo di CocoaPods.
   1. In Xcode, con il progetto dell'app aperto, vai a File > Aggiungi pacchetti.
   2. Quando richiesto, aggiungi il repository dell'SDK delle piattaforme Apple di Firebase:

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

   Nota: i nuovi progetti devono utilizzare la versione predefinita (più recente) dell'SDK, ma se necessario puoi scegliere una versione precedente.
   3. Scegli la raccolta Firebase Authentication.
   4. Aggiungi il flag -ObjC alla sezione Altri flag del linker delle impostazioni di compilazione del target.
   5. Al termine, Xcode inizierà automaticamente a risolvere e a scaricare le tue dipendenze in background.
3. Recupera le chiavi del server del tuo progetto:
   1. Vai alla pagina Account di servizio nelle impostazioni del progetto.
   2. Fai clic su Genera nuova chiave privata nella parte inferiore della sezione SDK Firebase Admin della pagina Account di servizio.
   3. La coppia di chiavi pubblica/privata del nuovo account di servizio viene salvata automaticamente sul computer. Copia questo file sul server di autenticazione.

Esegui l'autenticazione con Firebase

1. Importa il modulo FirebaseCore in UIApplicationDelegate, nonché eventuali altri moduli Firebase utilizzati dal tuo app delegate. Ad esempio, per utilizzare Cloud Firestore e 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. Configura un'istanza condivisa FirebaseApp nel metodo application(_:didFinishLaunchingWithOptions:) del delegato dell'app:

   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. Se utilizzi SwiftUI, devi creare un delegato dell'applicazione e collegarlo alla tua struct App tramite UIApplicationDelegateAdaptor o NSApplicationDelegateAdaptor. Devi anche disattivare lo scambio del delegato dell'app. Per maggiori informazioni, consulta le istruzioni di 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 es. nome utente e password) al tuo server di autenticazione. Il server controlla le credenziali e restituisce un token personalizzato se sono valide.
5. Dopo aver ricevuto il token personalizzato dal server di autenticazione, trasmettelo a signInWithCustomToken per far accedere l'utente:

   Swift

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

   Objective-C

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

Passaggi successivi

Dopo che un utente ha eseguito 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 del fornitore di autenticazione, con cui l'utente ha eseguito l'accesso. Questo nuovo account viene archiviato nel tuo progetto Firebase e può essere utilizzato per identificare un utente in tutte le app del progetto, indipendentemente da come accede.

• Nelle tue app, puoi ottenere le informazioni di base del profilo dell'utente dall'oggetto User . Vedi Gestire gli utenti.

• Nelle Regole di sicurezza Firebase Realtime Database e Cloud Storage, puoi recuperare 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 far uscire un utente, chiama 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;
}

Ti consigliamo inoltre di aggiungere il codice di gestione degli errori per l'intera gamma di errori di autenticazione. Consulta la sezione Gestire gli errori.