Перенесите вход по ссылке электронной почты из 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 .

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

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

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

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

Используйте следующие инструкции для обработки ссылок с нового домена и указания 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 .