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

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

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

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

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

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

    Подробнее о том, как поддерживать связанные домены…

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

  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.