Google utilise la technologie IA pour traduire le contenu dans votre langue préférée. Les traductions générées par IA peuvent contenir des erreurs.

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

L'authentification par lien d'e-mail reposait auparavant sur Firebase Dynamic Links, qui sera supprimé le 25 août 2025. Nous avons publié une solution alternative dans le SDK Android Firebase Authentication version 23.2.0 ou ultérieure et Firebase BoM version 33.9.0 ou ultérieure. Si votre application utilise les liens d'ancien style et que vous souhaitez utiliser une autre méthode pour migrer votre application, consultez S'authentifier avec Firebase à l'aide d'un lien par e-mail sur 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 de BoM (Authentication v20.0.0 ou ultérieure, ou BoM v26.0.0 ou ultérieure) afin de 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 de votre projet pour créer des liens pour les liens par e-mail et d'autres actions de liens hors bande dans les applications mobiles. Cela signifie que vous devrez également mettre à jour votre application 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 page S'authentifier avec Firebase à l'aide d'un lien par 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 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 la procédure correspondant au domaine que vous souhaitez utiliser. Notez qu'une fois que vous aurez suivi les instructions de la section suivante, la fonctionnalité de liens profonds sur votre domaine personnalisé Firebase Dynamic Links sera supprimée. Seul le domaine lui-même sera conservé pour créer des liens d'e-mail.

Configurer votre application Android pour qu'elle gère votre lien Firebase Hosting
1. Pour gérer ces liens depuis votre application Android, vous devez spécifier le nom de package de votre application dans les paramètres du projet de la console Firebase. De plus, vous devez fournir les empreintes SHA-1 et SHA-256 du certificat de l'application.
2. Si vous souhaitez que ces liens Firebase Hosting redirigent vers une activité spécifique, vous devez 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", ainsi que 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 un rollback fluide, nous vous recommandons de conserver le filtre d'intent existant qui gère 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 Admin Firebase pour mettre à jour la façon dont vous souhaitez que les liens d'e-mail 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);
  }
};

Envoyer et utiliser le lien par 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 finaliser 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 guide Firebase Hosting pour configurer un domaine personnalisé.
Configurez votre application Android pour qu'elle gère votre lien Firebase Hosting. (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 avec un domaine personnalisé en tant que linkDomain.

Réutiliser votre domaine personnalisé Firebase Dynamic Links

Vous pouvez réutiliser n'importe lequel de vos domaines Firebase Dynamic Links en tant que 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 magasin d'applications si l'application n'est pas installée sur leur appareil).
Configurez votre application Android pour qu'elle gère votre lien Firebase Hosting (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 avec un domaine personnalisé en tant que linkDomain.