میتوانید از Firebase Authentication استفاده کنید تا به کاربران اجازه دهید بااستفاده از یک یا چند روش ورود به سیستم، ازجمله ورود به سیستم با نشانی ایمیل و گذرواژه، و ارائهدهندگان هویت مشارکتی مانند «ورود به سیستم با Google» و «ورود به سیستم Facebook»، به سیستم برنامه شما وارد شوند. این آموزش با نشان دادن نحوه افزودن ورود به سیستم با نشانی ایمیل و گذرواژه به برنامهتان، شما را با Firebase Authentication آشنا میکند.
متصل کردن برنامه به Firebase
- کیت توسعه نرمافزار Firebase را نصب کنید.
- در کنسول Firebase، برنامهتان را به پروژه Firebase اضافه کنید.
افزودن Firebase Authentication به برنامه
از Swift Package Manager برای نصب و مدیریت وابستگیهای Firebase استفاده کنید.
- در Xcode، درحالیکه پروژه برنامهتان باز است، به File > Add Packages (فایل > افزودن بستهها) بروید.
- وقتی خواسته شد، مخزن کیت توسعه نرمافزار Firebase برای پلاتفرمهای Apple را اضافه کنید:
- کتابخانه Firebase Authentication را انتخاب کنید.
- پرچم
-ObjCرا به بخش Other Linker Flags (سایر پرچمهای پیونددهنده) در تنظیمات ساخت هدف اضافه کنید. - وقتی تمام شد، Xcode بهطور خودکار شروع به حل و بارگیری وابستگیهای شما در پسزمینه میکند.
https://github.com/firebase/firebase-ios-sdk.git
(اختیاری) نمونه نخستین و آزمایش با Firebase Local Emulator Suite
قبلاز صحبت درباره نحوه اصالتسنجی کاربران توسط برنامهتان، اجازه دهید مجموعهای از ابزارها را معرفی کنیم که میتوانید برای نمونهسازی و آزمایش عملکرد Authentication استفاده کنید: Firebase Local Emulator Suite. اگر درحال تصمیمگیری بین تکنیکها و ارائهدهندگان اصالتسنجی هستید، مدلهای داده مختلف را با دادههای عمومی و خصوصی بااستفاده از Authentication و Firebase Security Rules امتحان میکنید، یا طرحهای میانای کاربری ورود به سیستم را نمونهسازی میکنید، توانایی کار محلی بدون استقرار خدمات زنده میتواند ایده خوبی باشد.
شبیهساز Authentication بخشی از Local Emulator Suite است که به برنامه شما امکان میدهد با محتوا و پیکربندی پایگاه داده شبیهسازیشده و همچنین بهصورت اختیاری با منابع پروژه شبیهسازیشده (توابع، پایگاههای داده دیگر، و قوانین امنیتی) تعامل داشته باشد.
استفاده از شبیهساز Authentication فقط چند مرحله دارد:
- افزودن یک خط کد به پیکربندی آزمایشی برنامهتان برای اتصال به شبیهساز.
- از ریشه دایرکتوری پروژه محلی،
firebase emulators:startرا اجرا کنید. - استفاده از میانای کاربر 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;
// ...
}
مراحل بعدی
با نحوه افزودن پشتیبانی برای سایر ارائهدهندگان هویت و حسابهای مهمان ناشناس آشنا شوید:
- ورود به سیستم با Google
- ورود به سیستم فیسبوک
- ورود به سیستم توییتر
- ورود به سیستم GitHub
- ورود ناشناس به سیستم