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

In precedenza, l'autenticazione tramite link email si basava su Firebase Dynamic Links, che verrà chiuso il 25 agosto 2025. Abbiamo pubblicato una soluzione alternativa nell'SDK Android Firebase Authentication versione 23.2.0+ e Firebase BoM versione 33.9.0+. Se la tua app utilizza i link in stile precedente e vuoi utilizzare un metodo alternativo per la migrazione, consulta Autenticarsi con Firebase utilizzando il link email in Android per utilizzare il nuovo sistema basato su Firebase Hosting.

Inoltre, se utilizzi l'Firebase Authentication SDK Android versione precedente alla 20.0.0 (o la Firebase BoM precedente alla 26.0.0) per gestire i flussi OAuth con Firebase Authentication, dovrai eseguire l'aggiornamento all'ultima versione dell'Authentication SDK o di BoM (Authentication versione 20.0.0+ o BoM versione 26.0.0+) per continuare a gestire i flussi OAuth in Firebase Authentication.

Migrare il 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 in Android per aggiornare i link della tua app mobile in modo che utilizzino il nuovo dominio predefinito con provisioning automatico Firebase Hosting.

Segui queste istruzioni per gestire i link del nuovo dominio e per indicare a Firebase Authentication di iniziare a utilizzare il nuovo dominio 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, segui i passaggi corrispondenti al dominio che vuoi utilizzare. Tieni presente che, dopo aver completato le istruzioni nella sezione seguente, la funzionalità di link diretto sul tuo Firebase Dynamic Links dominio personalizzato verrà rimossa; rimarrà solo il dominio stesso per la creazione di link email.

Configurare l'app per Android per gestire il link Firebase Hosting
1. Per gestire questi link dall'applicazione Android, il nome del pacchetto dell'app deve essere specificato nelle impostazioni del progetto della console Firebase.Firebase Inoltre, devono essere forniti l'SHA-1 e l'SHA-256 del certificato dell'applicazione.
2. Se vuoi che questi Firebase Hosting link reindirizzino a un'Activity specifica, dovrai configurare un filtro per intent nel file AndroidManifest.xml. Il filtro per intent deve intercettare Firebase Hosting link del tuo dominio. In 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>
```
Quando gli utenti aprono un link di hosting con il percorso "/__/auth/links" e lo schema e l'host specificati, l'app avvierà l'attività con questo filtro per intent per gestire il link.

Importante: per garantire un rollback senza problemi, ti consigliamo di mantenere il tuo filtro per intent esistente che gestisce Firebase Dynamic Links mentre provi la soluzione di link Firebase Hosting. La soluzione Firebase Dynamic Links sarà disponibile fino al 25 agosto 2025.

Configurare il progetto per utilizzare 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 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);
  }
};

Inviare e riscattare il link email

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

Personalizzare i link mobile

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

Utilizzare un dominio Firebase Hosting personalizzato

Segui la Firebase Hosting guida per configurare un dominio personalizzato.
Configura l'app per Android per gestire il link Firebase Hosting. (Istruzioni nella sezione precedente).
Invia un link di autenticazione all'indirizzo email dell'utente con un oggetto ActionCodeSettings aggiornato con un dominio personalizzato come linkDomain.

Riutilizzare il dominio Firebase Dynamic Links personalizzato

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 possono essere reindirizzati a uno store se l'app non è installata sul loro dispositivo).
Configura la tua app per Android per gestire il link Firebase Hosting (istruzioni nella sezione precedente).
Invia un link di autenticazione all'indirizzo email dell'utente con un oggetto ActionCodeSettings aggiornato con un dominio personalizzato come linkDomain.