Перенести вход по ссылке электронной почты из Firebase Dynamic Links (iOS)

Ранее аутентификация по ссылкам электронной почты использовала Firebase Dynamic Links , которая будет отключена 25 августа 2025 года . Мы опубликовали альтернативное решение в Firebase Authentication iOS SDK версии 11.8.0+. Если ваше приложение использует Firebase Dynamic Links , вам следует перенести его на новую систему на базе Firebase Hosting .

Перенесите связанный домен Firebase Dynamic Links на домен Firebase Hosting

В дальнейшем вместо домена Firebase Dynamic Links Firebase Authentication будет использовать домен Firebase Hosting по умолчанию для вашего проекта для создания ссылок на электронную почту и других действий, связанных с внешними ссылками, в мобильных приложениях. Это означает, что ваше приложение также потребуется обновить, чтобы использовать этот домен по умолчанию в качестве связанного домена для ссылок аутентификации электронной почты в вашем мобильном приложении.

Вы можете следовать инструкциям в статье «Аутентификация в Firebase с использованием ссылки электронной почты на платформах Apple» , чтобы обновить свое приложение и использовать новый автоматически предоставляемый домен Firebase Hosting по умолчанию.

Используйте следующие инструкции для обработки ссылок с нового домена и указания Firebase Authentication начать использовать домен Firebase Hosting для создания ссылок мобильных приложений в будущем.

Если вы хотите продолжить использовать любой из ваших пользовательских доменов Firebase Hosting или даже ваш пользовательский домен Firebase Dynamic Links в качестве нового связанного домена, следуя инструкциям в разделе «Настройка мобильных ссылок» , адаптируйте шаги в соответствии с предполагаемым доменом, который вы хотите использовать.

  1. Свяжите домен Firebase Hosting с доменом вашего приложения.

    Вам необходимо настроить выбранный домен как ассоциированный домен для ссылок приложений. Чтобы настроить права доступа в вашем приложении, откройте вкладку «Подписывание и возможности» целевого приложения в Xcode и добавьте домены Firebase Hosting из предыдущего шага в возможность «Связанные домены». При использовании домена Firebase Hosting по умолчанию это будет applinks: PROJECT_ID .firebaseapp.com .

    Дополнительную информацию см. в разделе Поддержка связанных доменов на сайте документации Apple.

    Файл связанного домена был развёрнут на всех ваших доменах Firebase Hosting . Чтобы получить к нему доступ, перейдите по адресу PROJECT_ID .firebaseapp.com/.well-known/apple-app-site-association . Этот файл AASA можно перезаписать; подробнее см. в статье Создание и размещение файлов конфигурации Universal Links .

  2. Настройте свой проект для использования новых ссылок.

    Когда вы будете готовы обрабатывать новые доменные ссылки, вы можете использовать Firebase Admin SDK, чтобы обновить способ генерации ссылок электронной почты и дать команду нашему бэкэнду начать генерацию ссылок с использованием нового домена 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. Отправьте и активируйте ссылку по электронной почте.

    Отправьте ссылку для входа по электронной почте, как и раньше. При нажатии на ссылку конечный пользователь будет перенаправлен в приложение (если оно установлено) для завершения входа.

Вы можете использовать пользовательский домен Firebase Hosting или повторно использовать свой пользовательский домен Firebase Dynamic Links в качестве нового домена мобильных ссылок.

Используйте собственный домен Firebase Hosting

  1. Чтобы настроить собственный домен, следуйте руководству Firebase Hosting .
  2. Свяжите пользовательский домен с доменом, связанным с вашим приложением.
  3. Отправьте ссылку аутентификации на адрес электронной почты пользователя с обновленным объектом ActionCodeSettings с пользовательским доменом linkDomain .
  1. Вы можете повторно использовать любой из своих доменов Firebase Dynamic Links в качестве своего собственного домена. Однако функциональность Firebase Dynamic Links больше не будет поддерживаться (например, пользователи не смогут перенаправляться в магазин приложений, если приложение не установлено на их устройстве).
  2. Отправьте ссылку аутентификации на адрес электронной почты пользователя с обновленным объектом ActionCodeSettings с пользовательским доменом linkDomain .