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.
Prompt AI per l'assistenza AI
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.
- In Xcode, con il progetto dell'app aperto, vai a File > Add Packages (File > Aggiungi pacchetti).
- Quando richiesto, aggiungi il repository dell'SDK Firebase per le piattaforme Apple:
- Scegli la libreria Firebase Authentication.
- Aggiungi il flag
-ObjCalla sezione Other Linker Flags (Altri flag del linker) delle impostazioni di build del target. - Al termine, Xcode inizierà automaticamente a risolvere e a scaricare le tue dipendenze in background.
https://github.com/firebase/firebase-ios-sdk.git
Poi, esegui alcuni passaggi di configurazione:
- Se non hai ancora collegato la tua app al progetto Firebase, fallo dalla console Firebase.
-
Attiva Email/Password come provider di accesso per il tuo progetto Firebase:
- Nella console Firebase, vai a Sicurezza > Autenticazione.
- Nella scheda Metodo di accesso, attiva il provider di accesso Email/password.
- 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:
- Importa il modulo
FirebaseCorenel tuoUIApplicationDelegate, 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; // ...
- Configura un'istanza condivisa
FirebaseAppnel metodoapplication(_: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];
- Se utilizzi SwiftUI, devi creare un delegato dell'applicazione e collegarlo alla tua struct
ApptramiteUIApplicationDelegateAdaptoroNSApplicationDelegateAdaptor. 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() } } } }
- 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à.
- Crea un nuovo account passando l'indirizzo email e la password del nuovo utente a
createUser.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.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) { // ... }];
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:
- Importa il modulo
FirebaseCorenel tuoUIApplicationDelegate, 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; // ...
- Configura un'istanza condivisa
FirebaseAppnel metodoapplication(_: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];
- Se utilizzi SwiftUI, devi creare un delegato dell'applicazione e collegarlo alla tua struct
ApptramiteUIApplicationDelegateAdaptoroNSApplicationDelegateAdaptor. 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() } } } }
- Quando un utente accede alla tua app, passa l'indirizzo email e la password dell'utente a
signIn.Se l'utente accede correttamente, puoi ottenere i dati dell'account dell'utente dall'oggetto risultato passato al metodo di callback.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) { // ... }];
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
authe 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.