Guida
Come utilizzare l'autenticazione Firebase in Capacitor
Usa @capgo/capacitor-firebase-authentication
Plugin Capacitor per Firebase Authentication.
Installa
bun add @capgo/capacitor-firebase-authentication
bunx cap sync
bunx cap sync Copia il plugin di code nativo nei tuoi progetti nativi. Esegui nuovamente dopo ogni aggiornamento del plugin.
Importa
import { FirebaseAuthentication } from '@capgo/capacitor-firebase-authentication';
API in breve
| Metodo | Descrizione |
|---|---|
applyActionCode |
Applica una verifica code inviata all'utente via email. |
confirmPasswordReset |
Completa il processo di reimpostazione della password. |
confirmVerificationCode |
Completa il processo di verifica del numero di telefono. |
createUserWithEmailAndPassword |
Crea un nuovo account utente con email e password. Se l'account nuovo è stato creato, l'utente viene acceduto automaticamente. |
deleteUser |
Elimina e disconnette l'utente. |
fetchSignInMethodsForEmail |
Recupera i metodi di accesso per un indirizzo email. |
getCurrentUser |
Recupera l'utente attualmente acceduto. |
getPendingAuthResult |
Restituisce il SignInResult Se il tuo app ha lanciato un flusso di accesso web e il sistema operativo pulisce l'app mentre è in background. |
getIdToken |
Recupera il token di autenticazione Firebase per l'utente attualmente acceduto. |
getIdTokenResult |
Restituisce un token JWT deserializzato (JSON Web Token) utilizzato per identificare l'utente a un servizio Firebase. |
getRedirectResult |
Restituisce il SignInResult dal flusso di accesso basato sulla reindirizzamento. |
getTenantId |
Ottieni l'ID tenant. |
isSignInWithEmailLink |
Controlla se un collegamento di arrivo è un collegamento di accesso con email adatto per signInWithEmailLink. |
linkWithApple |
Collega l'account utente con il provider di autenticazione Apple. |
linkWithEmailAndPassword |
Collega l'account utente con il provider di autenticazione Email. |
linkWithEmailLink |
Collega l'account utente con il provider di autenticazione Email. |
linkWithFacebook |
Collega l'account utente con il provider di autenticazione Facebook. |
linkWithGameCenter |
Collega l'account utente con il provider di autenticazione Game Center. |
linkWithGithub |
Collega l'account utente con il provider di autenticazione GitHub. |
linkWithGoogle |
Collega l'account utente con il provider di autenticazione Google. |
linkWithMicrosoft |
Collega l'account utente con il provider di autenticazione Microsoft. |
linkWithOpenIdConnect |
Collega l'account utente con un provider di autenticazione OpenID Connect. |
linkWithPhoneNumber |
Collega l'account utente con il provider di autenticazione Numero di Telefono. |
linkWithPlayGames |
Collega l'account utente con il provider di autenticazione Play Games. |
linkWithTwitter |
Collega l'account utente con il provider di autenticazione Twitter. |
linkWithYahoo |
Collega l'account utente con il provider di autenticazione Yahoo. |
reload |
Ricarica i dati dell'account utente, se si è connessi. |
revokeAccessToken |
Revoca il token di accesso specificato. Attualmente supporta solo i token di accesso OAuth Apple. |
sendEmailVerification |
Invia un'email di verifica all'utente attualmente connesso. |
sendPasswordResetEmail |
Invia un'email di reimpostazione della password. |
sendSignInLinkToEmail |
Invia un'email di link di accesso all'utente con l'indirizzo email specificato. |
setLanguageCode |
Imposta la lingua utente code per le operazioni di autenticazione. |
setPersistence |
Imposta il tipo di persistenza per la sessione di autenticazione attualmente salvata. |
setTenantId |
Imposta l'ID tenant. |
signInAnonymously |
Si connette come utente anonimo. |
signInWithApple |
Avvia il flusso di accesso Apple. |
signInWithCustomToken |
Avvia il flusso di accesso Token Personalizzato. |
signInWithEmailAndPassword |
Avvia il flusso di accesso utilizzando un indirizzo e-mail e una password. |
signInWithEmailLink |
Accedi con un indirizzo email e un link di accesso all'account. |
signInWithFacebook |
Avvia il flusso di accesso Facebook. |
signInWithGameCenter |
Avvia il flusso di accesso al centro giochi. |
signInWithGithub |
Avvia il flusso di accesso al GitHub. |
signInWithGoogle |
Avvia il flusso di accesso a Google. |
signInWithMicrosoft |
Avvia il flusso di accesso a Microsoft. |
signInWithOpenIdConnect |
Avvia il flusso di accesso all'identità aperta. |
signInWithPhoneNumber |
Avvia il flusso di accesso utilizzando un numero di telefono. |
signInWithPlayGames |
Avvia il flusso di accesso ai giochi di Google. |
signInWithTwitter |
Avvia il flusso di accesso a Twitter. |
signInWithYahoo |
Avvia il flusso di accesso a Yahoo. |
signOut |
Avvia il flusso di disconnessione. |
unlink |
Disconnette un provider da un account utente. |
updateEmail |
Aggiorna l'indirizzo email dell'utente attualmente connesso. |
updatePassword |
Aggiorna la password dell'utente attualmente connesso. |
updateProfile |
Aggiorna i dati di profilo dell'utente. |
useAppLanguage |
Imposta la lingua utente code come lingua predefinita dell'applicazione. |
useEmulator |
Configura l'app per comunicare con l'emulatore di autenticazione. |
verifyBeforeUpdateEmail |
Verifica l'indirizzo email nuovo prima di aggiornare l'indirizzo email dell'utente attualmente connesso. |
checkAppTrackingTransparencyPermission |
Controlla lo stato attuale della trasparenza del tracking dell'app. |
requestAppTrackingTransparencyPermission |
Apre il dialogo del sistema per autorizzare la trasparenza del tracking dell'app. |
Esempi
applyActionCode()
Applica la verifica code inviata all'utente via email.
import { FirebaseAuthentication } from '@capgo/capacitor-firebase-authentication';
await FirebaseAuthentication.applyActionCode({ oobCode: 'oob-code' });
confirmPasswordReset()
Completa il processo di reimpostazione della password.
import { FirebaseAuthentication } from '@capgo/capacitor-firebase-authentication';
await FirebaseAuthentication.confirmPasswordReset({
oobCode: 'oob-code',
newPassword: 'new-password',
});
confirmVerificationCode()
Completa il processo di verifica del numero di telefono.
import { FirebaseAuthentication } from '@capgo/capacitor-firebase-authentication';
const result = await FirebaseAuthentication.confirmVerificationCode({
verificationId: 'phoneCodeSent',
verificationCode: 'phoneCodeSent',
});
// The result holds sensitive values: use it without logging it.
createUserWithEmailAndPassword()
Crea un nuovo account utente con indirizzo email e password. Se l'account nuovo è stato creato, l'utente viene acceduto automaticamente.
import { FirebaseAuthentication } from '@capgo/capacitor-firebase-authentication';
const result = await FirebaseAuthentication.createUserWithEmailAndPassword({
email: 'user@example.com',
password: 'password',
});
// The result holds sensitive values: use it without logging it.
deleteUser()
Elimina e disconnette l'utente.
import { FirebaseAuthentication } from '@capgo/capacitor-firebase-authentication';
await FirebaseAuthentication.deleteUser();
fetchSignInMethodsForEmail()
Recupera i metodi di accesso per un indirizzo email.
import { FirebaseAuthentication } from '@capgo/capacitor-firebase-authentication';
const result = await FirebaseAuthentication.fetchSignInMethodsForEmail({ email: 'user@example.com' });
console.log(result);
La tabella sopra elenca i 59 metodi di base. Gli helper per gli ascoltatori e le versioni, e il contratto completo di ogni metodo, sono documentati nel GitHub repository.
Ascolta gli eventi
addListener ritorna un handle. Chiama handle.remove() quando lo schermo viene smontato, o FirebaseAuthentication.removeAllListeners() per cancellare tutti gli ascoltatori.
Riferimento completo
Continua dall'uso di @capgo/capacitor-firebase-authentication
Continua da Utilizzo di @__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-firebase-authentication Usando @capgo/capacitor-autenticazione-firebase per pianificare l'autenticazione e le flussi di account, connettilo con @capgo/capacitor-login con social media per i dettagli di implementazione in @capgo/capacitor-login sociale, @capgo/capacitor-chiave di accesso per il dettaglio di implementazione in @capgo/capacitor-passkey, @capgo/capacitor-autenticazione-biometrica per i dettagli di implementazione in @capgo/capacitor-native-biometric, Autenticazione a due fattori per i dettagli di implementazione in Autenticazione a due fattori, e SSO (aziendale) per i dettagli di implementazione in SSO (aziendale).