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.

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

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 a scaricare le tue dipendenze in background.

(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 di autenticazione e fornitori, 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 i contenuti e la configurazione del database emulati, nonché, facoltativamente, con le risorse del progetto emulate (funzioni, altri database e regole di sicurezza).

L'utilizzo dell'emulatore Authentication prevede solo pochi passaggi:

1. Aggiungere 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'interfaccia utente 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:

import FirebaseCore
AppDelegate.swift

@import FirebaseCore;
AppDelegate.m

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

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

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

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

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

E scollega l'ascoltatore nel metodo viewWillDisappear del view controller:

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

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

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

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

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

[[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 correttamente, puoi ottenere informazioni su di lui. Ad esempio, nell'ascoltatore dello stato di autenticazione:

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

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 di altri provider di identità e account ospite anonimi:

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