Inizia a utilizzare Firebase Authentication su Flutter

Collegare l'app a Firebase

Se non l'hai ancora fatto, installa e inizializza gli SDK Firebase per Flutter Ecco.

Aggiungi Firebase Authentication alla tua app

1. Dalla radice del progetto Flutter, esegui questo comando per installare il plug-in:

   flutter pub add firebase_auth
   

2. Al termine, ricrea l'applicazione Flutter:

   flutter run
   

3. Importa il plug-in nel codice Dart:

   import 'package:firebase_auth/firebase_auth.dart';
   

Per utilizzare un provider di autenticazione, devi attivarlo nella console di Firebase. Vai alla pagina Metodo di accesso nella sezione Firebase Authentication per abilitare l'accesso tramite email/password e qualsiasi altro provider di identità per la tua app.

(Facoltativo) Prototipazione e test con Firebase Local Emulator Suite

Prima di parlare di come la tua app autentica gli utenti, introduciamo un insieme strumenti che puoi utilizzare per prototipare e testare la funzionalità di autenticazione: Firebase Local Emulator Suite. Se stai scegliendo tra tecniche di autenticazione e fornitori, provando diversi modelli di dati con dati pubblici e privati utilizzando le regole di autenticazione e di sicurezza di Firebase o creando un prototipo di design dell'interfaccia utente di accesso, la possibilità di lavorare localmente senza implementare servizi in produzione può essere un'ottima idea.

Un emulatore di autenticazione fa parte di Local Emulator Suite, che consente alla tua app di interagire con la configurazione e i contenuti del database emulati, nonché facoltativamente le risorse di progetto emulate (funzioni, altri database, e regole di sicurezza).

L'utilizzo dell'emulatore di autenticazione prevede solo pochi passaggi:

1. Aggiungere una riga di codice alla configurazione di test dell'app per connettersi all'emulatore.

2. Dalla radice della directory del progetto locale, in esecuzione di firebase emulators:start.

3. Utilizzo dell'interfaccia utente di Local Emulator Suite per la prototipazione interattiva oppure API REST dell'emulatore di autenticazione per test non interattivi.

4. Chiama useAuthEmulator() per specificare l'indirizzo e la porta dell'emulatore:

   Future<void> main() async {
   WidgetsFlutterBinding.ensureInitialized();
   await Firebase.initializeApp();
   
   // Ideal time to initialize
   await FirebaseAuth.instance.useAuthEmulator('localhost', 9099);
   //...
   }
   

Puoi trovare una guida dettagliata nell'articolo Connettere l'app all'emulatore di autenticazione. Per ulteriori informazioni, consulta l'introduzione a Local Emulator Suite.

Ora vediamo come autenticare gli utenti.

Controlla lo stato di autenticazione attuale

Firebase Auth offre molti metodi e utilità per consentirti di integrare l'autenticazione sicura nella tua applicazione Flutter nuova o esistente. In molti casi, dovrai conoscere lo stato di autenticazione dell'utente, ad esempio se hanno effettuato l'accesso o meno.

Firebase Auth consente di abbonarti in tempo reale a questo stato tramite un Stream Una volta chiamato, lo stream fornisce un evento immediato dello stato di autenticazione corrente dell'utente e poi fornisce eventi successivi ogni volta che lo stato di autenticazione cambia.

Esistono tre metodi per ascoltare le modifiche allo stato dell'autenticazione:

authStateChanges()

Per iscriverti a queste modifiche, chiama il metodo authStateChanges() sul tuo Istanza FirebaseAuth:

FirebaseAuth.instance
  .authStateChanges()
  .listen((User? user) {
    if (user == null) {
      print('User is currently signed out!');
    } else {
      print('User is signed in!');
    }
  });

Gli eventi vengono attivati nei seguenti casi:

• Subito dopo la registrazione dell'ascoltatore.
• Quando un utente ha eseguito l'accesso.
• Quando l'utente corrente è disconnesso.

idTokenChanges()

Per iscriverti a queste modifiche, chiama il metodo idTokenChanges() sul tuo Istanza FirebaseAuth:

FirebaseAuth.instance
  .idTokenChanges()
  .listen((User? user) {
    if (user == null) {
      print('User is currently signed out!');
    } else {
      print('User is signed in!');
    }
  });

Gli eventi vengono attivati nei seguenti casi:

• Subito dopo la registrazione dell'ascoltatore.
• Quando un utente ha eseguito l'accesso.
• Quando l'utente corrente è disconnesso.
• Quando viene modificata la token dell'utente corrente.

Se imposti rivendicazioni personalizzate utilizzando l'SDK Firebase Admin, questo evento verrà attivato solo quando si verifica quanto segue:

• Un utente accede o esegue nuovamente l'autenticazione dopo la modifica delle rivendicazioni personalizzate. La Il token ID emesso di conseguenza conterrà le rivendicazioni più recenti.
• Una sessione utente esistente riceve l'aggiornamento del proprio token ID alla scadenza di un token meno recente.
• L'aggiornamento di un token ID viene forzato chiamando FirebaseAuth.instance.currentUser.getIdTokenResult(true).

Per ulteriori dettagli, consulta Propagazione di rivendicazioni personalizzate al client.

userChanges()

Per iscriverti a queste modifiche, chiama il metodo userChanges() sul tuo Istanza FirebaseAuth:

FirebaseAuth.instance
  .userChanges()
  .listen((User? user) {
    if (user == null) {
      print('User is currently signed out!');
    } else {
      print('User is signed in!');
    }
  });

Gli eventi vengono attivati nei seguenti casi:

• Subito dopo la registrazione dell'ascoltatore.
• Quando un utente ha eseguito l'accesso.
• Quando l'utente corrente è disconnesso.
• In caso di modifica del token dell'utente corrente.
• Quando vengono chiamati i seguenti metodi forniti da FirebaseAuth.instance.currentUser:
  • reload()
  • unlink()
  • updateEmail()
  • updatePassword()
  • updatePhoneNumber()
  • updateProfile()

idTokenChanges(), userChanges() e authStateChanges() non si attiverà se aggiorna il profilo User con l'SDK Firebase Admin. Dovrai forzare l'esecuzione ricarica utilizzando FirebaseAuth.instance.currentUser.reload() per recuperare l'ultima versione Profilo User.

idTokenChanges(), userChanges() e Anche authStateChanges() non si attiverà se disattivi o elimini User con l'SDK Admin Firebase o Firebase Google Cloud. Dovrai forzare il ricaricamento utilizzando FirebaseAuth.instance.currentUser.reload(), che comporterà un user-disabled o user-not-found eccezione che puoi rilevare e gestire nel codice dell'app.

Stato di autenticazione permanente

Gli SDK Firebase per tutte le piattaforme offrono un supporto immediato per garantire che lo stato dell'autenticazione dell'utente sia mantenuto dopo i riavvii dell'app o la pagina. vengono ricaricati.

Su piattaforme native come Android e iOS, questo comportamento non è configurabile e lo stato dell'autenticazione dell'utente sarà mantenuto sul dispositivo tra le app si riavvia. L'utente può cancellare i dati delle app memorizzati nella cache utilizzando le impostazioni del dispositivo, che cancellerà qualsiasi stato esistente memorizzato.

Sulle piattaforme web, lo stato dell'autenticazione dell'utente viene memorizzato IndexedDB. Puoi modificare la persistenza per archiviare i dati nello spazio di archiviazione locale utilizzando Persistence.LOCAL. Se necessario, puoi modificare questo comportamento predefinito stato di autenticazione per la sessione corrente o non del tutto. Per configurare questi di chiamata, chiama il seguente metodo FirebaseAuth.instanceFor(app: Firebase.app(), persistence: Persistence.LOCAL);. Puoi comunque aggiornare la persistenza per ogni istanza di Auth utilizzando setPersistence(Persistence.NONE).

// Disable persistence on web platforms. Must be called on initialization:
final auth = FirebaseAuth.instanceFor(app: Firebase.app(), persistence: Persistence.NONE);
// To change it after initialization, use `setPersistence()`:
await auth.setPersistence(Persistence.LOCAL);

Passaggi successivi

Esplora le guide all'accesso e alla registrazione degli utenti con e i servizi di identità e autenticazione.