Allez directement au contenu principal
@capgo/capacitor-authentification Firebase Authentification et sécurité Source

Plugins de la plateforme plugin Capacitor

plugin Capacitor pour l'authentification Firebase

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 l'authentification Firebase dans Capacitor

Utilisation de @capgo/capacitor-authentification-firebase

Le plugin Capacitor pour l'authentification Firebase.

Installer

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

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

Importer

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

API en un coup d'œil

Méthode Description
applyActionCode Applique une vérification code envoyée à l'utilisateur par email.
confirmPasswordReset Completes the password reset process.
confirmVerificationCode Termine le processus de vérification du numéro de téléphone.
createUserWithEmailAndPassword Crée un nouveau compte utilisateur avec adresse e-mail et mot de passe. Si le nouveau compte a été créé, l'utilisateur est connecté automatiquement.
deleteUser Supprime et déconnecte l'utilisateur.
fetchSignInMethodsForEmail Récupère les méthodes de connexion pour une adresse e-mail.
getCurrentUser Récupère l'utilisateur actuellement connecté.
getPendingAuthResult Returns le SignInResult if votre application a lancé une session de connexion web et que le système a nettoyé l'application pendant l'exécution en arrière-plan.
getIdToken Récupère le jeton d'authentification Firebase ID pour l'utilisateur actuellement connecté.
getIdTokenResult Returns un jeton Web JSON désérialisé (JWT) utilisé pour identifier l'utilisateur à un service Firebase.
getRedirectResult Returns le SignInResult du flux de connexion basé sur la redirection.
getTenantId Obtenez l'ID de locataire.
isSignInWithEmailLink Vérifiez si un lien entrant est une session de connexion par email appropriée pour signInWithEmailLink.
linkWithApple Liens le compte utilisateur avec le fournisseur d'authentification Apple.
linkWithEmailAndPassword Liens le compte utilisateur avec le fournisseur d'authentification Email.
linkWithEmailLink Liens le compte utilisateur avec le fournisseur d'authentification Email.
linkWithFacebook Liens le compte utilisateur avec le fournisseur d'authentification Facebook.
linkWithGameCenter Liens l'account utilisateur avec le fournisseur d'authentification Game Center.
linkWithGithub Liens l'account utilisateur avec le fournisseur d'authentification GitHub.
linkWithGoogle Liens l'account utilisateur avec le fournisseur d'authentification Google.
linkWithMicrosoft Liens l'account utilisateur avec le fournisseur d'authentification Microsoft.
linkWithOpenIdConnect Liens l'account utilisateur avec un fournisseur d'authentification OpenID Connect.
linkWithPhoneNumber Liens l'account utilisateur avec le fournisseur d'authentification du numéro de téléphone.
linkWithPlayGames Liens l'account utilisateur avec le fournisseur d'authentification Play Games.
linkWithTwitter Liens l'account utilisateur avec le fournisseur d'authentification Twitter.
linkWithYahoo Liens l'account utilisateur avec le fournisseur d'authentification Yahoo.
reload Rafraîchit les données du compte utilisateur, si connecté.
revokeAccessToken Révoque l'access token spécifié. Actuellement, uniquement pris en charge pour les jetons d'accès OAuth Apple.
sendEmailVerification Envoie un e-mail de vérification à l'utilisateur actuellement connecté.
sendPasswordResetEmail Envoie un courriel de réinitialisation de mot de passe.
sendSignInLinkToEmail S'envoie un lien de connexion par courriel à l'utilisateur avec l'adresse e-mail spécifiée.
setLanguageCode Fixe la langue utilisateur code pour les opérations d'authentification.
setPersistence Fixe le type de persistance pour la session d'authentification enregistrée actuellement.
setTenantId Fixe l'ID de locataire.
signInAnonymously Se connecte en tant qu'utilisateur anonyme.
signInWithApple Démarrer la procédure de connexion Apple.
signInWithCustomToken Démarrer la procédure de connexion Token personnalisé.
signInWithEmailAndPassword Démarrer la procédure de connexion avec un e-mail et un mot de passe.
signInWithEmailLink Se connecte avec un e-mail et un lien de connexion par courriel.
signInWithFacebook Démarrer la procédure de connexion Facebook.
signInWithGameCenter Démarrer la procédure de connexion Game Center.
signInWithGithub Démarre le flux de connexion GitHub.
signInWithGoogle Démarre le flux de connexion Google.
signInWithMicrosoft Démarre le flux de connexion Microsoft.
signInWithOpenIdConnect Démarre le flux de connexion OpenID Connect.
signInWithPhoneNumber Démarre le flux de connexion à l'aide d'un numéro de téléphone.
signInWithPlayGames Démarre le flux de connexion Play Games.
signInWithTwitter Démarre le flux de connexion Twitter.
signInWithYahoo Démarre le flux de connexion Yahoo.
signOut Démarre le flux de déconnexion.
unlink Découple un fournisseur d'un compte utilisateur.
updateEmail Met à jour l'adresse e-mail de l'utilisateur actuellement connecté.
updatePassword Met à jour le mot de passe de l'utilisateur actuellement connecté.
updateProfile Mise à jour des données de profil de l'utilisateur.
useAppLanguage Mise par défaut de la langue de l'application code.
useEmulator Configurez votre application pour communiquer avec l'émulateur d'authentification.
verifyBeforeUpdateEmail Vérifiez l'adresse e-mail nouvelle avant de mettre à jour l'adresse e-mail de l'utilisateur actuellement connecté.
checkAppTrackingTransparencyPermission Vérifiez l'état actuel de la transparence de suivi de l'application.
requestAppTrackingTransparencyPermission Ouvrez le dialogue système pour autoriser la transparence de suivi de l'application.

Exemples

applyActionCode()

Mettez en œuvre une vérification code envoyée par e-mail à l'utilisateur.

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

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

confirmPasswordReset()

Completes the password reset process.

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

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

confirmVerificationCode()

Terminez 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éez un nouveau compte utilisateur avec e-mail et mot de passe. Si le nouveau compte a été créé, l'utilisateur est connecté automatiquement.

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

Supprimez et déconnectez l'utilisateur.

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

La table ci-dessus liste les 59 méthodes de base. Les aides aux écouteurs et aux versions, ainsi que le contrat complet de chaque méthode, sont documentés dans le GitHub dépôt.

Écoutez les événements

addListener retourne un gestionnaire. Appelez handle.remove() lorsque l'écran est démonté, ou FirebaseAuthentication.removeAllListeners() pour supprimer tous les écouteurs.

Référence complète

Continuez à partir de l'utilisation de @capgo/capacitor-firebase-authentication

If vous utilisez Utilisation de @capgo/capacitor-firebase-authentication pour planifier l'authentification et les flux de compte, connectez-l’avec @capgo/capacitor-connexion-social 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-biometrique pour les détails d'implémentation dans @capgo/capacitor-native-biometric, Deux facteurs d'authentification pour les détails d'implémentation dans Deux facteurs d'authentification, et SSO (Entreprise) pour les détails d'implémentation dans SSO (Entreprise).

FAQ

FAQ du plugin d'authentification Firebase

Comment installer le plugin d'authentification Firebase dans une application Capacitor ?

Exécutez la commande « bun add @capgo/capacitor-firebase-authentication » (ou « npm install @capgo/capacitor-firebase-authentication »), puis exécutez « bunx cap sync » afin que les projets iOS et Android prennent en compte les code natifs. Importez-l’à partir de « @capgo/capacitor-firebase-authentication » dans votre application code.

Le package @capgo/capacitor-firebase-authentication fonctionne-t-il avec React, Vue et Angular ?

Oui. L'authentification Firebase est un package Capacitor, il fonctionne donc avec tout framework web qui tourne à l'intérieur de Capacitor, y compris Ionic, React, Vue, Angular, Svelte et JavaScript pur.

Quelle version de Capacitor est prise en charge 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, plugin v8 avec Capacitor 8). La table de compatibilité dans le README du GitHub liste les versions maintenues.

Le package @capgo/capacitor-firebase-authentication est-il gratuit et open source ?

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

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

Installing or upgrading the plugin changes native code, so it needs a new store build. After that, JavaScript, HTML and CSS changes that call the plugin can ship instantly with Capgo live updates.

Expédier les modifications d'authentification Firebase sans attendre la revue de l'application

Une fois le plugin intégré à votre magasin de build, les mises à jour en direct Capgo poussent vos modifications de JavaScript, HTML et CSS vers les utilisateurs en quelques minutes.

Commencez par Capgo