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

شما می‌توانید Firebase Authentication با یک سیستم احراز هویت سفارشی ادغام کنید، به این صورت که سرور احراز هویت خود را طوری تغییر دهید که وقتی کاربر با موفقیت وارد سیستم می‌شود، توکن‌های امضا شده سفارشی تولید کند. برنامه شما این توکن را دریافت کرده و از آن برای احراز هویت با فایربیس استفاده می‌کند.

قبل از اینکه شروع کنی

1. یک پروژه Firebase ایجاد کنید و اگر قبلاً برنامه خود را ثبت نکرده‌اید، آن را ثبت کنید .

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

   برای آشنایی با روش‌های مختلف افزودن SDKهای فایربیس به پروژه اپل خود، از جمله وارد کردن مستقیم فریم‌ورک‌ها و استفاده از CocoaPods، به راهنمای نصب ما مراجعه کنید.
   1. در Xcode، با باز کردن پروژه برنامه خود، به File > Add Packages بروید.
   2. وقتی از شما خواسته شد، مخزن SDK پلتفرم‌های اپل فایربیس را اضافه کنید:

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

   توجه: پروژه‌های جدید باید از نسخه پیش‌فرض (آخرین) SDK استفاده کنند، اما در صورت نیاز می‌توانید نسخه قدیمی‌تر را انتخاب کنید.
   3. کتابخانه Firebase Authentication را انتخاب کنید.
   4. پرچم -ObjC را به بخش Other Linker Flags در تنظیمات ساخت هدف خود اضافه کنید.
   5. پس از اتمام، Xcode به طور خودکار شروع به حل و دانلود وابستگی‌های شما در پس‌زمینه می‌کند.
3. کلیدهای سرور پروژه خود را دریافت کنید:
   1. به صفحه حساب‌های سرویس در تنظیمات پروژه خود بروید.
   2. در پایین بخش Firebase Admin SDK از صفحه حساب‌های سرویس ، روی «ایجاد کلید خصوصی جدید» کلیک کنید.
   3. جفت کلید عمومی/خصوصی حساب سرویس جدید به طور خودکار در رایانه شما ذخیره می‌شود. این فایل را در سرور احراز هویت خود کپی کنید.

احراز هویت با فایربیس

1. ماژول FirebaseCore را در UIApplicationDelegate خود وارد کنید، و همچنین هر ماژول Firebase دیگری که app delegate شما از آن استفاده می‌کند. به عنوان مثال، برای استفاده از Cloud Firestore و Authentication :

   سویفت‌یو‌آی

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

   سویفت

   import FirebaseCore
   import FirebaseFirestore
   import FirebaseAuth
   // ...
         

   هدف-سی

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

2. یک نمونه اشتراکی FirebaseApp در application(_:didFinishLaunchingWithOptions:) از نماینده برنامه خود پیکربندی کنید:

   سویفت‌یو‌آی

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

   سویفت

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

   هدف-سی

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

3. اگر از SwiftUI استفاده می‌کنید، باید یک نماینده برنامه ایجاد کنید و آن را از طریق UIApplicationDelegateAdaptor یا NSApplicationDelegateAdaptor به ساختار App خود پیوست کنید. همچنین باید swizzling نماینده برنامه را غیرفعال کنید. برای اطلاعات بیشتر، به دستورالعمل‌های SwiftUI مراجعه کنید.

   سویفت‌یو‌آی

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

4. وقتی کاربران وارد برنامه شما می‌شوند، اطلاعات ورود آنها (مثلاً نام کاربری و رمز عبور) را به سرور احراز هویت شما ارسال می‌کنند. سرور شما اطلاعات را بررسی می‌کند و در صورت معتبر بودن، یک توکن سفارشی برمی‌گرداند.
5. پس از دریافت توکن سفارشی از سرور احراز هویت خود، آن را به signInWithCustomToken ارسال کنید تا کاربر وارد سیستم شود:

   سویفت

   Auth.auth().signIn(withCustomToken: customToken ?? "") { user, error in
     // ...
   }

   هدف-سی

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

مراحل بعدی

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

• در برنامه‌های خود، می‌توانید اطلاعات اولیه پروفایل کاربر را از شیء User دریافت کنید. به بخش مدیریت کاربران مراجعه کنید.

• در قوانین امنیتی پایگاه داده و Cloud Storage Firebase Realtime Database ، می‌توانید شناسه کاربری منحصر به فرد کاربر وارد شده را از متغیر auth دریافت کنید و از آن برای کنترل داده‌هایی که کاربر می‌تواند به آنها دسترسی داشته باشد، استفاده کنید.

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

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

سویفت

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;
}

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