میتوانید از Firebase Authentication استفاده کنید تا به کاربران اجازه دهید بااستفاده از نشانی ایمیل و گذرواژه خود در Firebase اصالتسنجی کنند و حسابهای مبتنی بر گذرواژه برنامهتان را مدیریت کنید.
پیامواره هوش مصنوعی برای کمک هوش مصنوعی
برای کمک هوش مصنوعی، پیامواره زیر را در عامل کدنویسی هوش مصنوعی خود (مانند Antigravity، Claude Code، Codex، و Cursor) کپی کنید. میتوانید پیامواره را سفارشیسازی کنید و با عاملتان تکرار کنید. برای اطلاعات دقیق نصب، به مهارتهای عامل Firebase مراجعه کنید.
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.
قبل از شروع
از Swift Package Manager برای نصب و مدیریت وابستگیهای Firebase استفاده کنید.
- در Xcode، درحالیکه پروژه برنامهتان باز است، به File (فایل) > Add Packages (افزودن بستهها) بروید.
- وقتی خواسته شد، مخزن کیت توسعه نرمافزار Firebase Apple platforms را اضافه کنید:
- کتابخانه Firebase Authentication را انتخاب کنید.
- پرچم
-ObjCرا به بخش Other Linker Flags (سایر پرچمهای پیونددهنده) در تنظیمات ساخت هدف اضافه کنید. - وقتی تمام شد، Xcode بهطور خودکار شروع به حل و بارگیری وابستگیهای شما در پسزمینه میکند.
https://github.com/firebase/firebase-ios-sdk.git
سپس، چند مرحله پیکربندی را انجام دهید:
- اگر هنوز برنامهتان را به پروژه Firebase متصل نکردهاید، این کار را از کنسول Firebase انجام دهید.
-
«ایمیل/ گذرواژه» را بهعنوان ارائهدهنده ورود به سیستم برای پروژه Firebase خود فعال کنید:
- در کنسول Firebase، به امنیت > اصالتسنجی بروید.
- در برگه روش ورود به سیستم، ارائهدهنده ورود به سیستم ایمیل/گذرواژه را فعال کنید.
- روی ذخیره کردن کلیک کنید.
ایجاد حساب مبتنی بر گذرواژه
برای ایجاد حساب کاربری جدید با گذرواژه، مراحل زیر را در فعالیت ورود به سیستم برنامهتان تکمیل کنید:
- واحد
FirebaseCoreرا درUIApplicationDelegateو همچنین هر واحد Firebase دیگری که نماینده برنامهتان استفاده میکند وارد کنید. برای مثال، برای استفاده از Cloud Firestore و Authentication:SwiftUI
import SwiftUI import FirebaseCore import FirebaseFirestore import FirebaseAuth // ...
Swift
import FirebaseCore import FirebaseFirestore import FirebaseAuth // ...
Objective-C
@import FirebaseCore; @import FirebaseFirestore; @import FirebaseAuth; // ...
- یک
FirebaseAppنمونه مشترک را در روشapplication(_:didFinishLaunchingWithOptions:)نماینده برنامهتان پیکربندی کنید: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];
- اگر از SwiftUI استفاده میکنید، باید یک نماینده برنامه ایجاد کنید و آن را
ازطریق
UIApplicationDelegateAdaptorیاNSApplicationDelegateAdaptorبه ساختارAppخود متصل کنید. همچنین باید «تعویض نماینده برنامه» را غیرفعال کنید. برای اطلاعات بیشتر، دستورالعملهای 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، حساب جدیدی ایجاد کنید.اگر حساب جدید با موفقیت ایجاد شد، کاربر به سیستم وارد میشود و شما میتوانید دادههای حساب کاربر را از شیء نتیجه که به روش callback ارسال شده است دریافت کنید.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) { // ... }];
ورود کاربر به سیستم با نشانی ایمیل و گذرواژه
مراحل ورود به سیستم کاربر با گذرواژه مشابه مراحل ایجاد حساب جدید است. در فعالیت ورود به سیستم برنامهتان، موارد زیر را انجام دهید:
- واحد
FirebaseCoreرا درUIApplicationDelegateو همچنین هر واحد Firebase دیگری که نماینده برنامهتان استفاده میکند وارد کنید. برای مثال، برای استفاده از Cloud Firestore و Authentication:SwiftUI
import SwiftUI import FirebaseCore import FirebaseFirestore import FirebaseAuth // ...
Swift
import FirebaseCore import FirebaseFirestore import FirebaseAuth // ...
Objective-C
@import FirebaseCore; @import FirebaseFirestore; @import FirebaseAuth; // ...
- یک
FirebaseAppنمونه مشترک را در روشapplication(_:didFinishLaunchingWithOptions:)نماینده برنامهتان پیکربندی کنید: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];
- اگر از SwiftUI استفاده میکنید، باید یک نماینده برنامه ایجاد کنید و آن را
ازطریق
UIApplicationDelegateAdaptorیاNSApplicationDelegateAdaptorبه ساختارAppخود متصل کنید. همچنین باید «تعویض نماینده برنامه» را غیرفعال کنید. برای اطلاعات بیشتر، دستورالعملهای 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ارسال کنید.اگر کاربر با موفقیت به سیستم وارد شود، میتوانید دادههای حساب کاربر را از شیء نتیجه که به روش callback ارسال شده است دریافت کنید.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) { // ... }];
توصیهشده: تنظیم خطمشی گذرواژه
با اعمال الزامات پیچیدگی گذرواژه میتوانید امنیت حساب را بهبود دهید.
برای پیکربندی خطمشی گذرواژه برای پروژهتان، بخش خطمشی گذرواژه را در برگه امنیت > اصالتسنجی > تنظیمات در کنسول Firebase باز کنید:
خطمشیهای گذرواژه Firebase Authentication از الزامات گذرواژه زیر پشتیبانی میکند:
نویسه حرف کوچک لازم است
نویسه بزرگ لازم است
نویسه عددی لازم است
نویسه غیرالفباعددی لازم است
نویسههای زیر شرط نویسه غیرالفباعددی را برآورده میکنند:
^ $ * . [ ] { } ( ) ? " ! @ # % & / \ , > < ' : ; | _ ~حداقل طول گذرواژه (بین ۶ تا ۳۰ نویسه؛ پیشفرض ۶ است)
حداکثر طول گذرواژه (حداکثر طول ۴۰۹۶ نویسه)
میتوانید اجرای خطمشی گذرواژه را در دو حالت فعال کنید:
الزامی: تلاش برای ثبتنام ناموفق خواهد بود تا زمانیکه کاربر گذرواژهای را بهروز کند که با خطمشی شما مطابقت داشته باشد.
اعلان: کاربران میتوانند با گذرواژه ناسازگار ثبتنام کنند. هنگام استفاده از این حالت، باید بررسی کنید که آیا گذرواژه کاربر با خطمشی در سمت کارخواه مطابقت دارد یا نه و اگر مطابقت ندارد، به نحوی از کاربر بخواهید گذرواژهاش را بهروز کند.
کاربران جدید همیشه باید گذرواژهای انتخاب کنند که با خطمشی شما مطابقت داشته باشد.
اگر کاربر فعال دارید، توصیه میکنیم ارتقای اجباری را هنگام ورود به سیستم فعال نکنید مگر اینکه بخواهید دسترسی کاربرانی را که گذرواژهشان با خطمشی شما مطابقت ندارد مسدود کنید. بهجای آن، از حالت اعلان استفاده کنید که به کاربران اجازه میدهد با گذرواژههای فعلیشان به سیستم وارد شوند و آنها را از الزاماتی که گذرواژهشان ندارد مطلع کنید.
توصیهشده: فعال کردن محافظت دربرابر شمارش ایمیل
برخیاز روشهای Firebase Authentication که نشانیهای ایمیل را بهعنوان پارامتر میگیرند، خطاهای خاصی را درصورت ثبتنشده بودن نشانی ایمیل (درحالیکه باید ثبتشده باشد) (برای مثال، هنگام ورود به سیستم با نشانی ایمیل و گذرواژه) یا ثبتشده بودن آن (درحالیکه باید استفادهنشده باشد) (برای مثال، هنگام تغییر نشانی ایمیل کاربر) نشان میدهند. اگرچه این کار میتواند برای پیشنهاد دادن راهحلهای خاص به کاربران مفید باشد، اما عاملان بدخواه نیز میتوانند از آن سوءاستفاده کنند تا نشانیهای ایمیل ثبتشده توسط کاربرانتان را پیدا کنند.
برای کاهش این خطر، توصیه میکنیم مطمئن شوید محافظت دربرابر شمارش ایمیل برای پروژهتان فعال باشد. میتوانید این تنظیم را در کنسول Firebase بررسی کنید: به برگه امنیت > اصالتسنجی > تنظیمات بروید و سپس روی کنشهای کاربر کلیک کنید.
توجه داشته باشید که فعال کردن این ویژگی رفتار گزارش خطا را برای Firebase Authentication تغییر میدهد، بنابراین مطمئن شوید برنامهتان به خطاهای خاصتر متکی نباشد.
مراحل بعدی
پساز اینکه کاربر برای اولینبار به سیستم وارد شد، حساب کاربری جدیدی ایجاد میشود و به اطلاعات اعتباری (یعنی نام کاربری و گذرواژه، شماره تلفن، یا اطلاعات ارائهدهنده احراز هویت) که کاربر با آن به سیستم وارد شده است پیوند داده میشود. این حساب جدید بهعنوان بخشی از پروژه Firebase شما ذخیره میشود و میتوان از آن برای شناسایی کاربر در هر برنامه در پروژه شما، صرفنظر از نحوه ورود کاربر به سیستم، استفاده کرد.
-
در برنامههایتان، میتوانید اطلاعات نمایه پایه کاربر را از شیء
Userدریافت کنید. مدیریت کاربران را ببینید. در Firebase Realtime Database و Cloud Storage قوانین امنیتی، میتوانید شناسه کاربر منحصربهفرد کاربر واردشده به سیستم را از متغیر
authدریافت کنید، و از آن برای کنترل دادههایی که کاربر میتواند به آنها دسترسی داشته باشد استفاده کنید.
میتوانید به کاربران اجازه دهید بااستفاده از چند ارائهدهنده اصالتسنجی به سیستم برنامهتان وارد شوند. برای این کار، اعتبارنامههای ارائهدهنده اصالتسنجی را به حساب کاربری موجود پیوند دهید.
برای خارج کردن کاربر از سیستم،
signOut: را فراخوانی کنید.
Swift
let firebaseAuth = Auth.auth() do { try firebaseAuth.signOut() } catch let signOutError as NSError { print("Error signing out: %@", signOutError) }
Objective-C
NSError *signOutError; BOOL status = [[FIRAuth auth] signOut:&signOutError]; if (!status) { NSLog(@"Error signing out: %@", signOutError); return; }
همچنین ممکن است بخواهید کد رسیدگی به خطا را برای طیف کامل خطاهای اصالتسنجی اضافه کنید. رسیدگی به خطاها را ببینید.