Как отказаться от Firebase Dynamic Links для входа по ссылке в электронном письме (Android)

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

Если вы используете Android SDK Firebase Authentication версии ниже 20.0.0 (или Firebase BoM версии ниже 26.0.0) для управления потоками OAuth с помощью Firebase Authentication, вам нужно перейти на последнюю версию SDK Authentication или BoM (Authentication 20.0.0+ или BoM 26.0.0+), чтобы продолжить управлять потоками OAuth в Firebase Authentication.

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

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

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

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

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

1. Как настроить приложение для Android для обработки ссылки Firebase Hosting

   1. Чтобы обрабатывать такие ссылки в приложении для Android, укажите название пакета приложения в настройках проекта Firebase. Кроме того, необходимо указать SHA-1 и SHA-256 сертификата приложения.

   2. Если вы хотите, чтобы эти Firebase Hosting ссылки перенаправляли на определенное действие, вам нужно настроить фильтр интентов в файле AndroidManifest.xml. Фильтр интентов должен перехватывать ссылки Firebase Hosting вашего домена. В AndroidManifest.xml:

      <intent-filter android:autoVerify="true">
        <action android:name="android.intent.action.VIEW" />
        <category android:name="android.intent.category.BROWSABLE" />
        <category android:name="android.intent.category.DEFAULT" />
        <data
          android:scheme="https"
          android:host="PROJECT_ID.firebaseapp.com or a custom hosting domain"
          android:pathPrefix="/__/auth/links" />
      </intent-filter>
      

   Когда пользователь открывает ссылку на хостинг с путем "/__/auth/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. Настройте приложение для Android для обработки ссылки Firebase Hosting. (инструкции приведены в предыдущем разделе).
3. Отправьте ссылку для аутентификации на адрес электронной почты пользователя с обновленным объектом ActionCodeSettings с пользовательским доменом в качестве linkDomain.

Как повторно использовать пользовательский домен Firebase Dynamic Links

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