Przenoszenie logowania przez link e-mail z Linków dynamicznych Firebase (iOS)

Uwierzytelnianie za pomocą linku w e-mailu wcześniej opierało się na usłudze Firebase Dynamic Links, która zostanie wyłączona 25 sierpnia 2025 r. Opublikowaliśmy alternatywne rozwiązanie w Firebase Authentication pakiecie SDK na iOS w wersji 11.8.0 lub nowszej. Jeśli Twoja aplikacja korzysta z Firebase Dynamic Links, musisz ją przenieść do nowego systemu opartego na Firebase Hosting.

Przenoszenie powiązanej domeny Firebase Dynamic Links do domeny Firebase Hosting

Od teraz zamiast domeny Firebase Dynamic Links usługa Firebase Authentication będzie używać domyślnej domeny Firebase Hosting Twojego projektu do tworzenia linków do e-maili i innych działań związanych z linkami poza pasmem w aplikacjach mobilnych. Oznacza to, że musisz też zaktualizować aplikację, aby używała tej domeny domyślnej jako domeny powiązanej na potrzeby linków uwierzytelniania poczty e-mail do aplikacji mobilnej.

Aby zaktualizować aplikację i używać nowej, automatycznie udostępnionej domeny domyślnej Firebase Hosting, postępuj zgodnie z instrukcjami podanymi w artykule Uwierzytelnianie za pomocą Firebase przy użyciu linku e-mail na platformach Apple.

Skorzystaj z poniższych instrukcji, aby obsługiwać linki z nowej domeny i poinstruować Firebase Authentication, aby od teraz używał domeny Firebase Hosting do generowania linków do aplikacji mobilnych.

Jeśli chcesz nadal używać dowolnej z niestandardowych domen Firebase Hosting lub nawet niestandardowej domeny Firebase Dynamic Links jako nowej powiązanej domeny, postępuj zgodnie z instrukcjami podanymi w sekcji Dostosowywanie linków mobilnych, dostosowując kroki do domeny, której chcesz używać.

  1. Połącz domenę Firebase Hosting z domeną powiązaną z aplikacją.

    Musisz skonfigurować wybraną domenę jako domenę powiązaną z linkami do aplikacji. Aby skonfigurować uprawnienia w aplikacji, otwórz kartę Signing & Capabilities (Podpisywanie i funkcje) celu w Xcode i dodaj domeny Firebase Hosting z poprzedniego kroku do funkcji powiązanych domen. Jeśli używasz domyślnej domeny Firebase Hosting, będzie to applinks:PROJECT_ID.firebaseapp.com.

    Więcej informacji znajdziesz w artykule Supporting associated domains (Obsługa powiązanych domen) w witrynie z dokumentacją Apple.

    Plik powiązanej domeny został wdrożony we wszystkich Twoich domenach Firebase Hosting. Aby uzyskać do niego dostęp, otwórz PROJECT_ID.firebaseapp.com/.well-known/apple-app-site-association. Ten plik AASA można zastąpić. Więcej informacji znajdziesz w artykule Tworzenie i hostowanie plików konfiguracji uniwersalnych linków.

  2. Skonfiguruj projekt tak, aby używał nowych linków.

    Gdy będziesz gotowy(-a) do obsługi nowych linków do domeny, możesz użyć pakietu Firebase Admin SDK, aby zaktualizować sposób generowania linków do e-maili i poinstruować nasz backend, aby zaczął generować linki przy użyciu nowej domeny 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. Wyślij i wykorzystaj link z e-maila.

    Wyślij link logowania e-mailem tak jak wcześniej. Gdy użytkownik kliknie link, zostanie przekierowany do aplikacji (jeśli jest zainstalowana), aby dokończyć logowanie.

Możesz użyć domeny niestandardowej Firebase Hosting lub ponownie użyć domeny niestandardowej Firebase Dynamic Links jako nowej domeny linków mobilnych.

Używanie własnej domeny Firebase Hosting

  1. Aby skonfigurować własną domenę, postępuj zgodnie z instrukcjami Firebase Hosting.
  2. Połącz własną domenę z domeną powiązaną z aplikacją.
  3. Wyślij link uwierzytelniający na adres e-mail użytkownika ze zaktualizowanym obiektem ActionCodeSettings z własną domeną jako linkDomain.
  1. Możesz ponownie użyć dowolnej domeny Firebase Dynamic Links jako domeny niestandardowej. Jednak funkcje Firebase Dynamic Links nie będą już obsługiwane (na przykład użytkownicy nie będą mogli zostać przekierowani do sklepu z aplikacjami, jeśli aplikacja nie jest zainstalowana na ich urządzeniu).
  2. Wyślij link uwierzytelniający na adres e-mail użytkownika ze zaktualizowanym obiektem ActionCodeSettings z własną domeną jako linkDomain.