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

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

De plus, si vous utilisez le Firebase Authentication SDK pour Android version antérieure à la version 20.0.0 (ou la Firebase BoM version antérieure à 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 de BoM(Authentication version 20.0.0+ ou BoM version 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 Firebase Dynamic Links domaine, Firebase Authentication utilisera le Firebase Hosting domaine par défaut pour votre projet afin de créer des liens pour les liens dans les e-mails et d'autres actions de lien hors bande dans les applications mobiles. Cela signifie que votre application devra également être mise à jour pour utiliser 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 la section S'authentifier avec Firebase à l'aide d'un lien dans un e-mail sur 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 demander à Firebase Authentication de commencer à utiliser le nouveau domaine pour générer des liens d'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'une fois les instructions de la section suivante suivies, la fonctionnalité de lien profond de votre domaine personnalisé Firebase Dynamic Links sera supprimée. Seul le domaine lui-même restera disponible pour créer des liens dans les e-mails.

Configurer votre application Android pour qu'elle gère votre lienFirebase Hosting
1. Pour gérer ces liens depuis votre application Android, le nom de package de votre application doit être spécifié dans les Firebase paramètres du projet de la console. De plus, les empreintes SHA-1 et SHA-256 du certificat d'application doivent être fournies.
2. Si vous souhaitez que ces Firebase Hosting liens soient redirigés vers une activité spécifique, vous devrez configurer un filtre d'intent dans votre AndroidManifest.xml fichier. Le filtre d'intent doit intercepter Firebase Hosting les liens 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 "/__/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.

Important : Pour garantir une restauration sans problème, nous vous recommandons de conserver votre filtre d'intent existant qui gère les Firebase Dynamic Links lorsque vous essayez la solution de lien Firebase Hosting. La solution Firebase Dynamic Links sera disponible jusqu'au 25 août 2025.

Configurer votre projet pour qu'il utilise les nouveaux liens

Lorsque vous êtes prêt à gérer les nouveaux liens de domaine, vous pouvez utiliser le SDK Firebase Admin pour modifier la façon dont vous souhaitez générer les liens dans les e-mails et demander à notre backend de commencer à générer des liens à l'aide du nouveau Firebase Hosting domaine.

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

Envoyer et utiliser le lien dans l'e-mail

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

Personnaliser vos liens mobiles

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

Utiliser un domaine Firebase Hosting personnalisé

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

Réutiliser votre domaine personnalisé Firebase Dynamic Links

Vous pouvez réutiliser l'un de vos Firebase Dynamic Links domaines comme domaine personnalisé. Toutefois, les fonctionnalités Firebase Dynamic Links ne seront plus compatibles (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).
Configurez votre application Android pour qu'elle gère votre Firebase Hosting lien (instructions dans la section précédente ci-dessus).
Envoyez un lien d'authentification à l'adresse e-mail de l'utilisateur avec un objet ActionCodeSettings mis à jour et un domaine personnalisé comme linkDomain.