این صفحه به‌وسیله ‏Cloud Translation API‏ ترجمه شده است.

احراز هویت با Firebase با استفاده از حساب های مبتنی بر رمز عبور در پلتفرم های اپل

می‌توانید از Firebase Authentication استفاده کنید تا به کاربران خود اجازه دهید با استفاده از آدرس ایمیل و گذرواژه‌های خود با Firebase احراز هویت کنند و حساب‌های مبتنی بر گذرواژه برنامه‌تان را مدیریت کنید.

قبل از شروع

برای نصب و مدیریت وابستگی های Firebase از Swift Package Manager استفاده کنید.

در Xcode، با باز بودن پروژه برنامه، به File > Add Packages بروید.
هنگامی که از شما خواسته شد، مخزن SDK پلتفرم های Apple Firebase را اضافه کنید:

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

کتابخانه Firebase Authentication را انتخاب کنید.
پرچم -ObjC را به بخش Other Linker Flags تنظیمات ساخت هدف خود اضافه کنید.
پس از اتمام، Xcode به طور خودکار شروع به حل و دانلود وابستگی های شما در پس زمینه می کند.

در مرحله بعد، چند مرحله پیکربندی را انجام دهید:

اگر هنوز برنامه خود را به پروژه Firebase متصل نکرده اید، این کار را از کنسول Firebase انجام دهید.
فعال کردن ورود به سیستم ایمیل/گذرواژه:
1. در کنسول Firebase ، بخش Auth را باز کنید.
2. در برگه روش ورود به سیستم ، روش ورود ایمیل/گذرواژه را فعال کنید و روی ذخیره کلیک کنید.

یک حساب کاربری مبتنی بر رمز عبور ایجاد کنید

برای ایجاد یک حساب کاربری جدید با رمز عبور، مراحل زیر را در فعالیت ورود به سیستم برنامه خود انجام دهید:

ماژول FirebaseCore را در UIApplicationDelegate خود و همچنین هر ماژول Firebase دیگری که نماینده برنامه شما استفاده می‌کند، وارد کنید. به عنوان مثال، برای استفاده از Cloud Firestore و Authentication :
SwiftUI
```
import SwiftUI
import FirebaseCore
import FirebaseFirestore
import FirebaseAuth
// ...
      
```
سویفت
```
import FirebaseCore
import FirebaseFirestore
import FirebaseAuth
// ...
      
```
هدف-C
```
@import FirebaseCore;
@import FirebaseFirestore;
@import FirebaseAuth;
// ...
      
```

یک نمونه اشتراک‌گذاری شده FirebaseApp در روش application(_:didFinishLaunchingWithOptions:) پیکربندی کنید:

SwiftUI

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

سویفت

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

هدف-C

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

اگر از SwiftUI استفاده می‌کنید، باید یک نماینده برنامه ایجاد کنید و آن را از طریق UIApplicationDelegateAdaptor یا NSApplicationDelegateAdaptor به ساختار App خود متصل کنید. همچنین باید swizzling نمایندگی برنامه را غیرفعال کنید. برای اطلاعات بیشتر، دستورالعمل های SwiftUI را ببینید.
SwiftUI
```
@main
struct YourApp: App {
  // register app delegate for Firebase setup
  @UIApplicationDelegateAdaptor(AppDelegate.self) var delegate

  var body: some Scene {
    WindowGroup {
      NavigationView {
        ContentView()
      }
    }
  }
}
      
```
وقتی کاربر جدیدی با استفاده از فرم ثبت‌نام برنامه شما ثبت‌نام می‌کند، مراحل اعتبارسنجی حساب جدیدی را که برنامه شما نیاز دارد، تکمیل کنید، مانند تأیید اینکه رمز عبور حساب جدید به درستی تایپ شده است و شرایط پیچیدگی شما را برآورده می‌کند.

با ارسال آدرس ایمیل و رمز عبور کاربر جدید به createUser یک حساب کاربری جدید ایجاد کنید.

سویفت

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

هدف-C

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

اگر حساب جدید با موفقیت ایجاد شد، کاربر وارد سیستم شده است و می‌توانید داده‌های حساب کاربر را از شیء نتیجه‌ای که به روش برگشت به تماس ارسال شده است، دریافت کنید.

یک کاربر با آدرس ایمیل و رمز عبور وارد شوید

مراحل ورود کاربر با رمز عبور مشابه مراحل ایجاد یک حساب کاربری جدید است. در فعالیت ورود به سیستم برنامه، موارد زیر را انجام دهید:

ماژول FirebaseCore را در UIApplicationDelegate خود و همچنین هر ماژول Firebase دیگری که نماینده برنامه شما استفاده می‌کند، وارد کنید. به عنوان مثال، برای استفاده از Cloud Firestore و Authentication :
SwiftUI
```
import SwiftUI
import FirebaseCore
import FirebaseFirestore
import FirebaseAuth
// ...
      
```
سویفت
```
import FirebaseCore
import FirebaseFirestore
import FirebaseAuth
// ...
      
```
هدف-C
```
@import FirebaseCore;
@import FirebaseFirestore;
@import FirebaseAuth;
// ...
      
```

یک نمونه اشتراک‌گذاری شده FirebaseApp در روش application(_:didFinishLaunchingWithOptions:) پیکربندی کنید:

SwiftUI

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

سویفت

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

هدف-C

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

اگر از SwiftUI استفاده می‌کنید، باید یک نماینده برنامه ایجاد کنید و آن را از طریق UIApplicationDelegateAdaptor یا NSApplicationDelegateAdaptor به ساختار App خود متصل کنید. همچنین باید swizzling نمایندگی برنامه را غیرفعال کنید. برای اطلاعات بیشتر، دستورالعمل های SwiftUI را ببینید.
SwiftUI
```
@main
struct YourApp: App {
  // register app delegate for Firebase setup
  @UIApplicationDelegateAdaptor(AppDelegate.self) var delegate

  var body: some Scene {
    WindowGroup {
      NavigationView {
        ContentView()
      }
    }
  }
}
      
```

وقتی کاربری وارد برنامه شما می‌شود، آدرس ایمیل و رمز عبور کاربر را به signIn ارسال کنید.

سویفت

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

هدف-C

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

اگر کاربر با موفقیت وارد سیستم شود، می‌توانید داده‌های حساب کاربر را از شی نتیجه ارسال شده به روش برگشت دریافت کنید.

توصیه می شود: یک خط مشی رمز عبور تنظیم کنید

شما می توانید امنیت حساب را با اجرای الزامات پیچیدگی رمز عبور بهبود بخشید.

برای پیکربندی یک خط مشی رمز عبور برای پروژه خود، برگه خط مشی رمز عبور را در صفحه تنظیمات احراز هویت کنسول Firebase باز کنید:

تنظیمات احراز هویت

سیاست های رمز عبور Firebase Authentication از الزامات رمز عبور زیر پشتیبانی می کند:

حروف کوچک مورد نیاز است
حروف بزرگ مورد نیاز است
کاراکتر عددی مورد نیاز است
نویسه غیر الفبایی مورد نیاز است
کاراکترهای زیر الزامات کاراکتر غیرالفبایی را برآورده می کنند: ^ $ * . [ ] { } ( ) ? " ! @ # % & / \ , > < ' : ; | _ ~
حداقل طول رمز عبور (از 6 تا 30 کاراکتر؛ پیش‌فرض تا 6 کاراکتر)
حداکثر طول رمز عبور (حداکثر طول 4096 کاراکتر)

شما می توانید اجرای سیاست رمز عبور را در دو حالت فعال کنید:

نیاز : تلاش‌ها برای ثبت نام با شکست مواجه می‌شوند تا زمانی که کاربر رمز عبوری مطابق با خط‌مشی شما را به‌روزرسانی کند.
اطلاع رسانی : کاربران مجاز به ثبت نام با رمز عبور غیرمنطبق هستند. هنگام استفاده از این حالت، باید بررسی کنید که آیا گذرواژه کاربر با خط مشی سمت کلاینت مطابقت دارد یا خیر و از کاربر بخواهید در صورت عدم مطابقت رمز عبور خود را به نحوی به روز کند.

کاربران جدید همیشه باید رمز عبوری را انتخاب کنند که با خط مشی شما مطابقت داشته باشد.

اگر کاربران فعال دارید، توصیه می‌کنیم ارتقاء اجباری را هنگام ورود به سیستم فعال نکنید، مگر اینکه بخواهید دسترسی کاربرانی را که گذرواژه‌شان با خط‌مشی شما مطابقت ندارد مسدود کنید. در عوض، از حالت اطلاع رسانی استفاده کنید، که به کاربران اجازه می دهد با رمزهای عبور فعلی خود وارد سیستم شوند و آنها را از الزاماتی که رمز عبور آنها فاقد آن است آگاه کند.

توصیه می شود: حفاظت از شمارش ایمیل را فعال کنید

برخی از روش‌های Firebase Authentication که آدرس‌های ایمیل را به‌عنوان پارامتر در نظر می‌گیرند، اگر آدرس ایمیل ثبت نشده باشد، زمانی که باید ثبت شود (به عنوان مثال، هنگام ورود به سیستم با آدرس ایمیل و رمز عبور)، یا ثبت نام زمانی که باید استفاده نشده باشد، خطاهای خاصی ایجاد می‌کنند (به عنوان مثال، هنگام تغییر آدرس ایمیل کاربر). در حالی که این می تواند برای پیشنهاد راه حل های خاص به کاربران مفید باشد، اما می تواند توسط عوامل مخرب برای کشف آدرس های ایمیل ثبت شده توسط کاربران شما مورد سوء استفاده قرار گیرد.

برای کاهش این خطر، توصیه می‌کنیم با استفاده از ابزار Google Cloud gcloud حفاظت از شمارش ایمیل را برای پروژه خود فعال کنید . توجه داشته باشید که فعال کردن این ویژگی رفتار گزارش خطای Firebase Authentication را تغییر می‌دهد: مطمئن شوید که برنامه شما به خطاهای خاص‌تری متکی نیست.

مراحل بعدی

پس از اینکه کاربر برای اولین بار وارد سیستم شد، یک حساب کاربری جدید ایجاد می‌شود و به اعتبارنامه‌ها (یعنی نام کاربری و رمز عبور، شماره تلفن یا اطلاعات ارائه‌دهنده تاییدیه) مرتبط می‌شود که کاربر با آن وارد شده است. این حساب جدید به‌عنوان بخشی از پروژه Firebase شما ذخیره می‌شود و می‌توان از آن برای شناسایی کاربر در همه برنامه‌های پروژه شما، صرف نظر از نحوه ورود کاربر به سیستم استفاده کرد.

در برنامه های خود، می توانید اطلاعات اولیه نمایه کاربر را از شی User دریافت کنید. به مدیریت کاربران مراجعه کنید.
در قوانین امنیتی Firebase Realtime Database و Cloud Storage خود، می‌توانید شناسه کاربری منحصر به فرد کاربر واردشده به سیستم را از متغیر auth دریافت کنید و از آن برای کنترل داده‌هایی که کاربر می‌تواند به آن دسترسی داشته باشد استفاده کنید.

می‌توانید به کاربران اجازه دهید با استفاده از چندین ارائه‌دهنده احراز هویت، با پیوند دادن اعتبار ارائه‌دهنده تأیید اعتبار به یک حساب کاربری موجود، به برنامه شما وارد شوند.

برای خروج از سیستم یک کاربر، با signOut: .

سویفت

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

هدف-C

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

همچنین ممکن است بخواهید کد رسیدگی به خطا را برای طیف کامل خطاهای احراز هویت اضافه کنید. به رسیدگی به خطاها مراجعه کنید.