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

L'authentification par lien dans un e-mail reposait auparavant sur Firebase Dynamic Links, qui sera arrêté le 25 août 2025. Nous avons publié une solution alternative dans le Firebase Authentication iOS SDK version 11.8.0 ou ultérieure. Si votre application utilise Firebase Dynamic Links, vous devez la migrer vers le nouveau Firebase Hosting basé sur le système.

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 les plates-formes Apple pour mettre à jour votre application afin qu'elle utilise 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 Firebase Hosting domaine pour générer des liens vers des applications mobiles.

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 instructions de la section Personnaliser les liens mobiles et adaptez les étapes au domaine que vous souhaitez utiliser.

  1. Associez le domaine Firebase Hosting au domaine associé à votre application.

    Vous devez configurer le domaine sélectionné comme domaine associé pour les liens vers l'application. Pour configurer l'autorisation dans votre application, ouvrez l'onglet Signing & Capabilities (Signature et fonctionnalités) de la cible dans Xcode, puis ajoutez les domainesFirebase Hosting de l'étape précédente à la fonctionnalité Domaines associés. Si vous utilisez le domaine Firebase Hosting par défaut, il s'agit de applinks:PROJECT_ID.firebaseapp.com.

    Pour en savoir plus, consultez la section Supporting associated domains sur le site de documentation d'Apple.

    Un fichier de domaine associé a été déployé sous tous vos Firebase Hosting domaines. Pour y accéder, accédez à PROJECT_ID.firebaseapp.com/.well-known/apple-app-site-association. Ce fichier AASA peut être remplacé. Pour en savoir plus, consultez la section Créer et héberger vos fichiers de configuration Universal Links .

  2. Configurez 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 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. Envoyez et échangez le lien dans l'e-mail.

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

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é

  1. Suivez le Firebase Hosting guide pour configurer un domaine personnalisé.
  2. Associez le domaine personnalisé au domaine associé à votre application.
  3. Envoyez un lien d'authentification à l'adresse e-mail de l'utilisateur avec un objet ActionCodeSettings mis à jour et un domaine personnalisé comme linkDomain.
  1. Vous pouvez réutiliser l'un de vos Firebase Dynamic Links domaines comme domaine personnalisé. Toutefois, aucune fonctionnalité Firebase Dynamic Links ne sera plus compatible (par exemple, les utilisateurs ne pourront pas être redirigés vers l'App Store si l'application n'est pas installée sur leur appareil).
  2. Envoyez un lien d'authentification à l'adresse e-mail de l'utilisateur avec un objet ActionCodeSettings mis à jour et un domaine personnalisé comme linkDomain.