Как отказаться от 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 Hosting, следуйте инструкциям в статье Выполнить аутентификацию с помощью Firebase с использованием ссылки в электронном письме на платформах Apple.

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

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

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

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

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

    Файл связанного домена развернут во всех доменах 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.