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à disattivato il 25 agosto 2025. Abbiamo pubblicato una soluzione alternativa nell'SDK Firebase Authentication per iOS versione 11.8.0 e successive. Se la tua app utilizza Firebase Dynamic Links, devi eseguire la migrazione al nuovo sistema basato su Firebase 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 i link email e altre azioni di link out-of-band nelle app mobile. Ciò significa che anche la tua app dovrà essere aggiornata per utilizzare questo dominio predefinito come dominio associato per i link di autenticazione email alla tua app mobile.

Puoi seguire le istruzioni riportate in Autenticati con Firebase utilizzando il link email sulle piattaforme Apple per aggiornare la tua app in modo che utilizzi il nuovo dominio predefinito Firebase Hosting di cui è stato eseguito il provisioning automatico.

Segui le istruzioni riportate di seguito per gestire i link dal nuovo dominio e per indicare a Firebase Authentication di iniziare a utilizzare il dominio Firebase Hosting per generare link alle app mobile 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 riportate nella sezione Personalizza i link mobile e adatta i passaggi in base al dominio che vuoi utilizzare.

  1. Collega il dominio Firebase Hosting al dominio associato alla tua app.

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

    Per saperne di più, consulta Supporto dei domini associati sul sito della documentazione di Apple.

    È stato eseguito il deployment di un file di dominio associato in tutti i tuoi domini Firebase Hosting. Per accedervi, vai a PROJECT_ID.firebaseapp.com/.well-known/apple-app-site-association. Questo file AASA può essere sovrascritto. Per saperne di più, consulta Crea e ospita 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 il modo in cui vuoi che vengano generati i link email e indicare al nostro backend di iniziare a generare link utilizzando il nuovo dominio 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. Invia e utilizza il link via email.

    Invia il link di accesso via email come prima. Quando un utente finale fa clic sul link, viene 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 dei link mobile.

Utilizza un dominio Firebase Hosting personalizzato

  1. Segui la guida di Firebase Hosting per configurare un dominio personalizzato.
  2. Collega il dominio personalizzato al dominio associato alla tua 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 domini Firebase Dynamic Links come dominio personalizzato. Tuttavia, le funzionalità di Firebase Dynamic Links non saranno più supportate (ad esempio, gli utenti non possono essere reindirizzati allo 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.