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

    Вам нужно будет настроить выбранный домен как ассоциированный домен для ссылок приложений. Чтобы настроить права в вашем приложении, откройте вкладку Signing & Capabilities целевого объекта в Xcode и добавьте домены Firebase Hosting из предыдущего шага в возможность Associated Domains. Если вы используете домен 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 .