Puoi utilizzare Firebase Authentication per consentire agli utenti di accedere alla tua app utilizzando uno o più metodi di accesso, inclusi l'indirizzo e-mail e l'accesso con password, e provider di identità federati come Accesso con Google e Accesso a Facebook. Questo tutorial ti consente di iniziare con Firebase Authentication mostrandoti come aggiungere l'indirizzo e-mail e l'accesso con password alla tua app.
Aggiungere e inizializzare l'SDK di autenticazione
Se non lo hai già fatto, installa Firebase JS SDK e inizializza Firebase .
Aggiungi l'SDK JS di Firebase Authentication e inizializza Firebase Authentication:
API modulare Web
import { initializeApp } from "firebase/app"; import { getAuth } from "firebase/auth"; // TODO: Replace the following with your app's Firebase project configuration // See: https://firebase.google.com/docs/web/learn-more#config-object const firebaseConfig = { // ... }; // Initialize Firebase const app = initializeApp(firebaseConfig); // Initialize Firebase Authentication and get a reference to the service const auth = getAuth(app);
API con spazio dei nomi Web
import firebase from "firebase/compat/app"; import "firebase/auth"; // TODO: Replace the following with your app's Firebase project configuration // See: https://firebase.google.com/docs/web/learn-more#config-object const firebaseConfig = { // ... }; // Initialize Firebase firebase.initializeApp(firebaseConfig); // Initialize Firebase Authentication and get a reference to the service const auth = firebase.auth();
(Facoltativo) Prototipazione 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 della Local Emulator Suite, che consente all'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 comporta solo pochi passaggi:
- Aggiunta di una riga di codice alla configurazione di test dell'app per connettersi all'emulatore.
- Dalla radice della directory del progetto locale, eseguendo
firebase emulators:start
. - Utilizzo dell'interfaccia utente di Local Emulator Suite per la creazione di prototipi interattivi o dell'API REST dell'emulatore di autenticazione per test non interattivi.
Una guida dettagliata è disponibile in Connect your app to the Authentication emulator . Per ulteriori informazioni, vedere l' introduzione a Local Emulator Suite .
Ora continuiamo con come autenticare gli utenti.
Registra nuovi utenti
Crea un modulo che consenta ai nuovi utenti di registrarsi alla tua app utilizzando il loro indirizzo e-mail e una password. Quando un utente completa il modulo, convalida l'indirizzo e-mail e la password forniti dall'utente, quindi passali al metodo createUserWithEmailAndPassword
:
Web modular API
import { getAuth, createUserWithEmailAndPassword } from "firebase/auth"; const auth = getAuth(); createUserWithEmailAndPassword(auth, email, password) .then((userCredential) => { // Signed in const user = userCredential.user; // ... }) .catch((error) => { const errorCode = error.code; const errorMessage = error.message; // .. });
Web namespaced API
firebase.auth().createUserWithEmailAndPassword(email, password) .then((userCredential) => { // Signed in var user = userCredential.user; // ... }) .catch((error) => { var errorCode = error.code; var errorMessage = error.message; // .. });
Accedi agli utenti esistenti
Crea un modulo che consenta agli utenti esistenti di accedere utilizzando il proprio indirizzo e-mail e la propria password. Quando un utente completa il modulo, chiama il metodo signInWithEmailAndPassword
:
Web modular API
import { getAuth, signInWithEmailAndPassword } from "firebase/auth"; const auth = getAuth(); signInWithEmailAndPassword(auth, email, password) .then((userCredential) => { // Signed in const user = userCredential.user; // ... }) .catch((error) => { const errorCode = error.code; const errorMessage = error.message; });
Web namespaced API
firebase.auth().signInWithEmailAndPassword(email, password) .then((userCredential) => { // Signed in var user = userCredential.user; // ... }) .catch((error) => { var errorCode = error.code; var errorMessage = error.message; });
Imposta un osservatore dello stato di autenticazione e ottieni i dati dell'utente
Per ciascuna delle pagine della tua app che richiedono informazioni sull'utente che ha eseguito l'accesso, collega un osservatore all'oggetto di autenticazione globale. Questo osservatore viene chiamato ogni volta che cambia lo stato di accesso dell'utente.
Collega l'osservatore utilizzando il metodo onAuthStateChanged
. Quando un utente accede correttamente, puoi ottenere informazioni sull'utente nell'osservatore.
Web modular API
import { getAuth, onAuthStateChanged } from "firebase/auth"; const auth = getAuth(); onAuthStateChanged(auth, (user) => { if (user) { // User is signed in, see docs for a list of available properties // https://firebase.google.com/docs/reference/js/auth.user const uid = user.uid; // ... } else { // User is signed out // ... } });
Web namespaced API
firebase.auth().onAuthStateChanged((user) => { if (user) { // User is signed in, see docs for a list of available properties // https://firebase.google.com/docs/reference/js/v8/firebase.User var uid = user.uid; // ... } else { // User is signed out // ... } });
Prossimi passi
Scopri come aggiungere il supporto per altri provider di identità e account guest anonimi: