Saltare al contenuto principale
@capgo/capacitor-autenticazione-firebase Autenticazione & Sicurezza Sorgente aperta

Autenticazione Firebase Plugin Capacitor

Capacitor plugin per l'autenticazione Firebase

Installa

bun add @capgo/capacitor-firebase-authentication bunx cap sync
npm, pnpm o yarn
  • npm install @capgo/capacitor-firebase-authentication
  • pnpm add @capgo/capacitor-firebase-authentication
  • yarn add @capgo/capacitor-firebase-authentication

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).

FAQ

Faq del plugin di autenticazione Firebase

Come posso installare il plugin di autenticazione Firebase in un'app Capacitor?

Esegui "bun add @capgo/capacitor-firebase-authentication" (o "npm install @capgo/capacitor-firebase-authentication"), quindi esegui "bunx cap sync" per far assorbire i progetti iOS e Android del nativo code. Importalo da "@capgo/capacitor-firebase-authentication" nella tua app code.

Funziona @capgo/capacitor-firebase-authentication con React, Vue e Angular?

Sì. L'autenticazione Firebase è un pacchetto Capacitor, quindi funziona con qualsiasi framework web che esegue all'interno di Capacitor, compresi Ionic, React, Vue, Angular, Svelte e JavaScript puro.

Qual è la versione di Capacitor supportata da @capgo/capacitor-firebase-authentication?

I plugin Capgo seguono la versione maggiore di Capacitor: utilizza la versione maggiore del plugin che corrisponde alla tua versione maggiore di Capacitor (ad esempio plugin v8 con Capacitor 8). La tabella di compatibilità nel README del GitHub elenca le versioni mantenute.

È gratuito e open source @capgo/capacitor-firebase-authentication?

Si. La sorgente code è pubblica su GitHub a https://github.com/Cap-go/capacitor-firebase/tree/main/packages/authentication e il pacchetto è gratuito per l'installazione da npm. I rapporti di bug e le richieste di pull sono i benvenuti.

Sono in grado di aggiornare code che utilizza l'autenticazione Firebase senza una revisione dell'App Store?

L'installazione o l'aggiornamento del plugin modifica il codice nativo code, quindi richiede una nuova costruzione dello store. Dopo di che, le modifiche JavaScript, HTML e CSS che chiamano il plugin possono essere distribuite immediatamente con gli aggiornamenti Capgo in tempo reale.

Invia le modifiche all'autenticazione Firebase senza attendere la revisione dell'applicazione

Una volta che il plugin è presente nella tua store build, Capgo le aggiornamenti live spingono i tuoi cambiamenti JavaScript, HTML e CSS agli utenti in pochi minuti.

Inizia con Capgo