Migração do login por link de e-mail do Firebase Dynamic Links (iOS)

A autenticação do link por e-mail dependia do Firebase Dynamic Links, que será desativado em 25 de agosto de 2025. Publicamos uma solução alternativa no SDK do Firebase Authentication para iOS versão 11.8.0+. Se o app usar Firebase Dynamic Links, migre-o para o novo sistema baseado em Firebase Hosting.

Migração do domínio associado do Firebase Dynamic Links para um domínio do Firebase Hosting

Em vez de usar um domínio do Firebase Dynamic Links, o Firebase Authentication vai usar o domínio padrão do Firebase Hosting do projeto para criar links para e-mail e outras ações de links fora da banda em apps para dispositivos móveis. Isso significa que seu app também precisará ser atualizado para usar esse domínio padrão como o domínio associado aos links de autenticação de e-mail para o seu app móvel.

Siga as instruções em Autenticar com o Firebase usando o link por e-mail em plataformas Apple para atualizar seu app e usar o novo domínio padrão do Firebase Hosting provisionado automaticamente.

Use as instruções a seguir para processar links do novo domínio e instruir o Firebase Authentication a começar a usar o domínio do Firebase Hosting para gerar links de apps para dispositivos móveis daqui em diante.

Se você quiser continuar usando qualquer um dos seus domínios personalizados do Firebase Hosting ou até mesmo o domínio personalizado do Firebase Dynamic Links como seu novo domínio associado, use as instruções na seção Personalização de links móveis e adapte as etapas para corresponder ao domínio que você quer usar.

  1. Vincule o domínio do Firebase Hosting ao domínio associado ao app.

    Você vai precisar configurar o domínio selecionado como um domínio associado para links de app. Para configurar o direito de acesso no app, abra a guia Signing & Capabilities do destino no Xcode e adicione os domínios do Firebase Hosting da etapa anterior ao recurso "Domínios associados". Se você usar o domínio padrão do Firebase Hosting, ele será applinks:PROJECT_ID.firebaseapp.com.

    Consulte Supporting associated domains no site de documentação da Apple para mais informações.

    Um arquivo de domínio associado foi implantado em todos os seus domínios Firebase Hosting. Para acessá-lo, navegue até PROJECT_ID.firebaseapp.com/.well-known/apple-app-site-association. Esse arquivo AASA pode ser substituído. Consulte Crie e hospede seus arquivos de configuração de links universais no seu novo domínio de hospedagem para mais informações.

  2. Configure seu projeto para usar os novos links.

    Quando estiver tudo pronto para processar os novos links de domínio, use o SDK Admin do Firebase para atualizar como você quer que os links de e-mail sejam gerados e instrua nosso back-end a começar a gerar links usando o novo domínio 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. Envie e resgate o link de e-mail.

    Envie o link de login por e-mail como antes. Quando um usuário final clica no link, ele é redirecionado para o app, se instalado, para concluir o login.

Você pode usar um domínio personalizado do Firebase Hosting ou reutilizar seu domínio personalizado do Firebase Dynamic Links como o novo domínio de links para dispositivos móveis.

Use um domínio personalizado do Firebase Hosting

  1. Siga o guia do Firebase Hosting para configurar um domínio personalizado.
  2. Vincule o domínio personalizado ao domínio associado ao app.
  3. Envie um link de autenticação para o endereço de e-mail do usuário com um objeto ActionCodeSettings atualizado com um domínio personalizado como linkDomain.
  1. Você pode reutilizar qualquer um dos seus domínios do Firebase Dynamic Links como domínio personalizado. No entanto, nenhuma funcionalidade do Firebase Dynamic Links vai ser mais compatível. Por exemplo, os usuários não poderão ser redirecionados para a app store se o app não estiver instalado no dispositivo.
  2. Envie um link de autenticação para o endereço de e-mail do usuário com um objeto ActionCodeSettings atualizado com um domínio personalizado como linkDomain.