Questa pagina è stata tradotta dall'API Cloud Translation.

Gestisci gli utenti in Firebase

Crea un utente

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

Chiama il metodo createUserWithEmailAndPassword().
Eseguire il primo accesso di un utente utilizzando un provider di identità federato. come Accedi con Google, Accedi a Facebook o Apple.

Puoi anche creare nuovi utenti con autenticazione basata su password dal menu della console di Firebase, nella pagina Utenti.

Recuperare il profilo di un utente

Per ottenere le informazioni del profilo di un utente, utilizza le proprietà di User. Esistono tre modi per ottenere un oggetto User che rappresenti l'utente corrente:

Gli stream authStateChanges, idTokenChanges e userChanges: gli ascoltatori riceveranno l'attuale User o null se nessun utente autenticati:
```
FirebaseAuth.instance
  .authStateChanges()
  .listen((User? user) {
    if (user != null) {
      print(user.uid);
    }
  });
```
All'avvio dell'app, viene attivato un evento dopo le eventuali credenziali utente da l'archiviazione locale siano state ripristinate, il che significa che gli ascoltatori potranno sempre quando lo stato utente viene inizializzato. Ogni volta che lo stato di autenticazione cambia, viene generato un nuovo evento con lo stato utente aggiornato.

Monitorando lo stato dell'autenticazione, puoi creare un'interfaccia utente reagisce a queste modifiche nello stato dell'autenticazione.

L'oggetto UserCredential restituito dall'autenticazione (signIn-) metodi: l'oggetto UserCredential ha una proprietà user con il valore User:

final userCredential =
    await FirebaseAuth.instance.signInWithCredential(credential);
final user = userCredential.user;
print(user?.uid);

La proprietà currentUser dell'istanza FirebaseAuth: se hai la certezza che l'utente ha eseguito l'accesso, puoi accedere a User dalla proprietà currentUser:
```
if (FirebaseAuth.instance.currentUser != null) {
  print(FirebaseAuth.instance.currentUser?.uid);
}
```
currentUser può essere null per due motivi:
- L'utente non ha eseguito l'accesso.
- L'inizializzazione dell'oggetto auth non è stata terminata. Se utilizzi un listener per mantenere tenere traccia dello stato di accesso dell'utente, non è necessario gestire questo caso.

Ottenere le informazioni del profilo specifiche del fornitore di un utente

Per ottenere le informazioni del profilo recuperate dai fornitori di servizi di accesso collegati a un utente, utilizza la proprietà providerData. Ad 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;
    }
}

Aggiornare il profilo di un utente

Puoi aggiornare le informazioni di base del profilo di un utente, ovvero il nome visualizzato e l'URL della foto del profilo, con i metodi update. Ad esempio:

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

Impostare l'indirizzo email di un utente

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

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

Inviare a un utente un'email di verifica

Puoi inviare un'email di verifica dell'indirizzo a un utente con il metodo sendEmailVerification(). Ad esempio:

await user?.sendEmailVerification();

Puoi personalizzare il modello email utilizzato nella sezione Autenticazione di nella console di Firebase, nella pagina Modelli email. Vedi Modelli email in Centro assistenza Firebase.

È anche possibile passare lo stato tramite Continua URL per eseguire il reindirizzamento. all'app quando invii un'email di verifica.

Puoi anche localizzare l'email di verifica aggiornandone la lingua sull'istanza Auth prima di inviare l'email. Ad esempio:

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

Impostare la password di un utente

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

await user?.updatePassword(newPassword);

Invia un'email di reimpostazione della password

Puoi inviare un'email per reimpostare la password a un utente con il metodo sendPasswordResetEmail(). Ad esempio:

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

Puoi personalizzare il modello email utilizzato nella sezione Autenticazione di nella console di Firebase, nella pagina Modelli email. Vedi Modelli email in Centro assistenza Firebase.

È anche possibile passare lo stato tramite un URL di continuazione per reindirizzare nuovamente all'app quando viene inviata un'email di reimpostazione password.

Inoltre, puoi localizzare l'email di reimpostazione della password aggiornando la lingua sull'istanza Auth prima di inviare l'email. Ad esempio:

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

Puoi anche inviare email di reimpostazione della password dalla console Firebase.

Eliminare un utente

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

await user?.delete();

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

Nuova autenticazione di un utente

Alcune azioni sensibili per la sicurezza, come l'eliminazione di un account, l'impostazione di un indirizzo email principale e la modifica di una password, richiedono che l'utente abbia effettuato l'accesso di recente. Se esegui una di queste azioni e l'utente ha eseguito l'accesso troppo tempo fa, l'azione non va a buon fine e viene generato un FirebaseAuthException con il codice requires-recent-login. In questo caso, esegui nuovamente l'autenticazione dell'utente ricevendo nuove credenziali di accesso. dall'utente e passando le credenziali a reauthenticate. Ad 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 la proprietà Comando auth:import dell'interfaccia a riga di comando di Firebase. Ad esempio:

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