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

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

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

W przyszłości zamiast domeny Firebase Dynamic Links usługa Firebase Authentication będzie używać domyślnej domeny Firebase Hosting w Twoim projekcie do tworzenia linków do linków w e-mailach i innych działań związanych z linkami poza pasmem w aplikacjach mobilnych. Oznacza to, że aplikacja będzie musiała zostać zaktualizowana, aby używać tej domyślnej domeny jako powiązanej domeny dla linków uwierzytelniających w e-mailach do aplikacji mobilnej.

Aby zaktualizować aplikację tak, aby używała nowej, automatycznie udostępnionej Firebase Hosting domyślnej domeny, postępuj zgodnie z instrukcjami w artykule Uwierzytelnianie w Firebase za pomocą linku w e-mailu na platformach Apple.

Aby obsługiwać linki z nowej domeny i po instruować Firebase Authentication, aby zaczęła używać domeny Firebase Hosting do generowania linków do aplikacji mobilnych, postępuj zgodnie z tymi instrukcjami.

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

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

    Musisz skonfigurować wybraną domenę jako powiązaną domenę dla linków aplikacji. Aby skonfigurować uprawnienie w aplikacji, otwórz kartę Signing & Capabilities w Xcode i dodaj Firebase Hosting domeny z poprzedniego kroku do możliwości Associated Domains (Powiązane domeny). Jeśli używasz domyślnej domeny Firebase Hosting, będzie to applinks:PROJECT_ID.firebaseapp.com.

    Więcej informacji znajdziesz w dokumentacji Apple na stronie Supporting associated domains (Obsługa powiązanych domen).

    Plik powiązanej domeny został wdrożony we wszystkich Twoich Firebase Hosting domenach. 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 konfiguracyjnych uniwersalnych linków .

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

    Gdy będziesz gotowy do obsługi nowych linków do domen, możesz użyć pakietu Firebase Admin SDK, aby zaktualizować sposób generowania linków w e-mailach i poinstruować nasz backend, aby zaczął generować linki przy użyciu nowej Firebase Hosting domeny.

    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 w e-mailu.

    Wyślij link do logowania przez e-mail 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ć niestandardowej domeny Firebase Hosting lub ponownie wykorzystać niestandardową Firebase Dynamic Links domenę jako nową domenę linków mobilnych.

Używanie niestandardowej domenyFirebase Hosting

  1. Aby skonfigurować własną domenę, postępuj zgodnie z instrukcjami w przewodniku Firebase Hosting.
  2. Połącz domenę niestandardową z powiązaną domeną aplikacji.
  3. Wyślij link uwierzytelniający na adres e-mail użytkownika z zaktualizowanym obiektem ActionCodeSettings z własną domeną jako linkDomain.
  1. Jako domeny niestandardowej możesz użyć dowolnej domeny Firebase Dynamic Links. Jednak żadna funkcja Firebase Dynamic Links nie będzie już obsługiwana (np. użytkownicy nie będą mogli być przekierowywani 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 z zaktualizowanym obiektem ActionCodeSettings z własną domeną jako linkDomain.