شروع به کار با «اصالت‌سنجی Firebase» در پلاتفرم‌های Apple

می‌توانید از Firebase Authentication استفاده کنید تا به کاربران اجازه دهید بااستفاده از یک یا چند روش ورود به سیستم، ازجمله ورود به سیستم با نشانی ایمیل و گذرواژه، و ارائه‌دهندگان هویت مشارکتی مانند «ورود به سیستم با Google» و «ورود به سیستم Facebook»، به سیستم برنامه شما وارد شوند. این آموزش با نشان دادن نحوه افزودن ورود به سیستم با نشانی ایمیل و گذرواژه به برنامه‌تان، شما را با Firebase Authentication آشنا می‌کند.

متصل کردن برنامه به Firebase

  1. کیت توسعه نرم‌افزار Firebase را نصب کنید.
  2. در کنسول Firebase، برنامه‌تان را به پروژه Firebase اضافه کنید.

افزودن Firebase Authentication به برنامه

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

  1. در Xcode، درحالی‌که پروژه برنامه‌تان باز است، به File > Add Packages (فایل > افزودن بسته‌ها) بروید.
  2. وقتی خواسته شد، مخزن کیت توسعه نرم‌افزار Firebase برای پلاتفرم‌های Apple را اضافه کنید:
  3.   https://github.com/firebase/firebase-ios-sdk.git
  4. کتابخانه Firebase Authentication را انتخاب کنید.
  5. پرچم -ObjC را به بخش Other Linker Flags (سایر پرچم‌های پیونددهنده) در تنظیمات ساخت هدف اضافه کنید.
  6. وقتی تمام شد، Xcode به‌طور خودکار شروع به حل و بارگیری وابستگی‌های شما در پس‌زمینه می‌کند.

(اختیاری) نمونه نخستین و آزمایش با Firebase Local Emulator Suite

قبل‌از صحبت درباره نحوه اصالت‌سنجی کاربران توسط برنامه‌تان، اجازه دهید مجموعه‌ای از ابزارها را معرفی کنیم که می‌توانید برای نمونه‌سازی و آزمایش عملکرد Authentication استفاده کنید: Firebase Local Emulator Suite. اگر درحال تصمیم‌گیری بین تکنیک‌ها و ارائه‌دهندگان اصالت‌سنجی هستید، مدل‌های داده مختلف را با داده‌های عمومی و خصوصی بااستفاده از Authentication و Firebase Security Rules امتحان می‌کنید، یا طرح‌های میانای کاربری ورود به سیستم را نمونه‌سازی می‌کنید، توانایی کار محلی بدون استقرار خدمات زنده می‌تواند ایده خوبی باشد.

شبیه‌ساز Authentication بخشی از Local Emulator Suite است که به برنامه شما امکان می‌دهد با محتوا و پیکربندی پایگاه داده شبیه‌سازی‌شده و همچنین به‌صورت اختیاری با منابع پروژه شبیه‌سازی‌شده (توابع، پایگاه‌های داده دیگر، و قوانین امنیتی) تعامل داشته باشد.

استفاده از شبیه‌ساز Authentication فقط چند مرحله دارد:

  1. افزودن یک خط کد به پیکربندی آزمایشی برنامه‌تان برای اتصال به شبیه‌ساز.
  2. از ریشه دایرکتوری پروژه محلی، firebase emulators:start را اجرا کنید.
  3. استفاده از میانای کاربر Local Emulator Suite برای نمونه‌سازی تعاملی، یا Authentication میانای برنامه‌سازی کاربردی REST شبیه‌ساز برای آزمایش غیرتعاملی.

راهنمای مفصلی در اتصال برنامه به شبیه‌ساز Authentication دردسترس است. برای اطلاعات بیشتر، به مقدمه Local Emulator Suite مراجعه کنید.

اکنون بیایید با نحوه اصالت‌سنجی کاربران ادامه دهیم.

مقداردهی اولیه کیت توسعه نرم‌افزار Firebase

در نماینده برنامه‌تان، ابتدا کیت توسعه نرم‌افزار Firebase را وارد کنید:

Swift

import FirebaseCore

Objective-C

@import FirebaseCore;

سپس، در روش application:didFinishLaunchingWithOptions:، شیء FirebaseApp را مقداردهی اولیه کنید:

Swift

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

Objective-C

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

گوش دادن به وضعیت اصالت‌سنجی

برای هریک از نماهای برنامه‌تان که به اطلاعاتی درباره کاربر واردشده به سیستم نیاز دارد، شنونده‌ای به شیء FIRAuth پیوست کنید. هرگاه وضعیت ورود به سیستم کاربر تغییر کند، این شنونده فراخوانده می‌شود.

شنونده را در روش viewWillAppear کنترل‌کننده نما پیوست کنید:

Swift

handle = Auth.auth().addStateDidChangeListener { auth, user in
  // ...
}

Objective-C

self.handle = [[FIRAuth auth]
    addAuthStateDidChangeListener:^(FIRAuth *_Nonnull auth, FIRUser *_Nullable user) {
      // ...
    }];

و شنونده را در روش viewWillDisappear کنترل‌کننده نما جدا کنید:

Swift

Auth.auth().removeStateDidChangeListener(handle!)

Objective-C

[[FIRAuth auth] removeAuthStateDidChangeListener:_handle];

ثبت‌نام کاربران جدید

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

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) {
  // ...
}];

ورود به سیستم کاربران فعلی

فرمی ایجاد کنید که به کاربران موجود اجازه دهد بااستفاده از نشانی ایمیل و گذرواژه خود به سیستم وارد شوند. وقتی کاربر فرم را تکمیل کرد، روش signIn را فراخوانی کنید:

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) {
  // ...
}];

دریافت اطلاعات کاربر

پس‌از اینکه کاربر باموفقیت به سیستم وارد شد، می‌توانید اطلاعاتی درباره کاربر دریافت کنید. برای مثال، در شنونده وضعیت اصالت‌سنجی:

Swift

if let user = user {
  // The user's ID, unique to the Firebase project.
  // Do NOT use this value to authenticate with your backend server,
  // if you have one. Use getTokenWithCompletion:completion: instead.
  let uid = user.uid
  let email = user.email
  let photoURL = user.photoURL
  var multiFactorString = "MultiFactor: "
  for info in user.multiFactor.enrolledFactors {
    multiFactorString += info.displayName ?? "[DispayName]"
    multiFactorString += " "
  }
  // ...
}

Objective-C

if (user) {
  // The user's ID, unique to the Firebase project.
  // Do NOT use this value to authenticate with your backend server,
  // if you have one. Use getTokenWithCompletion:completion: instead.
  NSString *email = user.email;
  NSString *uid = user.uid;
  NSMutableString *multiFactorString = [NSMutableString stringWithFormat:@"MultiFactor: "];
  for (FIRMultiFactorInfo *info in user.multiFactor.enrolledFactors) {
    [multiFactorString appendString:info.displayName];
    [multiFactorString appendString:@" "];
  }
  NSURL *photoURL = user.photoURL;
  // ...
}

مراحل بعدی

با نحوه افزودن پشتیبانی برای سایر ارائه‌دهندگان هویت و حساب‌های مهمان ناشناس آشنا شوید: