Esegui l'autenticazione con Firebase utilizzando account basati su password sulle piattaforme Apple

Puoi utilizzare Firebase Authentication per consentire ai tuoi utenti di autenticarsi con Firebase utilizzando i loro indirizzi email e le loro password e per gestire gli account basati su password della tua app.

Per l'assistenza AI, copia il prompt di seguito nel tuo agente di programmazione AI (come Antigravity, Claude Code, Codex e Cursor). Puoi personalizzare il prompt e ripetere l'operazione con l'agente. Visita la pagina relativa alle skill dell'agente Firebase per informazioni dettagliate sull'installazione.

Help me use Firebase in my app.
1. Make sure that **Firebase agent skills** are installed and updated. For Claude Code, Codex, or Cursor agents, help me install the Firebase plugin. For other agents, run `npx skills add firebase/agent-skills`. Always try to use **Firebase agent skills** for Firebase-related tasks.
2. Help me set up and use Firebase Authentication with email and password authentication in my app.

Prima di iniziare

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

  1. In Xcode, con il progetto dell'app aperto, vai a File > Add Packages (File > Aggiungi pacchetti).
  2. Quando richiesto, aggiungi il repository dell'SDK Firebase per le piattaforme Apple:
  3.   https://github.com/firebase/firebase-ios-sdk.git
  4. Scegli la libreria Firebase Authentication.
  5. Aggiungi il flag -ObjC alla sezione Other Linker Flags (Altri flag del linker) delle impostazioni di build del target.
  6. Al termine, Xcode inizierà automaticamente a risolvere e a scaricare le tue dipendenze in background.

Poi, esegui alcuni passaggi di configurazione:

  1. Se non hai ancora collegato la tua app al progetto Firebase, fallo dalla console Firebase.
  2. Attiva Email/Password come provider di accesso per il tuo progetto Firebase:
    1. Nella console Firebase, vai a Sicurezza > Autenticazione.
    2. Nella scheda Metodo di accesso, attiva il provider di accesso Email/password.
    3. Fai clic su Salva.

Crea un account basato su password

Per creare un nuovo account utente con una password, completa i seguenti passaggi nell'attività di accesso dell'app:

  1. Importa il modulo FirebaseCore nel tuo UIApplicationDelegate, nonché tutti gli altri moduli Firebase utilizzati dal tuo delegato dell'app. 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 tuo 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 swizzling 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 un nuovo utente si registra utilizzando il modulo di registrazione della tua app, completa tutti i passaggi di convalida del nuovo account richiesti dalla tua app, ad esempio verifica che la password del nuovo account sia stata digitata correttamente e soddisfi i requisiti di complessità.
  5. Crea un nuovo account passando l'indirizzo email e la password del nuovo utente a createUser.

    Swift

    Auth.auth().createUser(withEmail: email, password: password) { authResult, error in
      // ...
    }

    Objective-C

    [[FIRAuth auth] createUserWithEmail:email
                               password:password
                             completion:^(FIRAuthDataResult * _Nullable authResult,
                                          NSError * _Nullable error) {
      // ...
    }];
    Se il nuovo account è stato creato correttamente, l'utente ha eseguito l'accesso e puoi ottenere i dati dell'account dell'utente dall'oggetto risultato passato al metodo di callback.

Esegui l'accesso di un utente con un indirizzo email e una password

I passaggi per l'accesso di un utente con una password sono simili a quelli per la creazione di un nuovo account. Nell'attività di accesso dell'app, segui questi passaggi:

  1. Importa il modulo FirebaseCore nel tuo UIApplicationDelegate, nonché tutti gli altri moduli Firebase utilizzati dal tuo delegato dell'app. 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 tuo 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 swizzling 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 un utente accede alla tua app, passa l'indirizzo email e la password dell'utente a signIn.

    Swift

    Auth.auth().signIn(withEmail: email, password: password) { [weak self] authResult, error in
      guard let strongSelf = self else { return }
      // ...
    }

    Objective-C

    [[FIRAuth auth] signInWithEmail:self->_emailField.text
                           password:self->_passwordField.text
                         completion:^(FIRAuthDataResult * _Nullable authResult,
                                      NSError * _Nullable error) {
      // ...
    }];
    Se l'utente accede correttamente, puoi ottenere i dati dell'account dell'utente dall'oggetto risultato passato al metodo di callback.

Consigliato: imposta una policy per le password

Puoi migliorare la sicurezza degli account applicando i requisiti di complessità delle password.

Per configurare una policy per le password per il tuo progetto, apri la sezione Policy per le password nella scheda Sicurezza > Autenticazione > Impostazioni della console Firebase:

Impostazioni di autenticazione

Le policy relative alle password di Firebase Authentication supportano i seguenti requisiti per le password:

  • È richiesto un carattere minuscolo

  • È richiesto un carattere maiuscolo

  • Carattere numerico obbligatorio

  • Carattere non alfanumerico obbligatorio

    I seguenti caratteri soddisfano il requisito dei caratteri non alfanumerici: ^ $ * . [ ] { } ( ) ? " ! @ # % & / \ , > < ' : ; | _ ~

  • Lunghezza minima della password (da 6 a 30 caratteri; il valore predefinito è 6)

  • Lunghezza massima della password (lunghezza massima di 4096 caratteri)

Puoi attivare l'applicazione forzata delle policy relative alle password in due modalità:

  • Richiedi: i tentativi di registrazione non vanno a buon fine finché l'utente non aggiorna una password conforme alle policy.

  • Invia notifica: gli utenti possono registrarsi con una password non conforme. Quando utilizzi questa modalità, devi verificare se la password dell'utente è conforme alla policy sul lato client e, in caso contrario, chiedere all'utente di aggiornarla.

I nuovi utenti devono sempre scegliere una password conforme alle tue norme.

Se hai utenti attivi, ti consigliamo di non attivare l'upgrade forzato all'accesso, a meno che tu non intenda bloccare l'accesso agli utenti le cui password non rispettano la policy. Utilizza invece la modalità di notifica, che consente agli utenti di accedere con le loro password attuali e li informa dei requisiti che la loro password non soddisfa.

Consigliato: attiva la protezione da enumerazione email

Alcuni metodi Firebase Authentication che accettano indirizzi email come parametri generano errori specifici se l'indirizzo email non è registrato quando deve esserlo (ad esempio, quando accedi con un indirizzo email e una password) o se è registrato quando non deve essere utilizzato (ad esempio, quando modifichi l'indirizzo email di un utente). Sebbene ciò possa essere utile per suggerire rimedi specifici agli utenti, può anche essere utilizzato in modo improprio da malintenzionati per scoprire gli indirizzi email registrati dai tuoi utenti.

Per mitigare questo rischio, ti consigliamo di assicurarti che la protezione dall'enumerazione email sia abilitata per il tuo progetto. Puoi controllare questa impostazione nella console Firebase: vai alla scheda Sicurezza > Autenticazione > Impostazioni, quindi fai clic su Azioni utente.

Tieni presente che l'attivazione di questa funzionalità modifica il comportamento di Error Reporting per Firebase Authentication, quindi assicurati che la tua app non si basi su errori più specifici.

Passaggi successivi

Dopo il primo accesso di un utente, viene creato un nuovo account utente e collegato alle credenziali, ovvero nome utente e password, numero di telefono o informazioni del 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 progetto, indipendentemente dalla modalità di accesso dell'utente.

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

  • Nelle regole di sicurezza di Firebase Realtime Database e Cloud Storage, puoi ottenere l'ID utente univoco dell'utente che ha eseguito l'accesso dalla variabile auth e utilizzarlo per controllare i dati a cui un utente può accedere.

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:.

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;
}

Potresti anche voler aggiungere un codice di gestione degli errori per l'intera gamma di errori di autenticazione. Consulta Gestisci gli errori.