Aller au contenu principal
@capgo/capacitor-firebase-authentication Auth & sécurité Open source

Firebase Authentication Plugin Capacitor

Plugin Capacitor pour Firebase Authentication

Installer

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

Guide

Comment utiliser Firebase Authentication dans Capacitor

Utiliser @capgo/capacitor-firebase-authentication

Plugin Capacitor pour Firebase Authentication.

Installer

bun add @capgo/capacitor-firebase-authentication
bunx cap sync

bunx cap sync copie le code natif du plugin dans vos projets natifs. Relancez-l’après chaque mise à jour du plugin.

Importer

import { FirebaseAuthentication } from '@capgo/capacitor-firebase-authentication';

Aperçu de API

Méthode Description
applyActionCode Applique un code de vérification envoyé à l'utilisateur par e-mail.
confirmPasswordReset Finalise la réinitialisation du mot de passe.
confirmVerificationCode Termine le processus de vérification du numéro de téléphone.
createUserWithEmailAndPassword Crée un nouveau compte utilisateur avec un e-mail et un mot de passe. Si le compte est créé, l'utilisateur est automatiquement connecté.
deleteUser Supprime l'utilisateur et le déconnecte.
fetchSignInMethodsForEmail Récupère les méthodes de connexion pour une adresse e-mail.
getCurrentUser Récupère l'utilisateur actuellement connecté.
getPendingAuthResult Retourne le SignInResult si votre application a lancé un flux de connexion web et que l'OS ferme l'application en arrière-plan.
getIdToken Récupère le token ID Firebase Auth pour l'utilisateur actuellement connecté.
getIdTokenResult Retourne un JSON Web Token (JWT) désérialisé utilisé pour identifier l'utilisateur auprès d'un service Firebase.
getRedirectResult Retourne le SignInResult du flux de connexion basé sur une redirection.
getTenantId Récupérer l'ID du tenant.
isSignInWithEmailLink Vérifie si un lien entrant est une connexion par lien e-mail compatible avec signInWithEmailLink.
linkWithApple Lier le compte utilisateur au fournisseur d'authentification Apple.
linkWithEmailAndPassword Lier le compte utilisateur au fournisseur d'authentification par e-mail.
linkWithEmailLink Lier le compte utilisateur au fournisseur d'authentification par e-mail.
linkWithFacebook Lier le compte utilisateur au fournisseur d'authentification Facebook.
linkWithGameCenter Associe le compte utilisateur au fournisseur d'authentification Game Center.
linkWithGithub Associe le compte utilisateur au fournisseur d’authentification GitHub.
linkWithGoogle Associe le compte utilisateur au fournisseur d’authentification Google.
linkWithMicrosoft Associe le compte utilisateur au fournisseur d’authentification Microsoft.
linkWithOpenIdConnect Associe le compte utilisateur à un fournisseur OpenID Connect.
linkWithPhoneNumber Associe le compte utilisateur au fournisseur d’authentification par numéro de téléphone.
linkWithPlayGames Associe le compte utilisateur au fournisseur d’authentification Play Games.
linkWithTwitter Associe le compte utilisateur au fournisseur d’authentification Twitter.
linkWithYahoo Associe le compte utilisateur au fournisseur d'authentification Yahoo.
reload Recharge les données du compte utilisateur, si connecté.
revokeAccessToken Révoque le token d'accès fourni. Prend actuellement en charge uniquement les tokens d'accès Apple OAuth.
sendEmailVerification Envoie un e-mail de vérification à l'utilisateur actuellement connecté.
sendPasswordResetEmail Envoie un e-mail de réinitialisation de mot de passe.
sendSignInLinkToEmail Envoie un lien de connexion par e-mail à l'utilisateur ayant l'adresse e-mail indiquée.
setLanguageCode Définit la langue code pour les opérations d'authentification.
setPersistence Définit le type de persistance de la session d'authentification enregistrée.
setTenantId Définit l'ID du tenant.
signInAnonymously Se connecte en tant qu'utilisateur anonyme.
signInWithApple Lance le flux de connexion Apple.
signInWithCustomToken Lance le flux de connexion via Custom Token.
signInWithEmailAndPassword Lance le flux de connexion par e-mail et mot de passe.
signInWithEmailLink Se connecte via un e-mail et un lien de connexion.
signInWithFacebook Lance le flux de connexion Facebook.
signInWithGameCenter Lance le flux de connexion Game Center.
signInWithGithub Lance le flux de connexion GitHub.
signInWithGoogle Lance le flux de connexion Google.
signInWithMicrosoft Lance le flux de connexion Microsoft.
signInWithOpenIdConnect Lance le flux de connexion OpenID Connect.
signInWithPhoneNumber Lance le flux de connexion par numéro de téléphone.
signInWithPlayGames Lance le flux de connexion Play Games.
signInWithTwitter Lance le flux de connexion Twitter.
signInWithYahoo Lance le flux de connexion Yahoo.
signOut Lance le flux de déconnexion.
unlink Dissocie un fournisseur d’un compte utilisateur.
updateEmail Met à jour l’adresse e-mail de l’utilisateur connecté.
updatePassword Met à jour le mot de passe de l’utilisateur connecté.
updateProfile Met à jour les données du profil utilisateur.
useAppLanguage Définit la langue d'affichage code comme langue par défaut de l'application.
useEmulator Configure votre application pour communiquer avec l'émulateur Authentication.
verifyBeforeUpdateEmail Vérifie la nouvelle adresse e-mail avant de mettre à jour l'adresse e-mail de l'utilisateur actuellement connecté.
checkAppTrackingTransparencyPermission Vérifie le statut actuel de l'App Tracking Transparency.
requestAppTrackingTransparencyPermission Ouvre la boîte de dialogue système pour autoriser l'App Tracking Transparency.

Exemples

applyActionCode()

Applique un code de vérification envoyé à l'utilisateur par e-mail.

import { FirebaseAuthentication } from '@capgo/capacitor-firebase-authentication';

await FirebaseAuthentication.applyActionCode({ oobCode: 'oob-code' });

confirmPasswordReset()

Finalise la réinitialisation du mot de passe.

import { FirebaseAuthentication } from '@capgo/capacitor-firebase-authentication';

await FirebaseAuthentication.confirmPasswordReset({
  oobCode: 'oob-code',
  newPassword: 'new-password',
});

confirmVerificationCode()

Termine le processus de vérification du numéro de téléphone.

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

Crée un nouveau compte utilisateur avec un e-mail et un mot de passe. Si le compte est créé, l'utilisateur est automatiquement connecté.

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

Supprime l'utilisateur et le déconnecte.

import { FirebaseAuthentication } from '@capgo/capacitor-firebase-authentication';

await FirebaseAuthentication.deleteUser();

fetchSignInMethodsForEmail()

Récupère les méthodes de connexion pour une adresse e-mail.

import { FirebaseAuthentication } from '@capgo/capacitor-firebase-authentication';

const result = await FirebaseAuthentication.fetchSignInMethodsForEmail({ email: 'user@example.com' });
console.log(result);

Le tableau ci-dessus liste les 59 méthodes principales. Les helpers de listener et de version, ainsi que le contrat complet de chaque méthode, sont documentés dans la dépôt GitHub.

Écouter les événements

addListener renvoie un handle. Appelez handle.remove() lors du démontage de l'écran, ou FirebaseAuthentication.removeAllListeners() pour supprimer tous les listeners.

Référence complète

Continuer depuis « Utiliser @capgo/capacitor-firebase-authentication »

Si vous utilisez Utiliser @capgo/capacitor-firebase-authentication pour planifier les flux d'authentification et de compte, le connecter à @capgo/capacitor-social-login pour les détails d'implémentation dans @capgo/capacitor-social-login @capgo/capacitor-passkey pour les détails d'implémentation dans @capgo/capacitor-passkey @capgo/capacitor-native-biometric pour les détails d'implémentation dans @capgo/capacitor-native-biometric, Authentification à deux facteurs pour les détails d'implémentation dans l'authentification à deux facteurs, et SSO (Entreprise) pour les détails d'implémentation dans le SSO (Enterprise).

FAQ

FAQ du plugin Firebase Authentication

Comment installer le plugin Firebase Authentication dans une application Capacitor ?

Exécutez "bun add @capgo/capacitor-firebase-authentication" (ou "npm install @capgo/capacitor-firebase-authentication"), puis lancez "bunx cap sync" pour que les projets iOS et Android prennent en compte le code natif. Importez-le depuis "@capgo/capacitor-firebase-authentication" dans votre code.

Est-ce que @capgo/capacitor-firebase-authentication fonctionne avec React, Vue et Angular ?

Oui. Firebase Authentication est un package Capacitor, il fonctionne donc avec n'importe quel framework web qui s'exécute dans Capacitor, y compris Ionic, React, Vue, Angular, Svelte et le JavaScript pur.

Quelle version de Capacitor est supportée par @capgo/capacitor-firebase-authentication ?

Les plugins Capgo suivent la version majeure de Capacitor : utilisez la version majeure du plugin qui correspond à la version majeure de votre Capacitor (par exemple le plugin v8 avec Capacitor 8). Le tableau de compatibilité du README de GitHub recense les versions maintenues.

Est-ce que @capgo/capacitor-firebase-authentication est gratuit et open source ?

Oui. Le code source est public sur GitHub à l'adresse https://github.com/Cap-go/capacitor-firebase/tree/main/packages/authentication et le package est gratuit à installer depuis npm. Les rapports de bugs et les pull requests sont les bienvenus.

Puis-je mettre à jour code utilisant Firebase Authentication sans passer par une revue de l'App Store ?

L'installation ou la mise à jour du plugin modifie le code natif, ce qui impose un nouveau build pour les stores. Ensuite, les changements JavaScript, HTML et CSS qui appellent le plugin peuvent être livrés instantanément via les live updates de Capgo.

Déployez les changements de Firebase Authentication sans attendre la validation de l'app

Une fois le plugin intégré à votre build de store, Capgo live updates déploie vos changements JavaScript, HTML et CSS aux utilisateurs en quelques minutes.

Commencez avec Capgo