查看 2022 年 Google I/O 大会上介绍的 Firebase 新动态。了解详情

Gestisci gli utenti in Firebase

Crea un utente

Puoi creare un nuovo utente nel tuo progetto Firebase in quattro modi:

  • Chiama il metodo createUserWithEmailAndPassword() .
  • Accedi per la prima volta a un utente utilizzando un provider di identità federato , come Google Sign-In, Facebook Login o Apple.

Puoi anche creare nuovi utenti autenticati con password dalla sezione Autenticazione della console Firebase , nella pagina Utenti.

Ottieni il profilo di un utente

Per ottenere le informazioni sul profilo di un utente, utilizzare le proprietà di User . Esistono tre modi per ottenere un oggetto User che rappresenta l'utente corrente:

  • I authStateChanges , idTokenChanges e userChanges : i tuoi ascoltatori riceveranno l' User corrente o null se nessun utente è autenticato:

    FirebaseAuth.instance
      .authStateChanges()
      .listen((User? user) {
        if (user != null) {
          print(user.uid);
        }
      });
    

    All'avvio dell'app, un evento viene attivato dopo il ripristino delle credenziali utente (se presenti) dall'archivio locale, il che significa che i listener vengono sempre chiamati quando viene inizializzato lo stato utente. Quindi, ogni volta che lo stato di autenticazione cambia, verrà generato un nuovo evento con lo stato utente aggiornato.

    Ascoltando lo stato di autenticazione, puoi creare un'interfaccia utente che reagisca a questi cambiamenti nello stato di autenticazione.

  • L'oggetto UserCredential restituito dai metodi di autenticazione ( signIn -): l'oggetto UserCredential ha una proprietà user con l' User corrente:

    final userCredential =
        await FirebaseAuth.instance.signInWithCredential(credential);
    final user = userCredential.user;
    print(user?.uid);
    
  • La proprietà currentUser dell'istanza FirebaseAuth : se sei sicuro che l'utente sia attualmente connesso, puoi accedere User dalla proprietà currentUser :

    if (FirebaseAuth.instance.currentUser != null) {
      print(FirebaseAuth.instance.currentUser?.uid);
    }
    

    Il currentUser può essere null per due motivi:

    • L'utente non ha eseguito l'accesso.
    • L'oggetto auth non ha terminato l'inizializzazione. Se usi un listener per tenere traccia dello stato di accesso dell'utente, non devi gestire questo caso.

Ottieni le informazioni sul profilo specifico del provider di un utente

Per ottenere le informazioni sul profilo recuperate dai provider di accesso collegati a un utente, utilizzare la proprietà providerData . Per esempio:

if (user != null) {
    for (final providerProfile in user.providerData) {
        // ID of the provider (google.com, apple.com, etc.)
        final provider = providerProfile.providerId;

        // UID specific to the provider
        final uid = providerProfile.uid;

        // Name, email address, and profile photo URL
        final name = providerProfile.displayName;
        final emailAddress = providerProfile.email;
        final profilePhoto = providerProfile.photoURL;
    }
}

Aggiorna il profilo di un utente

È possibile aggiornare le informazioni di base del profilo di un utente, il nome visualizzato dell'utente e l'URL della foto del profilo, con i metodi di update . Per esempio:

await user?.updateDisplayName("Jane Q. User");
await user?.updatePhotoURL("https://example.com/jane-q-user/profile.jpg");

Imposta l'indirizzo email di un utente

Puoi impostare l'indirizzo email di un utente con il metodo updateEmail() . Per esempio:

await user?.updateEmail("janeq@example.com");

Invia a un utente un'e-mail di verifica

Puoi inviare un'e-mail di verifica dell'indirizzo a un utente con il metodo sendEmailVerification() . Per esempio:

await user?.sendEmailVerification();

Puoi personalizzare il modello e-mail utilizzato nella sezione Autenticazione della console Firebase , nella pagina Modelli e-mail. Vedi Modelli e-mail nel Centro assistenza di Firebase.

È anche possibile passare lo stato tramite un URL continua per reindirizzare all'app quando si invia un'e-mail di verifica.

Inoltre, puoi localizzare l'e-mail di verifica aggiornando il codice della lingua sull'istanza Auth prima di inviare l'e-mail. Per esempio:

await FirebaseAuth.instance.setLanguageCode("fr");
await user?.sendEmailVerification();

Imposta la password di un utente

Puoi impostare la password di un utente con il metodo updatePassword() . Per esempio:

await user?.updatePassword(newPassword);

Invia un'e-mail di reimpostazione della password

Puoi inviare un'e-mail di reimpostazione della password a un utente con il metodo sendPasswordResetEmail() . Per esempio:

await FirebaseAuth.instance
    .sendPasswordResetEmail(email: "user@example.com");

Puoi personalizzare il modello e-mail utilizzato nella sezione Autenticazione della console Firebase , nella pagina Modelli e-mail. Vedi Modelli e-mail nel Centro assistenza di Firebase.

È anche possibile passare lo stato tramite un URL continua per reindirizzare all'app quando si invia un'e-mail di reimpostazione della password.

Inoltre, puoi localizzare l'e-mail di reimpostazione della password aggiornando il codice della lingua sull'istanza Auth prima di inviare l'e-mail. Per esempio:

await FirebaseAuth.instance.setLanguageCode("fr");

Puoi anche inviare e-mail di reimpostazione della password dalla console Firebase.

Elimina un utente

Puoi eliminare un account utente con il metodo delete() . Per esempio:

await user?.delete();

Puoi anche eliminare utenti dalla sezione Autenticazione della console Firebase , nella pagina Utenti.

Riautenticare un utente

Alcune azioni sensibili alla sicurezza, come l' eliminazione di un account , l'impostazione di un indirizzo e-mail principale e la modifica di una password , richiedono che l'utente abbia eseguito l'accesso di recente. Se esegui una di queste azioni e l'utente ha eseguito l'accesso troppo tempo fa, il action non riesce e genera FirebaseAuthException con il codice requires-recent-login . Quando ciò si verifica, autentica nuovamente l'utente ottenendo nuove credenziali di accesso dall'utente e passando le credenziali per reauthenticate . Per esempio:

// Prompt the user to re-provide their sign-in credentials.
// Then, use the credentials to reauthenticate:
await user?.reauthenticateWithCredential(credential);

Importa account utente

Puoi importare account utente da un file nel tuo progetto Firebase utilizzando il comando auth:import della CLI Firebase. Per esempio:

firebase auth:import users.json --hash-algo=scrypt --rounds=8 --mem-cost=14