Você pode usar o Firebase Authentication para fazer login de um usuário, enviando-lhe um e-mail contendo um link, no qual ele pode clicar para fazer login. No processo, o endereço de e-mail do usuário também é verificado.
Existem inúmeros benefícios em fazer login por e-mail:
- Inscrição e login de baixo atrito.
- Menor risco de reutilização de senhas entre aplicativos, o que pode prejudicar a segurança até mesmo de senhas bem selecionadas.
- A capacidade de autenticar um usuário e ao mesmo tempo verificar se o usuário é o proprietário legítimo de um endereço de e-mail.
- Um usuário só precisa de uma conta de e-mail acessível para fazer login. Não é necessária a propriedade de um número de telefone ou conta de mídia social.
- Um usuário pode fazer login com segurança sem a necessidade de fornecer (ou lembrar) uma senha, o que pode ser complicado em um dispositivo móvel.
- Um usuário existente que tenha feito login anteriormente com um identificador de e-mail (senha ou federado) pode ser atualizado para entrar apenas com o e-mail. Por exemplo, um usuário que esqueceu a senha ainda pode fazer login sem precisar redefinir a senha.
Antes de você começar
Use o Swift Package Manager para instalar e gerenciar dependências do Firebase.
- No Xcode, com o projeto do seu aplicativo aberto, navegue até File > Add Packages .
- Quando solicitado, adicione o repositório SDK das plataformas Apple do Firebase:
- Escolha a biblioteca Firebase Authentication.
- Adicione o sinalizador
-ObjCà seção Outros sinalizadores de vinculador das configurações de compilação do seu destino. - Quando terminar, o Xcode começará automaticamente a resolver e baixar suas dependências em segundo plano.
https://github.com/firebase/firebase-ios-sdk.git
Ative o login do Email Link para seu projeto do Firebase
Para fazer login de usuários por link de e-mail, primeiro você deve ativar o método de login Provedor de e-mail e Link de e-mail para seu projeto do Firebase:
- No console do Firebase , abra a seção Auth .
- Na guia Método de login , habilite o provedor de e-mail/senha . Observe que o login por e-mail/senha deve estar habilitado para usar o login por link de e-mail.
- Na mesma seção, habilite o método de login do link de e-mail (login sem senha) .
- Clique em Salvar .
Envie um link de autenticação para o endereço de e-mail do usuário
Para iniciar o fluxo de autenticação, apresente ao usuário uma interface que solicita que ele forneça seu endereço de e-mail e, em seguida, chame sendSignInLink para solicitar que o Firebase envie o link de autenticação para o e-mail do usuário.
Construa o objeto
ActionCodeSettings, que fornece ao Firebase instruções sobre como construir o link de e-mail. Defina os seguintes campos:- url: o link direto a ser incorporado e qualquer estado adicional a ser repassado. O domínio do link deve estar na lista de permissões da lista de domínios autorizados do Firebase Console, que pode ser encontrada na guia Método de login (Autenticação -> Método de login).
- iOSBundleID e androidPackageName : os aplicativos a serem usados quando o link de login for aberto em um dispositivo Android ou Apple. Saiba mais sobre como configurar o Firebase Dynamic Links para abrir links de ação de e-mail por meio de aplicativos móveis.
- handleCodeInApp: definido como verdadeiro. A operação de login deve sempre ser concluída no aplicativo, ao contrário de outras ações de e-mail fora de banda (redefinição de senha e verificações de e-mail). Isso ocorre porque, ao final do fluxo, espera-se que o usuário esteja conectado e seu estado Auth persista no aplicativo.
- dynamicLinkDomain: quando vários domínios de link dinâmico personalizados são definidos para um projeto, especifique qual deles usar quando o link for aberto por meio de um aplicativo móvel especificado (por exemplo,
example.page.link). Caso contrário, o primeiro domínio será selecionado automaticamente.
Rápido
let actionCodeSettings = ActionCodeSettings() actionCodeSettings.url = URL(string: "https://www.example.com") // The sign-in operation has to always be completed in the app. actionCodeSettings.handleCodeInApp = true actionCodeSettings.setIOSBundleID(Bundle.main.bundleIdentifier!) actionCodeSettings.setAndroidPackageName("com.example.android", installIfNotAvailable: false, minimumVersion: "12")Objetivo-C
FIRActionCodeSettings *actionCodeSettings = [[FIRActionCodeSettings alloc] init]; [actionCodeSettings setURL:[NSURL URLWithString:@"https://www.example.com"]]; // The sign-in operation has to always be completed in the app. actionCodeSettings.handleCodeInApp = YES; [actionCodeSettings setIOSBundleID:[[NSBundle mainBundle] bundleIdentifier]]; [actionCodeSettings setAndroidPackageName:@"com.example.android" installIfNotAvailable:NO minimumVersion:@"12"];Para saber mais sobre ActionCodeSettings, consulte a seção Passando estado em ações de email .
Peça ao usuário o e-mail.
Envie o link de autenticação para o e-mail do usuário e salve o e-mail do usuário caso ele conclua o login de e-mail no mesmo dispositivo.
Rápido
Auth.auth().sendSignInLink(toEmail: email, actionCodeSettings: actionCodeSettings) { error in // ... if let error = error { self.showMessagePrompt(error.localizedDescription) return } // The link was successfully sent. Inform the user. // Save the email locally so you don't need to ask the user for it again // if they open the link on the same device. UserDefaults.standard.set(email, forKey: "Email") self.showMessagePrompt("Check your email for link") // ... }Objetivo-C
[[FIRAuth auth] sendSignInLinkToEmail:email actionCodeSettings:actionCodeSettings completion:^(NSError *_Nullable error) { // ... if (error) { [self showMessagePrompt:error.localizedDescription]; return; } // The link was successfully sent. Inform the user. // Save the email locally so you don't need to ask the user for it again // if they open the link on the same device. [NSUserDefaults.standardUserDefaults setObject:email forKey:@"Email"]; [self showMessagePrompt:@"Check your email for link"]; // ... }];
Conclua o login com o link do e-mail
Preocupações com segurança
Para evitar que um link de login seja usado para fazer login como um usuário não intencional ou em um dispositivo não intencional, o Firebase Auth exige que o endereço de e-mail do usuário seja fornecido ao concluir o fluxo de login. Para que o login seja bem-sucedido, esse endereço de e-mail deve corresponder ao endereço para o qual o link de login foi enviado originalmente.
Você pode agilizar esse fluxo para usuários que abrem o link de login no mesmo dispositivo em que solicitam o link, armazenando seus endereços de email localmente quando você envia o email de login. Em seguida, use este endereço para concluir o fluxo.
Após a conclusão do login, qualquer mecanismo de login anterior não verificado será removido do usuário e todas as sessões existentes serão invalidadas. Por exemplo, se alguém criou anteriormente uma conta não verificada com o mesmo e-mail e senha, a senha do usuário será removida para evitar que o imitador que reivindicou a propriedade e criou a conta não verificada faça login novamente com a mesma conta.
Concluindo o login em um aplicativo móvel da Apple
O Firebase Authentication usa Firebase Dynamic Links para enviar o link do e-mail para um dispositivo móvel. Para a conclusão do login por meio do aplicativo móvel, o aplicativo deve ser configurado para detectar o link de entrada do aplicativo, analisar o link direto subjacente e, em seguida, concluir o login.
Configurando links dinâmicos do Firebase
O Firebase Auth usa Firebase Dynamic Links ao enviar um link que deve ser aberto em um aplicativo móvel. Para usar esse recurso, os Dynamic Links precisam ser configurados no Firebase Console.
Ative links dinâmicos do Firebase:
- No console do Firebase , abra a seção Dynamic Links .
Se você ainda não aceitou os termos do Dynamic Links e criou um domínio do Dynamic Links, faça-o agora.
Se você já criou um domínio Dynamic Links, anote-o. Um domínio Dynamic Links normalmente se parece com o exemplo a seguir:
example.page.link
Você precisará desse valor ao configurar seu aplicativo Apple ou Android para interceptar o link de entrada.
Configurando aplicativos Apple:
- Se você planeja lidar com esses links no seu aplicativo, o ID do pacote precisa ser especificado nas configurações do projeto do Firebase Console. Além disso, o ID da App Store e o ID da equipe de desenvolvedores da Apple também precisam ser especificados.
- Você também precisará configurar seu domínio manipulador de ações de e-mail como um Domínio Associado nos recursos do seu aplicativo. Por padrão, o manipulador de ações de e-mail é hospedado em um domínio como o exemplo a seguir:
APP_ID.firebaseapp.com
- Se você planeja distribuir seu aplicativo para versões iOS 8 e anteriores, precisará definir o ID do pacote como um esquema personalizado para URLs recebidos.
- Para obter mais informações, consulte Recebendo instruções de links dinâmicos da plataforma Apple .
Verifique o link e faça login
Depois de receber o link conforme descrito acima, verifique se ele se destina à autenticação do link de e-mail e conclua o login.
Rápido
if Auth.auth().isSignIn(withEmailLink: link) {
Auth.auth().signIn(withEmail: email, link: self.link) { user, error in
// ...
}
}
Objetivo-C
if ([[FIRAuth auth] isSignInWithEmailLink:link]) {
[[FIRAuth auth] signInWithEmail:email
link:link
completion:^(FIRAuthDataResult * _Nullable authResult, NSError * _Nullable error) {
// ...
}];
}
Para saber como lidar com o login com link de e-mail em um aplicativo Android, consulte o guia do Android .
Para saber como lidar com o login com link de e-mail em um aplicativo Web, consulte o Guia da Web .
Vinculação/reautenticação com link de e-mail
Você também pode vincular esse método de autenticação a um usuário existente. Por exemplo, um usuário previamente autenticado com outro provedor, como um número de telefone, pode adicionar esse método de login à sua conta existente.
A diferença estaria na segunda metade da operação:
Rápido
let credential = EmailAuthCredential.credential(withEmail:email
link:link)
Auth.auth().currentUser?.link(with: credential) { authData, error in
if (error) {
// And error occurred during linking.
return
}
// The provider was successfully linked.
// The phone user can now sign in with their phone number or email.
}
Objetivo-C
FIRAuthCredential *credential =
[FIREmailAuthProvider credentialWithEmail:email link:link];
[FIRAuth auth].currentUser
linkWithCredential:credential
completion:^(FIRAuthDataResult *_Nullable result,
NSError *_Nullable error) {
if (error) {
// And error occurred during linking.
return;
}
// The provider was successfully linked.
// The phone user can now sign in with their phone number or email.
}];
Isso também pode ser usado para autenticar novamente um usuário de link de e-mail antes de executar uma operação confidencial.
Rápido
let credential = EmailAuthProvider.credential(withEmail:email
link:link)
Auth.auth().currentUser?.reauthenticate(with: credential) { authData, error in
if (error) {
// And error occurred during re-authentication.
return
}
// The user was successfully re-authenticated.
}
Objetivo-C
FIRAuthCredential *credential =
[FIREmailAuthCredential credentialWithEmail:email link:link];
[FIRAuth auth].currentUser
reauthenticateWithCredential:credential
completion:^(FIRAuthDataResult *_Nullable result,
NSError *_Nullable error) {
if (error) {
// And error occurred during re-authentication
return;
}
// The user was successfully re-authenticated.
}];
No entanto, como o fluxo pode terminar em um dispositivo diferente onde o usuário original não estava conectado, esse fluxo pode não ser concluído. Nesse caso, um erro pode ser mostrado ao usuário para forçá-lo a abrir o link no mesmo dispositivo. Algum estado pode ser passado no link para fornecer informações sobre o tipo de operação e o uid do usuário.
Obsoleto: Diferenciando email-senha do link de email
Se você criou seu projeto em ou após 15 de setembro de 2023, a proteção de enumeração de e-mail será habilitada por padrão. Esse recurso melhora a segurança das contas de usuário do seu projeto, mas desativa o método fetchSignInMethodsForEmail() , que recomendamos anteriormente para implementar fluxos que priorizam o identificador.
Embora você possa desativar a proteção de enumeração de e-mail para o seu projeto, não recomendamos fazer isso.
Consulte a documentação sobre proteção de enumeração de email para obter mais detalhes.
Próximos passos
Depois que um usuário faz login pela primeira vez, uma nova conta de usuário é criada e vinculada às credenciais (ou seja, nome de usuário e senha, número de telefone ou informações do provedor de autenticação) com as quais o usuário fez login. Essa nova conta é armazenada como parte do seu projeto do Firebase e pode ser usada para identificar um usuário em todos os aplicativos do seu projeto, independentemente de como o usuário faz login.
Nos seus aplicativos, você pode obter as informações básicas do perfil do usuário no objeto
User. Consulte Gerenciar usuários .Nas regras de segurança do Firebase Realtime Database e do Cloud Storage , você pode obter o ID de usuário exclusivo do usuário conectado na variável
authe usá-lo para controlar quais dados um usuário pode acessar.
Você pode permitir que os usuários façam login no seu aplicativo usando vários provedores de autenticação vinculando as credenciais do provedor de autenticação a uma conta de usuário existente.
Para desconectar um usuário, chame signOut: .
Rápido
let firebaseAuth = Auth.auth()
do {
try firebaseAuth.signOut()
} catch let signOutError as NSError {
print("Error signing out: %@", signOutError)
}Objetivo-C
NSError *signOutError;
BOOL status = [[FIRAuth auth] signOut:&signOutError];
if (!status) {
NSLog(@"Error signing out: %@", signOutError);
return;
}Você também pode adicionar código de tratamento de erros para toda a gama de erros de autenticação. Consulte Tratamento de erros .