Migrer la connexion par lien e-mail depuis Firebase Dynamic Links (Android)

L'authentification par lien envoyé par e-mail reposait auparavant sur Firebase Dynamic Links, qui sera désactivé le 25 août 2025. Nous avons publié une solution alternative dans les versions 23.2.0+ du SDK Android Firebase Authentication et 33.9.0+ Firebase BoM. Si votre application utilise les anciens liens de style et que vous souhaitez utiliser une autre méthode pour la migrer, consultez S'authentifier avec Firebase à l'aide d'un lien par e-mail dans Android pour utiliser le nouveau système basé sur Firebase Hosting.

De plus, si vous utilisez le SDK Android Firebase Authentication antérieur à la version 20.0.0 (ou Firebase BoM antérieur à la version 26.0.0) pour gérer les flux OAuth avec Firebase Authentication, vous devrez passer à la dernière version du SDK Authentication ou BoM (Authentication 20.0.0+ ou BoM 26.0.0+) pour continuer à gérer les flux OAuth dans Firebase Authentication.

Migrer votre domaine Firebase Dynamic Links associé vers un domaine Firebase Hosting

À l'avenir, au lieu d'utiliser un domaine Firebase Dynamic Links, Firebase Authentication utilisera le domaine par défaut Firebase Hosting pour votre projet afin de créer des liens pour les actions de lien par e-mail et autres actions de lien hors bande dans les applications mobiles. Cela signifie que vous devrez également mettre à jour votre application pour qu'elle utilise ce domaine par défaut comme domaine associé pour les liens d'authentification par e-mail vers votre application mobile.

Vous pouvez suivre les instructions de l'article S'authentifier avec Firebase à l'aide d'un lien par e-mail dans Android pour mettre à jour les liens de votre application mobile afin d'utiliser le nouveau domaine par défaut Firebase Hosting provisionné automatiquement.

Suivez les instructions ci-dessous pour gérer les liens du nouveau domaine et indiquer à Firebase Authentication de commencer à utiliser le nouveau domaine pour générer des liens vers l'application mobile à l'avenir.

Si vous souhaitez continuer à utiliser l'un de vos domaines Firebase Hosting personnalisés ou même votre domaine Firebase Dynamic Links personnalisé comme nouveau domaine associé, suivez les étapes correspondant au domaine que vous souhaitez utiliser. Notez qu'après avoir suivi les instructions de la section suivante, la fonctionnalité de lien profond sur votre domaine personnalisé Firebase Dynamic Links sera supprimée. Seul le domaine lui-même restera disponible pour créer des liens vers des adresses e-mail.

1. Configurer votre application Android pour qu'elle gère votre lien Firebase Hosting

   1. Pour gérer ces liens depuis votre application Android, le nom du package de votre application doit être spécifié dans les paramètres du projet de la console Firebase. De plus, les empreintes SHA-1 et SHA-256 du certificat de l'application doivent être fournies.

   2. Si vous souhaitez que ces liens Firebase Hosting redirigent vers une activité spécifique, vous devrez configurer un filtre d'intent dans votre fichier AndroidManifest.xml. Le filtre d'intent doit intercepter les liens Firebase Hosting de votre domaine. Dans AndroidManifest.xml :

      <intent-filter android:autoVerify="true">
        <action android:name="android.intent.action.VIEW" />
        <category android:name="android.intent.category.BROWSABLE" />
        <category android:name="android.intent.category.DEFAULT" />
        <data
          android:scheme="https"
          android:host="PROJECT_ID.firebaseapp.com or a custom hosting domain"
          android:pathPrefix="/__/auth/links" />
      </intent-filter>
      

   Lorsque les utilisateurs ouvrent un lien d'hébergement avec le chemin d'accès "/__/auth/links" et le schéma et l'hôte que vous spécifiez, votre application démarre l'activité avec ce filtre d'intent pour gérer le lien.

2. Configurer votre projet pour utiliser les nouveaux liens

   Lorsque vous serez prêt à gérer les nouveaux liens de domaine, vous pourrez utiliser le SDK Firebase Admin pour indiquer comment vous souhaitez que les liens d'e-mails soient générés et demander à notre backend de commencer à générer des liens à l'aide du nouveau domaine Firebase Hosting.

   import { getAuth } from 'firebase-admin/auth';
   
   const updateEmailAuthDomain = async () => {
     const updateRequest = {
       mobileLinksConfig: {
         domain: 'HOSTING_DOMAIN',
       },
     };
   
     const projectConfigManager = getAuth().projectConfigManager();
   
     try {
       const response = await projectConfigManager.updateProjectConfig(updateRequest);
       // Updated project config
       console.log('Project configuration updated successfully:', response);
     } catch (error) {
       console.error('Error updating the project:', error);
     }
   };
   

3. Envoyer et utiliser le lien de l'e-mail

   Envoyez le lien de connexion par e-mail comme d'habitude. Lorsque l'utilisateur final clique sur le lien, il est redirigé vers l'application (si elle est installée) pour finaliser la connexion.

Personnaliser vos liens pour mobile

Vous pouvez utiliser un domaine Firebase Hosting personnalisé ou réutiliser votre domaine Firebase Dynamic Links personnalisé comme nouveau domaine pour les liens mobiles.

Utiliser un domaine Firebase Hosting personnalisé

1. Suivez le guide Firebase Hosting pour configurer un domaine personnalisé.
2. Configurez votre application Android pour qu'elle gère votre lien Firebase Hosting. (instructions dans la section précédente ci-dessus).
3. Envoyez un lien d'authentification à l'adresse e-mail de l'utilisateur avec un objet ActionCodeSettings mis à jour avec un domaine personnalisé tel que linkDomain.

Réutiliser votre domaine Firebase Dynamic Links personnalisé

1. Vous pouvez réutiliser l'un de vos domaines Firebase Dynamic Links comme domaine personnalisé. Toutefois, les fonctionnalités Firebase Dynamic Links ne seront plus prises en charge (par exemple, les utilisateurs ne pourront pas être redirigés vers un app store si l'application n'est pas installée sur leur appareil).
2. Configurez votre application Android pour qu'elle gère votre lien Firebase Hosting (instructions dans la section précédente ci-dessus).
3. Envoyez un lien d'authentification à l'adresse e-mail de l'utilisateur avec un objet ActionCodeSettings mis à jour avec un domaine personnalisé tel que linkDomain.