Firebase Authentication'ı kullanarak kullanıcıların oturum açmak için tıklayabilecekleri bir bağlantı içeren e-posta göndererek oturum açmalarını sağlayabilirsiniz. Bu işlem sırasında kullanıcının e-posta adresi de doğrulanır.
E-posta ile oturum açmanın birçok avantajı vardır:
- Kolayca kaydolma ve oturum açma
- Uygulamalar arasında şifrelerin yeniden kullanılma riskini azaltır. Bu risk, iyi seçilmiş şifrelerin bile güvenliğini tehlikeye atabilir.
- Kullanıcının kimliğini doğrularken aynı zamanda bir e-posta adresinin yasal sahibi olduğunu doğrulama özelliği.
- Kullanıcının oturum açmak için yalnızca erişilebilir bir e-posta hesabına ihtiyacı vardır. Telefon numarası veya sosyal medya hesabı sahibi olmanız gerekmez.
- Kullanıcılar, mobil cihazlarda zahmetli olabilen şifre girme (veya hatırlama) ihtiyacı olmadan güvenli bir şekilde oturum açabilir.
- Daha önce bir e-posta tanımlayıcısı (şifre veya birleştirilmiş) ile oturum açmış mevcut bir kullanıcı, yalnızca e-posta ile oturum açacak şekilde yükseltilebilir. Örneğin, şifresini unutan bir kullanıcı, şifresini sıfırlamak zorunda kalmadan oturum açabilir.
Başlamadan önce
Firebase bağımlılıklarını yüklemek ve yönetmek için Swift Package Manager'ı kullanın.
Firebase SDK'larını Apple projenize eklemenin farklı yollarını öğrenmek için kurulum kılavuzumuzu- Xcode'da uygulama projeniz açıkken File > Add Packages'a (Dosya > Paket Ekle) gidin.
- İstendiğinde Firebase Apple platformları SDK deposunu ekleyin:
- Firebase Authentication kitaplığını seçin.
- Hedefinizin derleme ayarlarının Other Linker Flags (Diğer Bağlayıcı İşaretleri) bölümüne
-ObjCişaretini ekleyin. - İşlem tamamlandığında Xcode, arka planda bağımlılıklarınızı otomatik olarak çözmeye ve indirmeye başlar.
https://github.com/firebase/firebase-ios-sdk.git
Firebase projeniz için e-posta bağlantısı ile oturum açma özelliğini etkinleştirme
Kullanıcıların e-posta bağlantısıyla oturum açabilmesi için önce Firebase projenizde e-posta sağlayıcıyı ve e-posta bağlantısıyla oturum açma yöntemini etkinleştirmeniz gerekir:
Firebase konsolunda Güvenlik > Kimlik doğrulama'ya gidin.
Sign-in method (Oturum açma yöntemi) sekmesinde Email/Password (E-posta/Şifre) oturum açma sağlayıcısını etkinleştirin. E-posta bağlantısıyla oturum açma özelliğini kullanmak için e-posta/şifre ile oturum açma özelliğinin etkinleştirilmesi gerektiğini unutmayın.
Aynı bölümde E-posta bağlantısı (şifresiz oturum açma) sağlayıcısını etkinleştirin.
Kaydet'i tıklayın.
Kullanıcının e-posta adresine kimlik doğrulama bağlantısı gönderme
Kimlik doğrulama akışını başlatmak için kullanıcıya e-posta adresini girmesini isteyen bir arayüz gösterin ve ardından Firebase'in kimlik doğrulama bağlantısını kullanıcının e-posta adresine göndermesini istemek için sendSignInLink yöntemini çağırın.
Firebase'e e-posta bağlantısının nasıl oluşturulacağıyla ilgili talimatlar sağlayan
ActionCodeSettingsnesnesini oluşturun. Aşağıdaki alanları ayarlayın:url: Yerleştirilecek derin bağlantı ve iletilecek ek durumlar. Henüz yapmadıysanız alanınızı yetkili alanlar listesine ekleyin:Firebase konsolunda Security (Güvenlik) > Authentication (Kimlik Doğrulama) > Settings (Ayarlar) sekmesine gidin.
Yetkili alanlar bölümünde Alan ekle'yi tıklayın ve alanınızı ekleyin.
iOSBundleIDveandroidPackageName: Firebase Authentication, Android veya Apple cihazda açılan, yalnızca web'e özel bir bağlantı mı yoksa mobil bağlantı mı oluşturması gerektiğini belirler.handleCodeInApp: Doğru olarak ayarlanır. Oturum açma işlemi, diğer bant dışı e-posta işlemlerinin (şifre sıfırlama ve e-posta doğrulamaları) aksine her zaman uygulamada tamamlanmalıdır. Bunun nedeni, akışın sonunda kullanıcının oturum açmış olması ve Auth durumunun uygulama içinde kalıcı olmasıdır.linkDomain: Bir proje için özel Hosting bağlantı alanları tanımlandığında, bağlantı belirli bir mobil uygulama tarafından açılacaksa hangisinin kullanılacağını belirtin. Aksi takdirde varsayılan alan otomatik olarak seçilir (örneğin, ).PROJECT_ID.firebaseapp.comdynamicLinkDomain: Desteği sonlandırıldı. Bu parametreyi belirtmeyin.
Swift
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")
Objective-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"];
ActionCodeSettingshakkında daha fazla bilgi edinmek için E-posta İşlemlerinde Durum Aktarma bölümüne bakın.Kullanıcıdan e-posta adresini isteyin.
Kimlik doğrulama bağlantısını kullanıcının e-posta adresine gönderin ve kullanıcının e-posta ile oturum açma işlemini aynı cihazda tamamlaması ihtimaline karşı kullanıcının e-posta adresini kaydedin.
Swift
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") // ... }
Objective-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"]; // ... }];
E-posta bağlantısıyla oturum açma işlemini tamamlama
Güvenlik endişeleri
Firebase Auth, oturum açma bağlantısının istenmeyen bir kullanıcı olarak veya istenmeyen bir cihazda oturum açmak için kullanılmasını önlemek amacıyla oturum açma akışı tamamlanırken kullanıcının e-posta adresinin sağlanmasını zorunlu kılar. Oturum açma işleminin başarılı olması için bu e-posta adresinin, oturum açma bağlantısının ilk gönderildiği adresle eşleşmesi gerekir.
Oturum açma e-postasını gönderirken kullanıcının e-posta adresini yerel olarak depolayarak, oturum açma bağlantısını bağlantıyı istediği cihazda açan kullanıcılar için bu akışı kolaylaştırabilirsiniz. Ardından, akışı tamamlamak için bu adresi kullanın.
Oturum açma işlemi tamamlandıktan sonra, kullanıcının daha önce kullandığı doğrulanmamış oturum açma mekanizmaları kaldırılır ve mevcut oturumlar geçersiz kılınır. Örneğin, daha önce birisi aynı e-posta ve şifreyle doğrulanmamış bir hesap oluşturduysa sahiplik iddiasında bulunan ve bu doğrulanmamış hesabı oluşturan kişinin aynı hesapla tekrar oturum açmasını önlemek için kullanıcının şifresi kaldırılır.
Apple mobil uygulamasında oturum açma işlemini tamamlama
Firebase Authentication, e-posta bağlantısını mobil cihaza göndermek için Firebase Hosting kullanır. Oturum açma işleminin mobil uygulama üzerinden tamamlanması için uygulamanın, gelen uygulama bağlantısını algılayacak, temel derin bağlantıyı ayrıştıracak ve ardından oturum açma işlemini tamamlayacak şekilde yapılandırılması gerekir. Bunu nasıl yapacağınızla ilgili daha fazla bilgi için iOS'te geçiş bağlantıları ve ilişkili alan adları başlıklı makaleyi inceleyin.
Firebase Hosting ürününü yapılandır
Firebase Authentication, mobil uygulamada açılması amaçlanan bir bağlantı oluşturup gönderirken Firebase Hosting alan adlarını kullanır. Sizin için varsayılan bir Firebase Hosting alan adı zaten yapılandırıldı.
Firebase Hosting alan adını yapılandırın:
Firebase konsolunda Hosting & Serverless (Barındırma ve Sunucusuz) > Hosting (Barındırma) bölümüne gidin.
Mobil uygulamalarda açılan e-posta bağlantısı için varsayılan alanı kullanmak istiyorsanız varsayılan sitenize gidin ve varsayılan Hosting alanınızı not edin. Varsayılan bir Hosting alan adı genellikle şu şekilde görünür:
.PROJECT_ID.firebaseapp.comUygulamanızı gelen bağlantıyı yakalayacak şekilde yapılandırırken bu değere ihtiyacınız olacaktır.
E-posta bağlantısı için özel bir alan kullanmak istiyorsanız Firebase Hosting ile bir alan kaydedebilir ve bunu bağlantının alanı için kullanabilirsiniz.
Apple uygulamalarını yapılandırma:
Seçilen alanı, uygulama bağlantıları için İlişkili Alan olarak yapılandırmanız gerekir. Uygulamanızda yetkilendirmeyi ayarlamak için Xcode'da hedefin Signing & Capabilities (İmzalama ve Özellikler) sekmesini açın ve önceki adımda yer alan Firebase Hosting alan adlarını Associated Domains (İlişkili Alan Adları) özelliğine ekleyin. Varsayılan Firebase Hosting alanını kullanıyorsanız bu,
olur.applinks:PROJECT_ID.firebaseapp.comDaha fazla bilgi için Apple'ın dokümanlar sitesindeki İlişkili alanları destekleme başlıklı makaleyi inceleyin.
Bağlantıyı doğrulama ve oturum açma
Yukarıda açıklandığı şekilde bağlantıyı aldıktan sonra, bağlantının e-posta bağlantısı kimlik doğrulaması için olduğunu doğrulayın ve oturum açma işlemini tamamlayın.
Swift
if Auth.auth().isSignIn(withEmailLink: link) { Auth.auth().signIn(withEmail: email, link: self.link) { user, error in // ... } }
Objective-C
if ([[FIRAuth auth] isSignInWithEmailLink:link]) { [[FIRAuth auth] signInWithEmail:email link:link completion:^(FIRAuthDataResult * _Nullable authResult, NSError * _Nullable error) { // ... }]; }
Android uygulamasında e-posta bağlantısıyla oturum açma işleminin nasıl yapılacağını öğrenmek için Android kılavuzuna bakın.
Bir web uygulamasında e-posta bağlantısıyla oturum açma işleminin nasıl yapılacağını öğrenmek için Web kılavuzuna bakın.
E-posta bağlantısıyla bağlama/yeniden kimlik doğrulama
Bu kimlik doğrulama yöntemini mevcut bir kullanıcıya da bağlayabilirsiniz. Örneğin, daha önce başka bir sağlayıcıyla (ör. telefon numarası) kimlik doğrulaması yapan bir kullanıcı, bu oturum açma yöntemini mevcut hesabına ekleyebilir.
Fark, işlemin ikinci yarısında ortaya çıkar:
Swift
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. }
Objective-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. }];
Bu yöntem, hassas bir işlem çalıştırmadan önce e-posta bağlantısı kullanıcısının kimliğini yeniden doğrulamak için de kullanılabilir.
Swift
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. }
Objective-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. }];
Ancak akış, asıl kullanıcının giriş yapmadığı farklı bir cihazda sona erebileceğinden bu akış tamamlanamayabilir. Bu durumda, kullanıcıya bağlantıyı aynı cihazda açmaya zorlayan bir hata gösterilebilir. İşlem türü ve kullanıcı UID'si hakkında bilgi sağlamak için bağlantıda bazı durumlar iletilebilir.
Desteği sonlandırıldı: Firebase Dynamic Links tabanlı doğrulama
Firebase Authentication iOS SDK'sı 11.8.0 sürümünden önce, e-posta bağlantısıyla oturum açma özelliği, oturum açma bağlantılarını doğru uygulamada açmak için Firebase Dynamic Links kullanıyordu. Firebase Dynamic Links 25 Ağustos 2025'te kullanımdan kaldırılacağı için bu doğrulama bağlantıları da kullanımdan kaldırıldı.
Uygulamanız eski stil bağlantıları kullanıyorsa uygulamanızı yeni Firebase Hosting tabanlı sisteme taşımanız gerekir.
Desteği sonlandırıldı: E-posta/şifre ile e-posta bağlantısı arasındaki fark
Projenizi 15 Eylül 2023'te veya sonrasında oluşturduysanız e-posta numaralandırma koruması varsayılan olarak etkindir. Bu özellik, projenizin kullanıcı hesaplarının güvenliğini artırır ancak daha önce tanımlayıcı öncelikli akışları uygulamak için önerdiğimiz fetchSignInMethodsForEmail() yöntemini devre dışı bırakır.
Projeniz için e-posta numaralandırma korumasını devre dışı bırakabilirsiniz ancak bunu yapmanızı önermiyoruz.
Daha fazla bilgi edinmek için E-posta numaralandırma korumasını etkinleştirme veya devre dışı bırakma başlıklı makaleyi inceleyin.
Sonraki adımlar
Kullanıcı ilk kez oturum açtıktan sonra yeni bir kullanıcı hesabı oluşturulur ve kullanıcının oturum açarken kullandığı kimlik bilgilerine (kullanıcı adı ve şifre, telefon numarası veya kimlik doğrulama sağlayıcı bilgileri) bağlanır. Bu yeni hesap, Firebase projenizin bir parçası olarak depolanır ve kullanıcının nasıl oturum açtığından bağımsız olarak projenizdeki her uygulamada kullanıcıyı tanımlamak için kullanılabilir.
-
Uygulamalarınızda, kullanıcının temel profil bilgilerini
Usernesnesinden alabilirsiniz. Kullanıcıları yönetme başlıklı makaleyi inceleyin. Firebase Realtime Database ve Cloud Storage Güvenlik Kurallarınızda, oturum açmış kullanıcının benzersiz kullanıcı kimliğini
authdeğişkeninden alabilir ve kullanıcının hangi verilere erişebileceğini kontrol etmek için kullanabilirsiniz.
Kimlik doğrulama sağlayıcı kimlik bilgilerini mevcut bir kullanıcı hesabına bağlayarak kullanıcıların birden fazla kimlik doğrulama sağlayıcısı kullanarak uygulamanızda oturum açmasına izin verebilirsiniz.
Bir kullanıcının oturumunu kapatmak için
signOut: yöntemini çağırın.
Swift
let firebaseAuth = Auth.auth() do { try firebaseAuth.signOut() } catch let signOutError as NSError { print("Error signing out: %@", signOutError) }
Objective-C
NSError *signOutError; BOOL status = [[FIRAuth auth] signOut:&signOutError]; if (!status) { NSLog(@"Error signing out: %@", signOutError); return; }
Tüm kimlik doğrulama hataları için hata işleme kodu da ekleyebilirsiniz. Hataları işleme başlıklı makaleyi inceleyin.