Eseguire la migrazione dell'accesso tramite link email da Firebase Dynamic Links (iOS)

In precedenza, l'autenticazione tramite link via email si basava su Firebase Dynamic Links, che verrà chiuso il 25 agosto 2025. Abbiamo pubblicato una soluzione alternativa nell'SDK iOS versione 11.8.0 e successive. Se la tua app utilizza, devi eseguire la migrazione al nuovo sistema basato su .Firebase AuthenticationFirebase Dynamic LinksFirebase Hosting

Esegui la migrazione del dominio Firebase Dynamic Links associato a un dominio Firebase Hosting

In futuro, anziché utilizzare un dominio Firebase Dynamic Links, Firebase Authentication utilizzerà il dominio predefinito Firebase Hosting per il tuo progetto per creare link per il link via email e altre azioni di link out-of-band nelle app per dispositivi mobili. Ciò significa che anche la tua app dovrà essere aggiornata per utilizzare questo dominio predefinito come dominio associato per i link di autenticazione via email alla tua app per dispositivi mobili.

Puoi seguire le istruzioni riportate in Eseguire l'autenticazione con Firebase utilizzando il link via email sulle piattaforme Apple per aggiornare la tua app in modo che utilizzi il nuovo dominio predefinitoFirebase Hosting con provisioning automatico.

Segui queste istruzioni per gestire i link dal nuovo dominio e per indicare a Firebase Authentication di iniziare a utilizzare il Firebase Hosting dominio per generare link alle app per dispositivi mobili in futuro.

Se vuoi continuare a utilizzare uno dei tuoi domini Firebase Hosting personalizzati o anche il tuo dominio Firebase Dynamic Links personalizzato come nuovo dominio associato, segui le istruzioni nella sezione Personalizzare i link per dispositivi mobili e adatta i passaggi in modo che corrispondano al dominio che vuoi utilizzare.

  1. Collega il dominio Firebase Hosting al dominio associato dell'app.

    Dovrai configurare il dominio selezionato come dominio associato per i link dell'app. Per configurare l'autorizzazione nella tua app, apri la scheda Signing & Capabilities della destinazione in Xcode e aggiungi i dominiFirebase Hosting del passaggio precedente alla funzionalità Domini associati. Se utilizzi il dominio Firebase Hosting predefinito, sarà applinks:PROJECT_ID.firebaseapp.com.

    Per ulteriori informazioni, consulta la pagina Supporto dei domini associati nel sito di documentazione di Apple.

    Un file di dominio associato è stato implementato in tutti i tuoi Firebase Hosting domini. Per accedervi, vai a PROJECT_ID.firebaseapp.com/.well-known/apple-app-site-association. Questo file AASA può essere sovrascritto. Per ulteriori informazioni, consulta Creare e ospitare i file di configurazione dei link universali .

  2. Configura il progetto in modo che utilizzi i nuovi link.

    Quando è tutto pronto per gestire i nuovi link di dominio, puoi utilizzare l' SDK Firebase Admin per aggiornare la modalità di generazione dei link via email e indicare al nostro backend di iniziare a generare link utilizzando il nuovo Firebase Hosting dominio.

    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. Invia e riscatta il link via email.

    Invia il link di accesso via email come prima. Quando un utente finale fa clic sul link, verrà reindirizzato all'app, se installata, per completare l'accesso.

Puoi utilizzare un dominio Firebase Hosting personalizzato o riutilizzare il tuo dominio Firebase Dynamic Links personalizzato come nuovo dominio per i link per dispositivi mobili.

Utilizzare un dominio Firebase Hosting personalizzato

  1. Segui la Firebase Hosting guida per configurare un dominio personalizzato.
  2. Collega il dominio personalizzato al dominio associato dell'app.
  3. Invia un link di autenticazione all'indirizzo email dell'utente con un oggetto ActionCodeSettings aggiornato con un dominio personalizzato come linkDomain.
  1. Puoi riutilizzare uno qualsiasi dei tuoi Firebase Dynamic Links domini come dominio personalizzato. Tuttavia, qualsiasi funzionalità Firebase Dynamic Links non sarà più supportata (ad esempio, gli utenti non potranno essere reindirizzati all'app store se l'app non è installata sul loro dispositivo).
  2. Invia un link di autenticazione all'indirizzo email dell'utente con un oggetto ActionCodeSettings aggiornato con un dominio personalizzato come linkDomain.