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

L'autenticazione tramite link via email si basava in precedenza su Firebase Dynamic Links, che verrà ritirato il 25 agosto 2025. Abbiamo pubblicato una soluzione alternativa nell'Firebase AuthenticationSDK iOS versione 11.8.0 o successive. Se la tua app utilizza Firebase Dynamic Links, devi eseguire la migrazione al nuovo sistema basato su Firebase Hosting.

Eseguire 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 Autenticarsi 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 del nuovo dominio e per indicare a Firebase Authentication di iniziare a utilizzare il dominio Firebase Hosting per generare link per 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, utilizza le istruzioni nella sezione Personalizzare i link per il mobile e adatta i passaggi in modo che corrispondano al dominio che vuoi utilizzare.

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

    Devi configurare il dominio selezionato come dominio associato per i link dell'app. Per configurare il diritto nella tua app, apri la scheda Firma e funzionalità del target in Xcode e aggiungi i domini Firebase Hosting del passaggio precedente alla funzionalità Domini associati. Se utilizzi il dominio Firebase Hosting predefinito, questo sarà applinks:PROJECT_ID.firebaseapp.com.

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

    Un file di dominio associato è stato implementato 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 ulteriori informazioni, consulta la sezione Creare e ospitare i file di configurazione dei link universali.

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

    Quando sei pronto a gestire i nuovi link di dominio, puoi utilizzare l'SDK Firebase Admin per aggiornare la modalità di generazione dei 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 riscatta il link nell'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.

Utilizzare un dominio Firebase Hosting personalizzato

  1. Segui la Firebase Hostingguida 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, qualsiasi funzionalità Firebase Dynamic Links non sarà più supportata (ad esempio, gli utenti non possono 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.