Inizia a utilizzare Firebase Authentication sulle piattaforme Apple

Puoi utilizzare Firebase Authentication per consentire agli utenti di accedere alla tua app utilizzando uno o più metodi di accesso, tra cui l'accesso con indirizzo email e password e provider di identità federati come Google Sign-In e Facebook Login. Questo tutorial ti aiuta a iniziare a utilizzare Firebase Authentication mostrandoti come aggiungere l'accesso con indirizzo email e password alla tua app.

Collegare l'app a Firebase

1. Installa l'SDK Firebase.
2. Nella console Firebase, aggiungi l'app al progetto Firebase.

Aggiungere Firebase Authentication all'app

Utilizza Swift Package Manager per installare e gestire le dipendenze di Firebase.

Consulta la nostra guida all'installazione per scoprire i diversi modi in cui puoi aggiungere gli SDK Firebase al tuo progetto Apple, tra cui l'importazione diretta dei framework e l'utilizzo di CocoaPods.

1. In Xcode, con il progetto dell'app aperto, vai a File > Aggiungi pacchetti.
2. Quando richiesto, aggiungi il repository dell'SDK delle piattaforme Apple di Firebase:

  https://github.com/firebase/firebase-ios-sdk.git

Nota:i nuovi progetti dovrebbero utilizzare la versione predefinita (più recente) dell'SDK, ma puoi scegliere una versione precedente, se necessario.
3. Scegli la raccolta Firebase Authentication.
4. Aggiungi il flag -ObjC alla sezione Altri flag del linker delle impostazioni di compilazione del target.
5. Al termine, Xcode inizierà automaticamente a risolvere e scaricare le tue dipendenze in background.

Importante:per le app Mac, abilita la funzionalità di condivisione del portachiavi in modo che l'SDK disponga dell'autorizzazione per archiviare le voci utente nel portachiavi. Per ulteriori informazioni, consulta la guida alle domande frequenti.

(Facoltativo) Crea un prototipo e testa con Firebase Local Emulator Suite

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

Un emulatore Authentication 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 Authentication prevede solo pochi passaggi:

1. Aggiunta di una riga di codice alla configurazione di test dell'app per connettersi all'emulatore.
2. Dalla directory principale del progetto locale, esegui firebase emulators:start.
3. Utilizzo dell'UI di Local Emulator Suite per la prototipazione interattiva o dell'API REST dell'emulatore Authentication per i test non interattivi.

Una guida dettagliata è disponibile all'indirizzo Collegare l'app all'emulatore Authentication. Per ulteriori informazioni, consulta l'introduzione a Local Emulator Suite.

Ora vediamo come autenticare gli utenti.

Inizializza l'SDK Firebase

Nel tuo app delegate, importa prima l'SDK Firebase:

Swift

import FirebaseCore
AppDelegate.swift

Objective-C

@import FirebaseCore;
AppDelegate.m

Poi, nel metodo application:didFinishLaunchingWithOptions:, inizializza l'oggetto FirebaseApp:

Swift

// Use Firebase library to configure APIs
FirebaseApp.configure()
AppDelegate.swift

Objective-C

// Use Firebase library to configure APIs
[FIRApp configure];
AppDelegate.m

Ascolta lo stato di autenticazione

Per ogni visualizzazione dell'app che richiede informazioni sull'utente che ha eseguito l'accesso, collega un ascoltatore all'oggetto FIRAuth. Questo ascoltatore viene chiamato ogni volta che cambia lo stato di accesso dell'utente.

Collega l'ascoltatore nel metodo viewWillAppear del view controller:

Swift

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

Objective-C

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

E scollega l'ascoltatore nel metodo viewWillDisappear del controller della vista:

Swift

Auth.auth().removeStateDidChangeListener(handle!)
MainViewController.swift

Objective-C

[[FIRAuth auth] removeAuthStateDidChangeListener:_handle];
MainViewController.m

Registrazione di nuovi utenti

Crea un modulo che consenta ai nuovi utenti di registrarsi alla tua app utilizzando il proprio indirizzo email e una password. Quando un utente compila il modulo, convalida l'indirizzo email e la password forniti dall'utente, quindi passali al metodo createUser:

Swift

Auth.auth().createUser(withEmail: email, password: password) { authResult, error in
  // ...
}
EmailViewController.swift

Objective-C

[[FIRAuth auth] createUserWithEmail:email
                           password:password
                         completion:^(FIRAuthDataResult * _Nullable authResult,
                                      NSError * _Nullable error) {
  // ...
}];
EmailViewController.m

Accedere agli utenti esistenti

Crea un modulo che consenta agli utenti esistenti di accedere utilizzando il proprio indirizzo email e la propria password. Quando un utente completa il modulo, chiama il metodo signIn:

Swift

Auth.auth().signIn(withEmail: email, password: password) { [weak self] authResult, error in
  guard let strongSelf = self else { return }
  // ...
}
EmailViewController.swift

Objective-C

[[FIRAuth auth] signInWithEmail:self->_emailField.text
                       password:self->_passwordField.text
                     completion:^(FIRAuthDataResult * _Nullable authResult,
                                  NSError * _Nullable error) {
  // ...
}];
EmailViewController.m

Ottenere informazioni sull'utente

Dopo che un utente ha eseguito l'accesso, puoi ottenere le informazioni che lo riguardano. Ad esempio, nell'ascoltatore dello stato di autenticazione:

Swift

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 += " "
  }
  // ...
}
MainViewController.swift

Objective-C

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;
  // ...
}
MainViewController.m

Passaggi successivi

Scopri come aggiungere il supporto per altri provider di identità e account ospite anonimi:

• Accedi con Google
• Accesso con Facebook
• Accesso a Twitter
• Accesso a GitHub
• Accesso anonimo