Apple Platforms'da Parola Tabanlı Hesapları kullanarak Firebase ile kimlik doğrulama

Kullanıcılarınızın e-posta adreslerini ve şifrelerini kullanarak Firebase ile kimlik doğrulamasına izin vermek ve uygulamanızın şifre tabanlı hesaplarını yönetmek için Firebase Authentication kullanabilirsiniz.

Help me use Firebase in my app.
1. Make sure that **Firebase agent skills** are installed and updated. For Claude Code, Codex, or Cursor agents, help me install the Firebase plugin. For other agents, run `npx skills add firebase/agent-skills`.  Always try to use **Firebase agent skills** for Firebase-related tasks.
2. Help me set up and use Firebase Authentication with email and password authentication in my app.

Başlamadan önce

Firebase bağımlılıklarını yüklemek ve yönetmek için Swift Package Manager'ı kullanın.

1. Xcode'da, uygulama projeniz açıkken File > Add Packages'a (Dosya > Paket Ekle) gidin.
2. İstendiğinde Firebase Apple platformları SDK deposunu ekleyin:

  https://github.com/firebase/firebase-ios-sdk.git

3. Firebase Authentication kitaplığını seçin.
4. -ObjC işaretini hedefinizin derleme ayarlarının Other Linker Flags (Diğer Bağlayıcı İşaretleri) bölümüne ekleyin.
5. İşlem tamamlandığında Xcode, bağımlılıklarınızı otomatik olarak çözümlemeye ve arka planda indirmeye başlar.

Ardından, bazı yapılandırma adımlarını uygulayın:

1. Uygulamanızı henüz Firebase projenize bağlamadıysanız bunu Firebase konsolundan yapın.
2. Firebase projeniz için e-posta/şifre ile oturum açma sağlayıcısını etkinleştirin:
   1. Firebase konsolunda Güvenlik > Kimlik doğrulama'ya gidin.
   2. Oturum açma yöntemi sekmesinde E-posta/şifre oturum açma sağlayıcısını etkinleştirin.
   3. Kaydet'i tıklayın.

Şifre tabanlı hesap oluşturma

Şifreyle yeni bir kullanıcı hesabı oluşturmak için uygulamanızın oturum açma etkinliğinde aşağıdaki adımları tamamlayın:

1. FirebaseCore modülünü UIApplicationDelegate ve uygulama temsilcinizin kullandığı diğer Firebase modüllerini içe aktarın. Örneğin, Cloud Firestore ve Authentication kullanmak için:

   SwiftUI

   import SwiftUI
   import FirebaseCore
   import FirebaseFirestore
   import FirebaseAuth
   // ...
         

   Swift

   import FirebaseCore
   import FirebaseFirestore
   import FirebaseAuth
   // ...
         

   Objective-C

   @import FirebaseCore;
   @import FirebaseFirestore;
   @import FirebaseAuth;
   // ...
         

2. Uygulama temsilcinizin FirebaseApp application(_:didFinishLaunchingWithOptions:) yönteminde paylaşılan bir örnek yapılandırın:

   SwiftUI

   // Use Firebase library to configure APIs
   FirebaseApp.configure()

   Swift

   // Use Firebase library to configure APIs
   FirebaseApp.configure()

   Objective-C

   // Use Firebase library to configure APIs
   [FIRApp configure];

3. SwiftUI kullanıyorsanız bir uygulama temsilcisi oluşturup aracılığıyla UIApplicationDelegateAdaptor veya NSApplicationDelegateAdaptor kullanarak App yapınıza eklemeniz gerekir. Ayrıca, uygulama temsilcisi karıştırmayı da devre dışı bırakmanız gerekir. Daha fazla bilgi için SwiftUI talimatlarına bakın.

   SwiftUI

   @main
   struct YourApp: App {
     // register app delegate for Firebase setup
     @UIApplicationDelegateAdaptor(AppDelegate.self) var delegate
   
     var body: some Scene {
       WindowGroup {
         NavigationView {
           ContentView()
         }
       }
     }
   }
         

4. Yeni bir kullanıcı, uygulamanızın kayıt formunu kullanarak kaydolduğunda uygulamanızın gerektirdiği yeni hesap doğrulama adımlarını tamamlayın. Örneğin, yeni hesabın şifresinin doğru yazıldığını ve karmaşıklık şartlarınızı karşıladığını doğrulayın.
5. Yeni kullanıcının e-posta adresini ve şifresini createUser'ya ileterek yeni bir hesap oluşturun.

   Swift

   Auth.auth().createUser(withEmail: email, password: password) { authResult, error in
     // ...
   }

   Objective-C

   [[FIRAuth auth] createUserWithEmail:email
                              password:password
                            completion:^(FIRAuthDataResult * _Nullable authResult,
                                         NSError * _Nullable error) {
     // ...
   }];

   Yeni hesap başarıyla oluşturulduysa kullanıcı oturum açar ve geri çağırma yöntemine iletilen sonuç nesnesinden kullanıcının hesap verilerini alabilirsiniz.

Bir kullanıcının e-posta adresi ve şifresiyle oturum açma

Kullanıcının şifreyle oturum açması için gereken adımlar, yeni hesap oluşturma adımlarına benzer. Uygulamanızın oturum açma etkinliğinde şunları yapın:

1. FirebaseCore modülünü UIApplicationDelegate ve uygulama temsilcinizin kullandığı diğer Firebase modüllerini içe aktarın. Örneğin, Cloud Firestore ve Authentication kullanmak için:

   SwiftUI

   import SwiftUI
   import FirebaseCore
   import FirebaseFirestore
   import FirebaseAuth
   // ...
         

   Swift

   import FirebaseCore
   import FirebaseFirestore
   import FirebaseAuth
   // ...
         

   Objective-C

   @import FirebaseCore;
   @import FirebaseFirestore;
   @import FirebaseAuth;
   // ...
         

2. Uygulama temsilcinizin FirebaseApp application(_:didFinishLaunchingWithOptions:) yönteminde paylaşılan bir örnek yapılandırın:

   SwiftUI

   // Use Firebase library to configure APIs
   FirebaseApp.configure()

   Swift

   // Use Firebase library to configure APIs
   FirebaseApp.configure()

   Objective-C

   // Use Firebase library to configure APIs
   [FIRApp configure];

3. SwiftUI kullanıyorsanız bir uygulama temsilcisi oluşturup aracılığıyla UIApplicationDelegateAdaptor veya NSApplicationDelegateAdaptor kullanarak App yapınıza eklemeniz gerekir. Ayrıca, uygulama temsilcisi karıştırmayı da devre dışı bırakmanız gerekir. Daha fazla bilgi için SwiftUI talimatlarına bakın.

   SwiftUI

   @main
   struct YourApp: App {
     // register app delegate for Firebase setup
     @UIApplicationDelegateAdaptor(AppDelegate.self) var delegate
   
     var body: some Scene {
       WindowGroup {
         NavigationView {
           ContentView()
         }
       }
     }
   }
         

4. Bir kullanıcı uygulamanıza giriş yaptığında kullanıcının e-posta adresini ve şifresini signIn'ya iletin.

   Swift

   Auth.auth().signIn(withEmail: email, password: password) { [weak self] authResult, error in
     guard let strongSelf = self else { return }
     // ...
   }

   Objective-C

   [[FIRAuth auth] signInWithEmail:self->_emailField.text
                          password:self->_passwordField.text
                        completion:^(FIRAuthDataResult * _Nullable authResult,
                                     NSError * _Nullable error) {
     // ...
   }];

   Kullanıcı başarılı bir şekilde oturum açarsa geri çağırma yöntemine iletilen sonuç nesnesinden kullanıcının hesap verilerini alabilirsiniz.

Önerilen: Şifre politikası belirleme

Şifre karmaşıklığı koşullarını zorunlu kılarak hesap güvenliğini artırabilirsiniz.

Projeniz için şifre politikası yapılandırmak üzere Firebase konsolunun Güvenlik > Kimlik doğrulama > Ayarlar sekmesindeki Şifre politikası bölümünü açın:

Kimlik Doğrulama Ayarları

Firebase Authentication şifre politikaları aşağıdaki şifre koşullarını destekler:

• Küçük harf zorunludur

• Büyük harf zorunludur

• Sayısal karakter gerekli

• Alfanümerik olmayan karakter gerekli

  Aşağıdaki karakterler, alfanümerik olmayan karakter koşulunu karşılar: ^ $ * . [ ] { } ( ) ? " ! @ # % & / \ , > < ' : ; | _ ~

• Minimum şifre uzunluğu (6 ila 30 karakter arasında değişir; varsayılan olarak 6'dır)

• Maksimum şifre uzunluğu (en fazla 4.096 karakter)

Şifre politikası yaptırımını iki modda etkinleştirebilirsiniz:

• Zorunlu: Kullanıcı, politikanıza uygun bir şifreye geçene kadar kayıt olma girişimleri başarısız olur.

• Bildirim: Kullanıcıların, politikaya uygun olmayan bir şifreyle kaydolmasına izin verilir. Bu modu kullanırken kullanıcının şifresinin istemci tarafındaki politikaya uygun olup olmadığını kontrol etmeli ve uygun değilse kullanıcıdan şifresini güncellemesini istemelisiniz.

Yeni kullanıcıların her zaman politikanıza uygun bir şifre seçmesi gerekir.

Etkin kullanıcılarınız varsa şifreleri politikanıza uymayan kullanıcıların erişimini engellemek istemediğiniz sürece oturum açma sırasında zorunlu yükseltmeyi etkinleştirmenizi önermeyiz. Bunun yerine, kullanıcıların mevcut şifreleriyle oturum açmasına olanak tanıyan ve şifrelerinin hangi şartları karşılamadığını bildiren bildirim modunu kullanın.

Önerilen: E-posta numaralandırma korumasını etkinleştirme

E-posta adreslerini parametre olarak alan bazı Firebase Authentication yöntemleri, e-posta adresi kayıtlı olması gerektiği halde kayıtlı değilse (örneğin, e-posta adresi ve şifreyle oturum açarken) veya kullanılmaması gerektiği halde kayıtlıysa (örneğin, kullanıcının e-posta adresi değiştirilirken) belirli hatalar verir. Bu özellik, kullanıcılara belirli çözümler önermek için faydalı olsa da kötü niyetli kişiler tarafından kullanıcılarınızın kayıtlı e-posta adreslerini bulmak için kötüye kullanılabilir.

Bu riski azaltmak için projenizde e-posta numaralandırma korumasının etkinleştirildiğinden emin olmanızı öneririz. Bu ayarı Firebase konsolunda kontrol edebilirsiniz: Güvenlik > Kimlik Doğrulama > Ayarlar sekmesine gidin ve Kullanıcı işlemleri'ni tıklayın.

Bu özelliği etkinleştirmenin Firebase Authentication için hata raporlama davranışını değiştirdiğini unutmayın. Bu nedenle, uygulamanızın daha ayrıntılı hatalara bağlı olmadığından emin olun.

Sonraki adımlar

Bir kullanıcı ilk kez oturum açtıktan sonra yeni bir kullanıcı hesabı oluşturulur ve kullanıcının oturum açtığı 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ığına bakılmaksızın projenizdeki her uygulamada kullanıcıyı tanımlamak için kullanılabilir.

• Uygulamalarınızda, kullanıcının temel profil bilgilerini User nesnesinden 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 auth değ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 uygulamanızda birden fazla kimlik doğrulama sağlayıcı kullanarak oturum açmasına izin verebilirsiniz.

Bir kullanıcının oturumunu kapatmak için signOut: numaralı telefonu arayın.

let firebaseAuth = Auth.auth()
do {
  try firebaseAuth.signOut()
} catch let signOutError as NSError {
  print("Error signing out: %@", signOutError)
}

NSError *signOutError;
BOOL status = [[FIRAuth auth] signOut:&signOutError];
if (!status) {
  NSLog(@"Error signing out: %@", signOutError);
  return;
}

Ayrıca, tüm kimlik doğrulama hataları için hata işleme kodu eklemek de isteyebilirsiniz. Hataları işleme başlıklı makaleyi inceleyin.