Gestisci gli utenti in Firebase

Crea un utente

Puoi creare un nuovo utente nel tuo progetto Firebase chiamando il metodo createUser o accedendo per la prima volta con un provider di identità federato, come Accedi con Google o Accedi con Facebook.

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

Recupera l'utente che ha eseguito l'accesso

Il modo consigliato per ottenere l'utente corrente è impostare un listener nella Oggetto Auth:

Swift

handle = Auth.auth().addStateDidChangeListener { auth, user in
  // ...
}

Objective-C

self.handle = [[FIRAuth auth]
    addAuthStateDidChangeListener:^(FIRAuth *_Nonnull auth, FIRUser *_Nullable user) {
      // ...
    }];

Con l'utilizzo di un listener, ti assicuri che l'oggetto Auth non si trovi in una posizione intermedia ad esempio l'inizializzazione, quando ottieni l'utente corrente.

Puoi anche recuperare l'utente che ha eseguito l'accesso utilizzando la proprietà currentUser. Se un utente non ha eseguito l'accesso, currentUser è nullo:

Swift

if Auth.auth().currentUser != nil {
  // User is signed in.
  // ...
} else {
  // No user is signed in.
  // ...
}

Objective-C

if ([FIRAuth auth].currentUser) {
  // User is signed in.
  // ...
} else {
  // No user is signed in.
  // ...
}

Recuperare il profilo di un utente

Per ottenere le informazioni del profilo di un utente, utilizza le proprietà di un'istanza di FIRUser. Ad esempio:

Swift

let user = Auth.auth().currentUser
if let user = user {
  // The user's ID, unique to the Firebase project.
  // Do NOT use this value to authenticate with your backend server,
  // if you have one. Use getTokenWithCompletion:completion: instead.
  let uid = user.uid
  let email = user.email
  let photoURL = user.photoURL
  var multiFactorString = "MultiFactor: "
  for info in user.multiFactor.enrolledFactors {
    multiFactorString += info.displayName ?? "[DispayName]"
    multiFactorString += " "
  }
  // ...
}

Objective-C

FIRUser *user = [FIRAuth auth].currentUser;
if (user) {
  // The user's ID, unique to the Firebase project.
  // Do NOT use this value to authenticate with your backend server,
  // if you have one. Use getTokenWithCompletion:completion: instead.
  NSString *email = user.email;
  NSString *uid = user.uid;
  NSMutableString *multiFactorString = [NSMutableString stringWithFormat:@"MultiFactor: "];
  for (FIRMultiFactorInfo *info in user.multiFactor.enrolledFactors) {
    [multiFactorString appendString:info.displayName];
    [multiFactorString appendString:@" "];
  }
  NSURL *photoURL = user.photoURL;
  // ...
}

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

Swift

let userInfo = Auth.auth().currentUser?.providerData[indexPath.row]
cell?.textLabel?.text = userInfo?.providerID
// Provider-specific UID
cell?.detailTextLabel?.text = userInfo?.uid

Objective-C

id<FIRUserInfo> userInfo = [FIRAuth auth].currentUser.providerData[indexPath.row];
cell.textLabel.text = [userInfo providerID];
// Provider-specific UID
cell.detailTextLabel.text = [userInfo uid];

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 la classe UserProfileChangeRequest. Ad esempio:

Swift

let changeRequest = Auth.auth().currentUser?.createProfileChangeRequest()
changeRequest?.displayName = displayName
changeRequest?.commitChanges { error in
  // ...
}

Objective-C

FIRUserProfileChangeRequest *changeRequest = [[FIRAuth auth].currentUser profileChangeRequest];
changeRequest.displayName = userInput;
[changeRequest commitChangesWithCompletion:^(NSError *_Nullable error) {
  // ...
}];

Impostare l'indirizzo email di un utente

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

Swift

Auth.auth().currentUser?.updateEmail(to: email) { error in
  // ...
}

Objective-C

[[FIRAuth auth].currentUser updateEmail:userInput completion:^(NSError *_Nullable error) {
  // ...
}];

Inviare a un utente un'email di verifica

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

Swift

Auth.auth().currentUser?.sendEmailVerification { error in
  // ...
}

Objective-C

[[FIRAuth auth].currentUser sendEmailVerificationWithCompletion:^(NSError *_Nullable error) {
  // ...
}];

Puoi personalizzare il modello email utilizzato nella sezione Autenticazione della console Firebase nella pagina Modelli email. Consulta la sezione Modelli email nel Centro assistenza Firebase.

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

Inoltre, puoi localizzare l'email di verifica aggiornando il codice lingua sull'istanza Auth prima di inviare l'email. Ad esempio:

Swift

Auth.auth().languageCode = "fr"
// To apply the default app language instead of explicitly setting it.
// Auth.auth().useAppLanguage()

Objective-C

[FIRAuth auth].languageCode = @"fr";
// To apply the default app language instead of explicitly setting it.
// [[FIRAuth auth] useAppLanguage];

Impostare la password di un utente

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

Swift

Auth.auth().currentUser?.updatePassword(to: password) { error in
  // ...
}

Objective-C

[[FIRAuth auth].currentUser updatePassword:userInput completion:^(NSError *_Nullable error) {
  // ...
}];

Invia un'email di reimpostazione della password

Puoi inviare un'email per reimpostare la password a un utente con il metodosendPasswordReset. Ad esempio:

Swift

Auth.auth().sendPasswordReset(withEmail: email) { error in
  // ...
}

Objective-C

[[FIRAuth auth] sendPasswordResetWithEmail:userInput completion:^(NSError *_Nullable error) {
  // ...
}];

Puoi personalizzare il modello email utilizzato nella sezione Autenticazione di Nella pagina Modelli email della console Firebase. 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 reimpostazione della password.

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

Swift

Auth.auth().languageCode = "fr"
// To apply the default app language instead of explicitly setting it.
// Auth.auth().useAppLanguage()

Objective-C

[FIRAuth auth].languageCode = @"fr";
// To apply the default app language instead of explicitly setting it.
// [[FIRAuth auth] useAppLanguage];

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:

Swift

let user = Auth.auth().currentUser

user?.delete { error in
  if let error = error {
    // An error happened.
  } else {
    // Account deleted.
  }
}

Objective-C

FIRUser *user = [FIRAuth auth].currentUser;

[user deleteWithCompletion:^(NSError *_Nullable error) {
  if (error) {
    // An error happened.
  } else {
    // Account deleted.
  }
}];

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

Ri-autenticare 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 con FIRAuthErrorCodeCredentialTooOld . In questo caso, esegui nuovamente l'autenticazione dell'utente ottenendo un nuovo accesso. credenziali dell'utente e passandole a reauthenticate. Ad esempio:

Swift

let user = Auth.auth().currentUser
var credential: AuthCredential

// Prompt the user to re-provide their sign-in credentials

user?.reauthenticate(with: credential) { error in
  if let error = error {
    // An error happened.
  } else {
    // User re-authenticated.
  }
}

Objective-C

FIRUser *user = [FIRAuth auth].currentUser;
FIRAuthCredential *credential;

// Prompt the user to re-provide their sign-in credentials

[user reauthenticateWithCredential:credential completion:^(NSError *_Nullable error) {
  if (error) {
    // An error happened.
  } else {
    // User re-authenticated.
  }
}];

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