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

    const updateRequest = {
mobileLinksConfig: {
    domain: 'HOSTING_DOMAIN'
}
}
const updateProjectConfig = () => {
projectConfigManager.updateProjectConfig(updateRequest)
.then((response) => {
    // updated project config
}).catch((error) => {
    console.log('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 .