אתם יכולים להשתמש ב-Firebase Authentication כדי לאפשר למשתמשים לאמת את הזהות שלהם ב-Firebase באמצעות כתובות האימייל והסיסמאות שלהם, ולנהל את החשבונות שמבוססים על סיסמאות באפליקציה.
הנחיית AI לכלים מבוססי-AI
כדי לקבל עזרה מ-AI, מעתיקים את ההנחיה שבהמשך אל סוכן ה-AI לתכנות (כמו 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 (קובץ > הוספת חבילות).
- כשמוצגת בקשה, מוסיפים את מאגר ה-SDK של Firebase לפלטפורמות של אפל:
- בוחרים בספרייה Firebase Authentication.
- מוסיפים את הדגל
-ObjCלקטע Other Linker Flags (דגלים אחרים של מקשרים) בהגדרות ה-build של היעד. - אחרי שתסיימו, פלטפורמת Xcode תתחיל לטפל ביחסי התלות ולהוריד אותם באופן אוטומטי ברקע.
https://github.com/firebase/firebase-ios-sdk.git
עכשיו מבצעים כמה שלבי הגדרה:
- אם עדיין לא קישרתם את האפליקציה לפרויקט Firebase, אתם צריכים לעשות את זה דרך מסוף Firebase.
-
מפעילים את האפשרות "אימייל/סיסמה" כספק כניסה לפרויקט ב-Firebase:
- במסוף Firebase, נכנסים אל אבטחה > אימות.
- בכרטיסייה שיטת כניסה לחשבון, מפעילים את ספק הכניסה Email/password.
- לוחצים על שמירה.
יצירת חשבון שמבוסס על סיסמה
כדי ליצור חשבון משתמש חדש עם סיסמה, מבצעים את השלבים הבאים בפעילות הכניסה של האפליקציה:
- מייבאים את המודול
FirebaseCoreבקובץUIApplicationDelegate, וגם כל מודול Firebase אחר שבו משתמש ה-app delegate. לדוגמה, כדי להשתמש ב-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ב-methodapplication(_: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, אתם צריכים ליצור נציג של האפליקציה ולצרף אותו ל-struct של
AppבאמצעותUIApplicationDelegateAdaptorאוNSApplicationDelegateAdaptor. צריך גם להשבית את ה-swizzling של ה-app delegate. מידע נוסף זמין בהוראות של 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.אם החשבון החדש נוצר בהצלחה, המשתמש מחובר ואפשר לקבל את נתוני החשבון של המשתמש מאובייקט התוצאה שמועבר לשיטת הקריאה החוזרת.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 אחר שבו משתמש ה-app delegate. לדוגמה, כדי להשתמש ב-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ב-methodapplication(_: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, אתם צריכים ליצור נציג של האפליקציה ולצרף אותו ל-struct של
AppבאמצעותUIApplicationDelegateAdaptorאוNSApplicationDelegateAdaptor. צריך גם להשבית את ה-swizzling של ה-app delegate. מידע נוסף זמין בהוראות של 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.אם המשתמש נכנס לחשבון, אפשר לקבל את נתוני החשבון שלו מאובייקט התוצאה שמועבר לשיטת הקריאה החוזרת.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) { // ... }];
מומלץ: להגדיר מדיניות סיסמאות
כדי לשפר את אבטחת החשבון, אתם יכולים לאכוף דרישות מורכבות לסיסמאות.
כדי להגדיר מדיניות סיסמאות לפרויקט, פותחים את הקטע Password policy בכרטיסייה Security > Authentication > Settings במסוף Firebase:
כללי מדיניות הסיסמאות של Firebase Authentication תומכים בדרישות הבאות לגבי סיסמאות:
חובה להשתמש באות קטנה
חובה להשתמש באות רישית
חובה להשתמש בספרה
נדרש תו שאינו אלפאנומרי
התווים הבאים עומדים בדרישה לתווים שאינם אלפאנומריים:
^ $ * . [ ] { } ( ) ? " ! @ # % & / \ , > < ' : ; | _ ~אורך הסיסמה המינימלי (טווח של 6 עד 30 תווים, ברירת המחדל היא 6)
אורך הסיסמה המקסימלי (עד 4,096 תווים)
אפשר להפעיל את אכיפת מדיניות הסיסמאות בשני מצבים:
דרישה: ניסיונות ההרשמה נכשלים עד שהמשתמש מעדכן את הסיסמה כך שתעמוד בדרישות המדיניות.
התראה: המשתמשים יכולים להירשם עם סיסמה שלא עומדת בדרישות. כשמשתמשים במצב הזה, צריך לבדוק אם הסיסמה של המשתמש עומדת בדרישות המדיניות בצד הלקוח, ולבקש מהמשתמש לעדכן את הסיסמה אם היא לא עומדת בדרישות.
משתמשים חדשים תמיד נדרשים לבחור סיסמה שעומדת בדרישות המדיניות.
אם יש לכם משתמשים פעילים, מומלץ לא להפעיל את האפשרות "שדרוג מאולץ בכניסה" אלא אם אתם מתכוונים לחסום את הגישה למשתמשים שהסיסמאות שלהם לא תואמות למדיניות שלכם. במקום זאת, השתמשו במצב התראה, שמאפשר למשתמשים להיכנס עם הסיסמאות הנוכחיות שלהם, ומודיע להם על הדרישות שהסיסמה שלהם לא עומדת בהן.
מומלץ: הפעלת הגנה מפני ספירת כתובות אימייל
חלק מהשיטות של Firebase Authentication שמקבלות כתובות אימייל כפרמטרים מחזירות שגיאות ספציפיות אם כתובת האימייל לא רשומה כשהיא חייבת להיות רשומה (לדוגמה, כשנכנסים באמצעות כתובת אימייל וסיסמה), או רשומה כשהיא חייבת להיות לא בשימוש (לדוגמה, כשמשנים כתובת אימייל של משתמש). ההודעות האלה יכולות לעזור למשתמשים לפתור בעיות ספציפיות, אבל גורמים זדוניים יכולים לנצל אותן לרעה כדי לגלות את כתובות האימייל שהמשתמשים רשמו.
כדי לצמצם את הסיכון הזה, מומלץ לוודא שההגנה מפני ספירת אימיילים מופעלת בפרויקט. אפשר לבדוק את ההגדרה הזו במסוף Firebase: עוברים אל הכרטיסייה Security > Authentication > Settings ולוחצים על User actions.
חשוב לזכור שהפעלת התכונה הזו משנה את אופן הדיווח על שגיאות ב-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; }
כדאי גם להוסיף קוד לטיפול בשגיאות לכל מגוון שגיאות האימות. איך מטפלים בשגיאות