Salta al contenuto principale
@capgo/capacitor-firebase-authentication Autenticazione e sicurezza Open source

Autenticazione Firebase Plugin Capacitor

Plugin Capacitor per Firebase Authentication

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

FAQ

FAQ sul plugin Firebase Authentication

Come installo il plugin Firebase Authentication in un'app Capacitor?

Esegui "bun add @capgo/capacitor-firebase-authentication" (o "npm install @capgo/capacitor-firebase-authentication"), poi lancia "bunx cap sync" per aggiornare i progetti iOS e Android con il code nativo. Importalo da "@capgo/capacitor-firebase-authentication" nel code della tua app.

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

Sì. Firebase Authentication è un pacchetto Capacitor, quindi funziona con qualsiasi web framework in Capacitor, inclusi Ionic, React, Vue, Angular, Svelte e JavaScript puro.

Quale versione di Capacitor supporta @capgo/capacitor-firebase-authentication?

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

@capgo/capacitor-firebase-authentication è free e open source?

Sì. Il codice sorgente code è pubblico su GitHub all'indirizzo https://github.com/Cap-go/capacitor-firebase/tree/main/packages/authentication e il pacchetto è gratuito su npm. Bug report e pull request sono benvenuti.

Posso aggiornare code che usa Firebase Authentication senza passare per la revisione dell'App Store?

Installare o aggiornare il plugin modifica il code nativo, quindi serve una nuova build per lo store. Dopo, le modifiche a JavaScript, HTML e CSS che chiamano il plugin possono essere rilasciate subito con le live updates di Capgo.

Rilascia le modifiche a Firebase Authentication senza aspettare la revisione dell'app

Una volta incluso il plugin nel tuo store build, Capgo invia le modifiche a JavaScript, HTML e CSS tramite live updates in pochi minuti.

Inizia con Capgo