Puoi utilizzare l'autenticazione Firebase per consentire agli utenti di accedere alla tua app utilizzando uno o più metodi di accesso, inclusi indirizzo email e password, e provider di identità federati come Google Sign-in e Facebook Login. Questo tutorial ti consente di iniziare con l'autenticazione Firebase mostrandoti come aggiungere l'indirizzo e-mail e la password di accesso alla tua app.
Connetti la tua app a Firebase
- Installa l'SDK Firebase .
- Nella console Firebase , aggiungi la tua app al tuo progetto Firebase.
Aggiungi l'autenticazione Firebase alla tua app
Aggiungi la dipendenza per l'autenticazione Firebase al
Podfiledel tuo progetto:pod 'Firebase/Auth'Esegui l'
pod installe apri il file.xcworkspacecreato.
(Facoltativo) Prototipo e test con Firebase Local Emulator Suite
Prima di parlare di come la tua app autentica gli utenti, introduciamo una serie di strumenti che puoi utilizzare per prototipare e testare la funzionalità di autenticazione: Firebase Local Emulator Suite. Se stai decidendo tra tecniche e provider di autenticazione, provando diversi modelli di dati con dati pubblici e privati utilizzando le regole di sicurezza di autenticazione e Firebase o prototipando i progetti dell'interfaccia utente di accesso, essere in grado di lavorare localmente senza distribuire servizi live può essere un'ottima idea .
Un emulatore di autenticazione fa parte di Local Emulator Suite, che consente alla tua app di interagire con il contenuto e la configurazione del database emulato, nonché, facoltativamente, con le risorse del progetto emulato (funzioni, altri database e regole di sicurezza).
L'utilizzo dell'emulatore di autenticazione richiede solo pochi passaggi:
- Aggiunta di una riga di codice alla configurazione di test dell'app per connettersi all'emulatore.
- Dalla radice della directory del tuo progetto locale, eseguendo
firebase emulators:start. - Utilizzo dell'interfaccia utente di Local Emulator Suite per la prototipazione interattiva o dell'API REST dell'emulatore di autenticazione per i test non interattivi.
Una guida dettagliata è disponibile su Connetti la tua app all'emulatore di autenticazione . Per ulteriori informazioni, vedere l' introduzione di Local Emulator Suite .
Ora continuiamo con come autenticare gli utenti.
Inizializza l'SDK Firebase
Nel delegato dell'app, importa prima l'SDK Firebase:
Swift
import Firebase
Obiettivo-C
@import Firebase;
Quindi, application:didFinishLaunchingWithOptions: metodo, inizializza l'oggetto FirebaseApp :
Swift
// Use Firebase library to configure APIs
FirebaseApp.configure()
Obiettivo-C
// Use Firebase library to configure APIs
[FIRApp configure];
Ascolta lo stato di autenticazione
Per ogni visualizzazione dell'app che richiede informazioni FIRAuth che ha FIRAuth l' FIRAuth , collega un listener all'oggetto FIRAuth . Questo listener viene chiamato ogni volta che cambia lo stato di accesso dell'utente.
Collega il listener nel metodo viewWillAppear del controller di visualizzazione:
Swift
handle = Auth.auth().addStateDidChangeListener { (auth, user) in
// ...
}
Obiettivo-C
self.handle = [[FIRAuth auth]
addAuthStateDidChangeListener:^(FIRAuth *_Nonnull auth, FIRUser *_Nullable user) {
// ...
}];
E scollega il listener nel metodo viewWillDisappear del controller della vista:
Swift
Auth.auth().removeStateDidChangeListener(handle!)
Obiettivo-C
[[FIRAuth auth] removeAuthStateDidChangeListener:_handle];
Registra nuovi utenti
Crea un modulo che consenta ai nuovi utenti di registrarsi alla tua app utilizzando il loro indirizzo email e una password. Quando un utente completa il modulo, convalida l'indirizzo e-mail e la password forniti dall'utente, quindi createUser metodo createUser :
Swift
Auth.auth().createUser(withEmail: email, password: password) { authResult, error in
// ...
}
Obiettivo-C
[[FIRAuth auth] createUserWithEmail:email
password:password
completion:^(FIRAuthDataResult * _Nullable authResult,
NSError * _Nullable error) {
// ...
}];
Accedi utenti esistenti
Crea un modulo che consenta agli utenti esistenti di accedere utilizzando il loro indirizzo email e la 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 }
// ...
}
Obiettivo-C
[[FIRAuth auth] signInWithEmail:self->_emailField.text
password:self->_passwordField.text
completion:^(FIRAuthDataResult * _Nullable authResult,
NSError * _Nullable error) {
// ...
}];
Ottieni informazioni sull'utente
Dopo che un utente ha eseguito correttamente l'accesso, è possibile ottenere informazioni sull'utente. Ad esempio, nel listener 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 += " "
}
// ...
}
Obiettivo-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;
// ...
}
Prossimi passi
Scopri come aggiungere supporto per altri provider di identità e account ospite anonimi: