Guida
Come usare Firebase Authentication in Capacitor
Utilizzo di @capgo/capacitor-firebase-authentication
Plugin Capacitor per Firebase Authentication.
Installa
bun add @capgo/capacitor-firebase-authentication
bunx cap sync
bunx cap sync copia i code nativi del plugin nei tuoi progetti nativi. Eseguilo di nuovo dopo ogni aggiornamento del plugin.
Importa
import { FirebaseAuthentication } from '@capgo/capacitor-firebase-authentication';
API in breve
| Metodo | Descrizione |
|---|---|
applyActionCode |
Applica un code di verifica inviato all'utente via email. |
confirmPasswordReset |
Completa la procedura di reset della password. |
confirmVerificationCode |
Conclude la verifica del numero di telefono. |
createUserWithEmailAndPassword |
Crea un nuovo account utente con email e password. Se il nuovo account è stato creato, l'utente effettua automaticamente il login. |
deleteUser |
Elimina l'utente e effettua il logout. |
fetchSignInMethodsForEmail |
Recupera i metodi di sign-in per un indirizzo email. |
getCurrentUser |
Recupera l'utente attualmente loggato. |
getPendingAuthResult |
Restituisce il SignInResult se la tua app ha avviato un flusso di login web e l'OS chiude l'app mentre è in background. |
getIdToken |
Recupera il Firebase Auth ID Token dell'utente attualmente loggato. |
getIdTokenResult |
Restituisce un JSON Web Token (JWT) deserializzato per identificare l'utente su un servizio Firebase. |
getRedirectResult |
Restituisce il SignInResult dal flusso di sign-in basato su redirect. |
getTenantId |
Ottieni il tenant id. |
isSignInWithEmailLink |
Verifica se il link ricevuto è un sign-in tramite email adatto per signInWithEmailLink. |
linkWithApple |
Collega l'account utente al provider di autenticazione Apple. |
linkWithEmailAndPassword |
Collega l'account utente al provider di autenticazione Email. |
linkWithEmailLink |
Collega l'account utente al provider di autenticazione Email. |
linkWithFacebook |
Collega l'account utente al provider di autenticazione Facebook. |
linkWithGameCenter |
Collega l'account utente al provider di autenticazione Game Center. |
linkWithGithub |
Collega l'account utente al provider di autenticazione GitHub. |
linkWithGoogle |
Collega l'account utente al provider di autenticazione Google. |
linkWithMicrosoft |
Collega l'account utente al provider di autenticazione Microsoft. |
linkWithOpenIdConnect |
Collega l'account utente a un provider OpenID Connect. |
linkWithPhoneNumber |
Collega l'account utente al provider di autenticazione tramite numero di telefono. |
linkWithPlayGames |
Collega l'account utente al provider di autenticazione Play Games. |
linkWithTwitter |
Collega l'account utente al provider di autenticazione Twitter. |
linkWithYahoo |
Collega l'account utente al provider di autenticazione Yahoo. |
reload |
Ricarica i dati dell'account utente, se loggato. |
revokeAccessToken |
Revoca l'access token indicato. Al momento supporta solo gli access token Apple OAuth. |
sendEmailVerification |
Invia un'email di verifica all'utente attualmente autenticato. |
sendPasswordResetEmail |
Invia un'email per il reset della password. |
sendSignInLinkToEmail |
Invia all'utente un link di accesso via email con l'indirizzo specificato. |
setLanguageCode |
Imposta la lingua code mostrata all'utente per le operazioni di auth. |
setPersistence |
Imposta il tipo di persistenza per la sessione auth salvata. |
setTenantId |
Imposta il tenant id. |
signInAnonymously |
Effettua l'accesso come utente anonimo. |
signInWithApple |
Avvia il flusso di accesso con Apple. |
signInWithCustomToken |
Avvia il flusso di accesso con Custom Token. |
signInWithEmailAndPassword |
Avvia il flusso di accesso tramite email e password. |
signInWithEmailLink |
Effettua l'accesso tramite email e link di accesso. |
signInWithFacebook |
Avvia il flusso di accesso con Facebook. |
signInWithGameCenter |
Avvia il flusso di accesso con Game Center. |
signInWithGithub |
Avvia il flusso di sign-in di GitHub. |
signInWithGoogle |
Avvia il flusso di login con Google. |
signInWithMicrosoft |
Avvia il flusso di login con Microsoft. |
signInWithOpenIdConnect |
Avvia il flusso di login OpenID Connect. |
signInWithPhoneNumber |
Avvia il flusso di login tramite numero di telefono. |
signInWithPlayGames |
Avvia il flusso di login con Play Games. |
signInWithTwitter |
Avvia il flusso di login con Twitter. |
signInWithYahoo |
Avvia il flusso di login con Yahoo. |
signOut |
Avvia il flusso di logout. |
unlink |
Scollega un provider dall'account utente. |
updateEmail |
Aggiorna l'indirizzo email dell'utente attualmente loggato. |
updatePassword |
Aggiorna la password dell'utente attualmente loggato. |
updateProfile |
Aggiorna i dati del profilo utente. |
useAppLanguage |
Imposta la lingua code come lingua predefinita dell'app. |
useEmulator |
Configura la tua app per comunicare con l'emulatore di Authentication. |
verifyBeforeUpdateEmail |
Verifica il nuovo indirizzo email prima di aggiornare quello dell'utente loggato. |
checkAppTrackingTransparencyPermission |
Controlla lo stato attuale di App Tracking Transparency. |
requestAppTrackingTransparencyPermission |
Apre il dialog di sistema per autorizzare App Tracking Transparency. |
Esempi
applyActionCode()
Applica un code di verifica inviato all'utente via email.
import { FirebaseAuthentication } from '@capgo/capacitor-firebase-authentication';
await FirebaseAuthentication.applyActionCode({ oobCode: 'oob-code' });
confirmPasswordReset()
Completa la procedura di reset della password.
import { FirebaseAuthentication } from '@capgo/capacitor-firebase-authentication';
await FirebaseAuthentication.confirmPasswordReset({
oobCode: 'oob-code',
newPassword: 'new-password',
});
confirmVerificationCode()
Conclude la 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 email e password. Se il nuovo account è stato creato, l'utente effettua automaticamente il login.
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 l'utente e effettua il logout.
import { FirebaseAuthentication } from '@capgo/capacitor-firebase-authentication';
await FirebaseAuthentication.deleteUser();
fetchSignInMethodsForEmail()
Recupera i metodi di sign-in 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 core. Gli helper per listener e versioni, e il contratto completo di ogni metodo, sono documentati in repository GitHub.
Ascolta gli eventi
addListener restituisce un handle. Chiama handle.remove() quando la schermata viene smontata, o FirebaseAuthentication.removeAllListeners() per rimuovere tutti i listener.
Riferimento completo
Continua da Using @capgo/capacitor-firebase-authentication
Se stai usando Utilizzo di @capgo/capacitor-firebase-authentication per pianificare i flussi di autenticazione e account, collegandolo a @capgo/capacitor-social-login per i dettagli di implementazione in @capgo/capacitor-social-login, @capgo/capacitor-passkey per i dettagli di implementazione in @capgo/capacitor-passkey, @capgo/capacitor-native-biometric per i dettagli di implementazione in @capgo/capacitor-native-biometric, Autenticazione a due fattori per i dettagli di implementazione in Two-factor authentication, e SSO (Enterprise) per i dettagli di implementazione in SSO (Enterprise).