Vous pouvez utiliser Firebase Authentication pour connecter un utilisateur en lui envoyant un e-mail contenant un lien sur lequel il peut cliquer pour se connecter. Au cours de ce processus, l'adresse e-mail de l'utilisateur est également validée.
La connexion par e-mail présente de nombreux avantages :
- Inscription et connexion simplifiées.
- Réduction du risque de réutilisation des mots de passe dans les applications, ce qui peut compromettre la sécurité, même pour des mots de passe bien choisis.
- La possibilité d'authentifier un utilisateur tout en vérifiant qu'il est le propriétaire légitime d'une adresse e-mail.
- Il suffit à l'utilisateur d'avoir un compte de messagerie accessible pour se connecter. Il n'est pas nécessaire d'être propriétaire d'un numéro de téléphone ou d'un compte de réseau social.
- Un utilisateur peut se connecter de manière sécurisée sans avoir à fournir (ou à mémoriser) un mot de passe, ce qui peut être fastidieux sur un appareil mobile.
- Un utilisateur existant qui s'est déjà connecté avec un identifiant d'adresse e-mail (mot de passe ou fédéré) peut être mis à niveau pour se connecter uniquement avec l'adresse e-mail. Par exemple, un utilisateur qui a oublié son mot de passe peut toujours se connecter sans avoir à le réinitialiser.
Avant de commencer
Utilisez Swift Package Manager pour installer et gérer les dépendances Firebase.
- Dans Xcode, à partir de votre projet d'application ouvert, accédez à File > Add Packages (Fichier > Ajouter des packages).
- Lorsque vous y êtes invité, ajoutez le dépôt du SDK des plates-formes Firebase pour Apple :
- Choisissez la bibliothèque Firebase Authentication.
- Ajoutez l'option
-ObjCà la section Other Linker Flags (Autres options de l'éditeur de liens) des paramètres de compilation de votre cible. - Lorsque vous avez terminé, Xcode commence à résoudre et à télécharger automatiquement vos dépendances en arrière-plan.
https://github.com/firebase/firebase-ios-sdk.git
Activer la connexion par lien par e-mail pour votre projet Firebase
Pour connecter les utilisateurs par lien d'e-mail, vous devez d'abord activer le fournisseur de messagerie et la méthode de connexion par lien d'e-mail pour votre projet Firebase :
Dans la console Firebase, accédez à Sécurité > Authentification.
Dans l'onglet Mode de connexion, activez le fournisseur de connexion Adresse e-mail/Mot de passe. Notez que la connexion par adresse e-mail/mot de passe doit être activée pour utiliser la connexion par lien envoyé par e-mail.
Dans la même section, activez le fournisseur Lien par e-mail (connexion sans mot de passe).
Cliquez sur Enregistrer.
Envoyer un lien d'authentification à l'adresse e-mail de l'utilisateur
Pour lancer le flux d'authentification, présentez à l'utilisateur une interface l'invitant à fournir son adresse e-mail, puis appelez sendSignInLink pour demander à Firebase d'envoyer le lien d'authentification à l'adresse e-mail de l'utilisateur.
Créez l'objet
ActionCodeSettings, qui fournit à Firebase des instructions sur la création du lien par e-mail. Attribuez aux champs suivants les valeurs correspondantes :url: lien profond à intégrer et tout état supplémentaire à transmettre. Si vous ne l'avez pas déjà fait, ajoutez votre domaine à la liste des domaines autorisés :Dans la console Firebase, accédez à Sécurité > Authentification > onglet Paramètres.
Dans la section Domaines autorisés, cliquez sur Ajouter un domaine, puis ajoutez votre domaine.
iOSBundleIDetandroidPackageName: aident Firebase Authentication à déterminer s'il doit créer un lien Web uniquement ou un lien mobile qui s'ouvre sur un appareil Android ou Apple.handleCodeInApp: définie sur "true". La procédure de connexion doit toujours être effectuée dans l'application, contrairement aux autres actions par e-mail hors bande (réinitialisation du mot de passe et validation de l'adresse e-mail). En effet, à la fin du flux, l'utilisateur doit être connecté et son état d'authentification doit être conservé dans l'application.linkDomain: lorsque des domaines de liens Hosting personnalisés sont définis pour un projet, spécifiez celui à utiliser lorsque le lien doit être ouvert par une application mobile spécifiée. Sinon, le domaine par défaut est automatiquement sélectionné (par exemple, ).PROJECT_ID.firebaseapp.comdynamicLinkDomain: obsolète. Ne spécifiez pas ce paramètre.
Swift
let actionCodeSettings = ActionCodeSettings() actionCodeSettings.url = URL(string: "https://www.example.com") // The sign-in operation has to always be completed in the app. actionCodeSettings.handleCodeInApp = true actionCodeSettings.setIOSBundleID(Bundle.main.bundleIdentifier!) actionCodeSettings.setAndroidPackageName("com.example.android", installIfNotAvailable: false, minimumVersion: "12")
Objective-C
FIRActionCodeSettings *actionCodeSettings = [[FIRActionCodeSettings alloc] init]; [actionCodeSettings setURL:[NSURL URLWithString:@"https://www.example.com"]]; // The sign-in operation has to always be completed in the app. actionCodeSettings.handleCodeInApp = YES; [actionCodeSettings setIOSBundleID:[[NSBundle mainBundle] bundleIdentifier]]; [actionCodeSettings setAndroidPackageName:@"com.example.android" installIfNotAvailable:NO minimumVersion:@"12"];
Pour en savoir plus sur
ActionCodeSettings, consultez la section Transmettre l'état dans les actions par e-mail.Demandez à l'utilisateur son adresse e-mail.
Envoyez le lien d'authentification à l'adresse e-mail de l'utilisateur et enregistrez l'adresse e-mail de l'utilisateur au cas où il se connecterait par e-mail sur le même appareil.
Swift
Auth.auth().sendSignInLink(toEmail: email, actionCodeSettings: actionCodeSettings) { error in // ... if let error = error { self.showMessagePrompt(error.localizedDescription) return } // The link was successfully sent. Inform the user. // Save the email locally so you don't need to ask the user for it again // if they open the link on the same device. UserDefaults.standard.set(email, forKey: "Email") self.showMessagePrompt("Check your email for link") // ... }
Objective-C
[[FIRAuth auth] sendSignInLinkToEmail:email actionCodeSettings:actionCodeSettings completion:^(NSError *_Nullable error) { // ... if (error) { [self showMessagePrompt:error.localizedDescription]; return; } // The link was successfully sent. Inform the user. // Save the email locally so you don't need to ask the user for it again // if they open the link on the same device. [NSUserDefaults.standardUserDefaults setObject:email forKey:@"Email"]; [self showMessagePrompt:@"Check your email for link"]; // ... }];
Terminez la connexion avec le lien envoyé par e-mail
Problèmes de sécurité
Pour éviter qu'un lien de connexion ne soit utilisé pour se connecter en tant qu'utilisateur non prévu ou sur un appareil non prévu, Firebase Auth exige que l'adresse e-mail de l'utilisateur soit fournie lors de la procédure de connexion. Pour que la connexion aboutisse, cette adresse e-mail doit correspondre à celle à laquelle le lien de connexion a été initialement envoyé.
Vous pouvez simplifier ce flux pour les utilisateurs qui ouvrent le lien de connexion sur l'appareil sur lequel ils ont demandé le lien, en stockant leur adresse e-mail localement lorsque vous envoyez l'e-mail de connexion. Utilisez ensuite cette adresse pour terminer le processus.
Une fois la connexion terminée, tout mécanisme de connexion non validé précédemment sera supprimé de l'utilisateur et toutes les sessions existantes seront invalidées. Par exemple, si quelqu'un a déjà créé un compte non validé avec la même adresse e-mail et le même mot de passe, le mot de passe de l'utilisateur sera supprimé pour empêcher l'usurpateur d'identité qui a revendiqué la propriété et créé ce compte non validé de se reconnecter avec le même compte.
Finaliser la connexion dans une application mobile Apple
Firebase Authentication utilise Firebase Hosting pour envoyer le lien par e-mail à un appareil mobile. Pour finaliser la connexion avec une application mobile, celle-ci doit être configurée pour détecter le lien d'application entrant, analyser le lien profond sous-jacent, puis finaliser la connexion. Pour en savoir plus, consultez la section sur les liens universels et les domaines associés sur iOS.
Configurer Firebase Hosting
Firebase Authentication utilise les domaines Firebase Hosting pour créer et envoyer un lien destiné à être ouvert dans une application mobile. Un domaine Firebase Hosting par défaut a déjà été configuré pour vous.
Configurez les domaines Firebase Hosting :
Dans la console Firebase, accédez à Hébergement et sans serveur > Hébergement.
Si vous souhaitez utiliser le domaine par défaut pour le lien d'e-mail qui s'ouvre dans les applications mobiles, accédez à votre site par défaut et notez votre domaine Hosting par défaut. Un domaine Hosting par défaut ressemble généralement à ceci :
.PROJECT_ID.firebaseapp.comVous aurez besoin de cette valeur lorsque vous configurerez votre application pour intercepter le lien entrant.
Si vous souhaitez utiliser un domaine personnalisé pour le lien de l'e-mail, vous pouvez en enregistrer un avec Firebase Hosting et l'utiliser pour le domaine du lien.
Configurer des applications Apple :
Vous devrez configurer le domaine choisi en tant que domaine associé pour les liens d'application. Pour configurer le droit d'accès dans votre application, ouvrez l'onglet Signing & Capabilities (Signature et fonctionnalités) de la cible dans Xcode, puis ajoutez les domaines Firebase Hosting de l'étape précédente à la fonctionnalité "Associated Domains" (Domaines associés). Si vous utilisez le domaine Firebase Hosting par défaut, il s'agit de
.applinks:PROJECT_ID.firebaseapp.comPour en savoir plus, consultez la page Supporting associated domains (Prendre en charge les domaines associés) sur le site de documentation d'Apple.
Valider le lien et se connecter
Après avoir reçu le lien comme décrit ci-dessus, vérifiez qu'il est destiné à l'authentification par lien d'e-mail et terminez la connexion.
Swift
if Auth.auth().isSignIn(withEmailLink: link) { Auth.auth().signIn(withEmail: email, link: self.link) { user, error in // ... } }
Objective-C
if ([[FIRAuth auth] isSignInWithEmailLink:link]) { [[FIRAuth auth] signInWithEmail:email link:link completion:^(FIRAuthDataResult * _Nullable authResult, NSError * _Nullable error) { // ... }]; }
Pour savoir comment gérer la connexion avec un lien par e-mail dans une application Android, consultez le guide Android.
Pour savoir comment gérer la connexion avec un lien par e-mail dans une application Web, consultez le guide Web.
Association/Réauthentification avec un lien par e-mail
Vous pouvez également associer cette méthode d'authentification à un utilisateur existant. Par exemple, un utilisateur précédemment authentifié auprès d'un autre fournisseur, tel qu'un numéro de téléphone, peut ajouter cette méthode de connexion à son compte existant.
La différence réside dans la deuxième moitié de l'opération :
Swift
let credential = EmailAuthCredential.credential(withEmail:email link:link) Auth.auth().currentUser?.link(with: credential) { authData, error in if (error) { // And error occurred during linking. return } // The provider was successfully linked. // The phone user can now sign in with their phone number or email. }
Objective-C
FIRAuthCredential *credential = [FIREmailAuthProvider credentialWithEmail:email link:link]; [FIRAuth auth].currentUser linkWithCredential:credential completion:^(FIRAuthDataResult *_Nullable result, NSError *_Nullable error) { if (error) { // And error occurred during linking. return; } // The provider was successfully linked. // The phone user can now sign in with their phone number or email. }];
Cela peut également être utilisé pour réauthentifier un utilisateur de lien par e-mail avant d'exécuter une opération sensible.
Swift
let credential = EmailAuthProvider.credential(withEmail:email link:link) Auth.auth().currentUser?.reauthenticate(with: credential) { authData, error in if (error) { // And error occurred during re-authentication. return } // The user was successfully re-authenticated. }
Objective-C
FIRAuthCredential *credential = [FIREmailAuthCredential credentialWithEmail:email link:link]; [FIRAuth auth].currentUser reauthenticateWithCredential:credential completion:^(FIRAuthDataResult *_Nullable result, NSError *_Nullable error) { if (error) { // And error occurred during re-authentication return; } // The user was successfully re-authenticated. }];
Toutefois, comme le flux peut se terminer sur un autre appareil sur lequel l'utilisateur d'origine n'est pas connecté, il est possible qu'il ne soit pas terminé. Dans ce cas, une erreur peut s'afficher pour l'utilisateur afin de l'obliger à ouvrir le lien sur le même appareil. Certains états peuvent être transmis dans le lien pour fournir des informations sur le type d'opération et l'UID de l'utilisateur.
Obsolète : validation basée sur Firebase Dynamic Links
Avant la version 11.8.0 du SDK iOS Firebase Authentication, la fonctionnalité de connexion par lien par e-mail s'appuyait sur Firebase Dynamic Links pour ouvrir les liens de connexion dans l'application appropriée. Ces liens de validation sont obsolètes, car Firebase Dynamic Links sera arrêté le 25 août 2025.
Si votre application utilise les liens de l'ancien style, vous devez migrer votre application vers le nouveau système basé sur Firebase Hosting.
Obsolète : Différencier l'adresse e-mail et le mot de passe du lien par e-mail
Si vous avez créé votre projet le 15 septembre 2023 ou après, la protection contre l'énumération des adresses e-mail est activée par défaut. Cette fonctionnalité améliore la sécurité des comptes utilisateur de votre projet, mais elle désactive la méthode fetchSignInMethodsForEmail(), que nous recommandions auparavant pour implémenter des flux d'identification d'abord.
Bien que vous puissiez désactiver la protection contre l'énumération d'adresses e-mail pour votre projet, nous vous le déconseillons.
Pour en savoir plus, consultez Activer ou désactiver la protection contre l'énumération des adresses e-mail.
Étapes suivantes
Lorsqu'un utilisateur se connecte pour la première fois, un compte utilisateur est créé et associé aux identifiants (nom d'utilisateur et mot de passe, numéro de téléphone ou informations du fournisseur d'authentification) avec lesquels il s'est connecté. Ce nouveau compte est stocké dans votre projet Firebase et peut être utilisé pour identifier un utilisateur dans toutes les applications de votre projet, quelle que soit la manière dont il se connecte.
-
Dans vos applications, vous pouvez obtenir les informations de base du profil de l'utilisateur à partir de l'objet
User. Consultez Gérer les utilisateurs. Dans vos règles de sécurité Firebase Realtime Database et Cloud Storage, vous pouvez obtenir l'ID utilisateur unique de l'utilisateur connecté à partir de la variable
authet l'utiliser pour contrôler les données auxquelles un utilisateur peut accéder.
Vous pouvez autoriser les utilisateurs à se connecter à votre application à l'aide de plusieurs fournisseurs d'authentification en associant les identifiants du fournisseur d'authentification à un compte utilisateur existant.
Pour déconnecter un utilisateur, appelez signOut:.
Swift
let firebaseAuth = Auth.auth() do { try firebaseAuth.signOut() } catch let signOutError as NSError { print("Error signing out: %@", signOutError) }
Objective-C
NSError *signOutError; BOOL status = [[FIRAuth auth] signOut:&signOutError]; if (!status) { NSLog(@"Error signing out: %@", signOutError); return; }
Vous pouvez également ajouter du code de gestion des exceptions pour l'ensemble des erreurs d'authentification. Consultez Gérer les erreurs.