אימות עם Firebase באמצעות חשבונות מבוססי-סיסמה באמצעות JavaScript

אתם יכולים להשתמש ב-Firebase Authentication כדי לאפשר למשתמשים לאמת את הזהות שלהם ב-Firebase באמצעות כתובות האימייל והסיסמאות שלהם, ולנהל את החשבונות שמבוססים על סיסמאות באפליקציה.

כדי לקבל עזרה מ-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.

לפני שמתחילים

  1. מוסיפים את Firebase לפרויקט ב-JavaScript.
  2. אם עדיין לא קישרתם את האפליקציה לפרויקט Firebase, אתם צריכים לעשות את זה דרך מסוף Firebase.
  3. מפעילים את האפשרות "אימייל/סיסמה" כספק כניסה לפרויקט ב-Firebase:
    1. במסוף Firebase, נכנסים אל אבטחה > אימות.
    2. בכרטיסייה שיטת כניסה לחשבון, מפעילים את ספק הכניסה Email/password.
    3. לוחצים על שמירה.

יצירת חשבון שמבוסס על סיסמה

כדי ליצור חשבון משתמש חדש עם סיסמה, מבצעים את השלבים הבאים בדף ההרשמה של האפליקציה:

  1. כשמשתמש חדש נרשם באמצעות טופס ההרשמה של האפליקציה, משלימים את כל שלבי האימות של החשבון החדש שהאפליקציה דורשת, כמו אימות שהסיסמה של החשבון החדש הוקלדה בצורה נכונה ועומדת בדרישות המורכבות.
  2. יוצרים חשבון חדש על ידי העברת כתובת האימייל והסיסמה של המשתמש החדש אל createUserWithEmailAndPassword:

    Web

    import { getAuth, createUserWithEmailAndPassword } from "firebase/auth";
    
    const auth = getAuth();
    createUserWithEmailAndPassword(auth, email, password)
      .then((userCredential) => {
        // Signed up 
        const user = userCredential.user;
        // ...
      })
      .catch((error) => {
        const errorCode = error.code;
        const errorMessage = error.message;
        // ..
      });

    Web

    firebase.auth().createUserWithEmailAndPassword(email, password)
      .then((userCredential) => {
        // Signed in 
        var user = userCredential.user;
        // ...
      })
      .catch((error) => {
        var errorCode = error.code;
        var errorMessage = error.message;
        // ..
      });
    אם החשבון החדש נוצר, המשתמש מחובר אוטומטית. כדי לקבל את פרטי המשתמש המחובר, עיינו בקטע "השלבים הבאים" שבהמשך.

    כאן אפשר גם לזהות שגיאות ולטפל בהן. רשימה של קודי שגיאה מופיעה במסמכי העזר בנושא אימות.

כניסה של משתמש עם כתובת אימייל וסיסמה

השלבים לכניסת משתמש באמצעות סיסמה דומים לשלבים ליצירת חשבון חדש. בדף הכניסה של האפליקציה, מבצעים את הפעולות הבאות:

  1. כשמשתמש נכנס לאפליקציה, מעבירים את כתובת האימייל והסיסמה של המשתמש אל signInWithEmailAndPassword:

    Web

    import { getAuth, signInWithEmailAndPassword } from "firebase/auth";
    
    const auth = getAuth();
    signInWithEmailAndPassword(auth, email, password)
      .then((userCredential) => {
        // Signed in 
        const user = userCredential.user;
        // ...
      })
      .catch((error) => {
        const errorCode = error.code;
        const errorMessage = error.message;
      });

    Web

    firebase.auth().signInWithEmailAndPassword(email, password)
      .then((userCredential) => {
        // Signed in
        var user = userCredential.user;
        // ...
      })
      .catch((error) => {
        var errorCode = error.code;
        var errorMessage = error.message;
      });
    כדי לקבל את פרטי המשתמש המחובר, עיינו בקטע "השלבים הבאים" שבהמשך.

    כאן אפשר גם לזהות שגיאות ולטפל בהן. רשימה של קודי שגיאה מופיעה במסמכי העזר בנושא אימות.

מומלץ: להגדיר מדיניות סיסמאות

כדי לשפר את אבטחת החשבון, אתם יכולים לאכוף דרישות מורכבות לסיסמאות.

כדי להגדיר מדיניות סיסמאות לפרויקט, פותחים את הקטע Password policy בכרטיסייה Security > Authentication > Settings במסוף Firebase:

הגדרות אימות

כללי מדיניות הסיסמאות של Firebase Authentication תומכים בדרישות הבאות לגבי סיסמאות:

  • חובה להשתמש באות קטנה

  • חובה להשתמש באות רישית

  • חובה להשתמש בספרה

  • נדרש תו שאינו אלפאנומרי

    התווים הבאים עומדים בדרישה לתווים שאינם אלפאנומריים: ^ $ * . [ ] { } ( ) ? " ! @ # % & / \ , > < ' : ; | _ ~

  • אורך הסיסמה המינימלי (טווח של 6 עד 30 תווים, ברירת המחדל היא 6)

  • אורך הסיסמה המקסימלי (עד 4,096 תווים)

אפשר להפעיל את אכיפת מדיניות הסיסמאות בשני מצבים:

  • דרישה: ניסיונות ההרשמה נכשלים עד שהמשתמש מעדכן את הסיסמה כך שתעמוד בדרישות המדיניות.

  • התראה: המשתמשים יכולים להירשם עם סיסמה שלא עומדת בדרישות. כשמשתמשים במצב הזה, צריך לבדוק אם הסיסמה של המשתמש עומדת בדרישות המדיניות בצד הלקוח, ולבקש מהמשתמש לעדכן את הסיסמה אם היא לא עומדת בדרישות.

משתמשים חדשים תמיד נדרשים לבחור סיסמה שעומדת בדרישות המדיניות.

אם יש לכם משתמשים פעילים, מומלץ לא להפעיל את האפשרות "שדרוג מאולץ בכניסה" אלא אם אתם מתכוונים לחסום את הגישה למשתמשים שהסיסמאות שלהם לא תואמות למדיניות שלכם. במקום זאת, השתמשו במצב התראה, שמאפשר למשתמשים להיכנס עם הסיסמאות הנוכחיות שלהם, ומודיע להם על הדרישות שהסיסמה שלהם לא עומדת בהן.

אימות סיסמה בצד הלקוח

import { getAuth, validatePassword } from "firebase/auth";
const status = await validatePassword(getAuth(), passwordFromUser);
if (!status.isValid) {
  // Password could not be validated. Use the status to show what
  // requirements are met and which are missing.

  // If a criterion is undefined, it is not required by policy. If the
  // criterion is defined but false, it is required but not fulfilled by
  // the given password. For example:
  const needsLowerCase = status.containsLowercaseLetter !== true;
}

מומלץ: הפעלת הגנה מפני ספירת כתובות אימייל

חלק מהשיטות של Firebase Authentication שמקבלות כתובות אימייל כפרמטרים מחזירות שגיאות ספציפיות אם כתובת האימייל לא רשומה כשהיא חייבת להיות רשומה (לדוגמה, כשנכנסים באמצעות כתובת אימייל וסיסמה), או רשומה כשהיא חייבת להיות לא בשימוש (לדוגמה, כשמשנים כתובת אימייל של משתמש). ההודעות האלה יכולות לעזור למשתמשים לפתור בעיות ספציפיות, אבל גורמים זדוניים יכולים לנצל אותן לרעה כדי לגלות את כתובות האימייל שהמשתמשים רשמו.

כדי לצמצם את הסיכון הזה, מומלץ לוודא שההגנה מפני ספירת אימיילים מופעלת בפרויקט. אפשר לבדוק את ההגדרה הזו במסוף Firebase: עוברים אל הכרטיסייה Security ‏> Authentication ‏> Settings ולוחצים על User actions.

חשוב לזכור שהפעלת התכונה הזו משנה את אופן הדיווח על שגיאות ב-Firebase Authentication, לכן צריך לוודא שהאפליקציה לא מסתמכת על השגיאות הספציפיות יותר.

השלבים הבאים

אחרי שמשתמש נכנס לחשבון בפעם הראשונה, נוצר חשבון משתמש חדש שמקושר לפרטי הכניסה – כלומר, שם המשתמש והסיסמה, מספר הטלפון או פרטי ספק האימות – שאיתם המשתמש נכנס לחשבון. החשבון החדש הזה נשמר כחלק מהפרויקט ב-Firebase, ואפשר להשתמש בו כדי לזהות משתמש בכל אפליקציה בפרויקט, בלי קשר לאופן שבו המשתמש נכנס לחשבון.

  • באפליקציות, הדרך המומלצת לדעת את סטטוס האימות של המשתמש היא להגדיר משקיף באובייקט Auth. לאחר מכן תוכלו לקבל את פרטי הפרופיל הבסיסיים של המשתמש מהאובייקט User. ניהול משתמשים

  • בכללי האבטחה של Firebase Realtime Database ו-Cloud Storage, אפשר לקבל את מזהה המשתמש הייחודי של המשתמש המחובר מהמשתנה auth, ולהשתמש בו כדי לקבוע לאילו נתונים המשתמש יכול לגשת.

אתם יכולים לאפשר למשתמשים להיכנס לאפליקציה באמצעות כמה ספקי אימות, על ידי קישור פרטי הכניסה של ספק האימות לחשבון משתמש קיים.

כדי להוציא משתמש מהחשבון, מפעילים את signOut:

Web

import { getAuth, signOut } from "firebase/auth";

const auth = getAuth();
signOut(auth).then(() => {
  // Sign-out successful.
}).catch((error) => {
  // An error happened.
});

Web

firebase.auth().signOut().then(() => {
  // Sign-out successful.
}).catch((error) => {
  // An error happened.
});