احراز هویت با Firebase با استفاده از حساب های مبتنی بر رمز عبور با استفاده از جاوا اسکریپت
با مجموعهها، منظم بمانید
ذخیره و طبقهبندی محتوا براساس اولویتهای شما.
می‌توانید از Firebase Authentication استفاده کنید تا به کاربران خود اجازه دهید با استفاده از آدرس ایمیل و گذرواژه‌های خود با Firebase احراز هویت کنند و حساب‌های مبتنی بر گذرواژه برنامه‌تان را مدیریت کنید.
در برگه روش ورود به سیستم ، روش ورود ایمیل/گذرواژه را فعال کنید و روی ذخیره کلیک کنید.
یک حساب کاربری مبتنی بر رمز عبور ایجاد کنید
برای ایجاد یک حساب کاربری جدید با رمز عبور، مراحل زیر را در صفحه ثبت نام برنامه خود انجام دهید:
وقتی کاربر جدیدی با استفاده از فرم ثبت‌نام برنامه شما ثبت‌نام می‌کند، مراحل اعتبارسنجی حساب جدیدی را که برنامه شما نیاز دارد، تکمیل کنید، مانند تأیید اینکه رمز عبور حساب جدید به درستی تایپ شده است و شرایط پیچیدگی شما را برآورده می‌کند.
با ارسال آدرس ایمیل و رمز عبور کاربر جدید به createUserWithEmailAndPassword ، یک حساب کاربری جدید ایجاد کنید:
Web
import{getAuth,createUserWithEmailAndPassword}from"firebase/auth";constauth=getAuth();createUserWithEmailAndPassword(auth,email,password).then((userCredential)=>{// Signed up constuser=userCredential.user;// ...}).catch((error)=>{consterrorCode=error.code;consterrorMessage=error.message;// ..});
firebase.auth().createUserWithEmailAndPassword(email,password).then((userCredential)=>{// Signed in varuser=userCredential.user;// ...}).catch((error)=>{varerrorCode=error.code;varerrorMessage=error.message;// ..});
اگر حساب جدید ایجاد شده باشد، کاربر به طور خودکار وارد سیستم می شود. برای دریافت جزئیات کاربر وارد شده به بخش مراحل بعدی در زیر نگاهی بیندازید.
این نیز جایی است که می توانید خطاها را پیدا کرده و کنترل کنید. برای فهرستی از کدهای خطا، به اسناد مرجع تأییدیه نگاهی بیندازید.
یک کاربر با آدرس ایمیل و رمز عبور وارد شوید
مراحل ورود کاربر با رمز عبور مشابه مراحل ایجاد یک حساب کاربری جدید است. در صفحه ورود به سیستم برنامه، موارد زیر را انجام دهید:
هنگامی که کاربر وارد برنامه شما می شود، آدرس ایمیل و رمز عبور کاربر را به signInWithEmailAndPassword ارسال کنید:
Web
import{getAuth,signInWithEmailAndPassword}from"firebase/auth";constauth=getAuth();signInWithEmailAndPassword(auth,email,password).then((userCredential)=>{// Signed in constuser=userCredential.user;// ...}).catch((error)=>{consterrorCode=error.code;consterrorMessage=error.message;});
firebase.auth().signInWithEmailAndPassword(email,password).then((userCredential)=>{// Signed invaruser=userCredential.user;// ...}).catch((error)=>{varerrorCode=error.code;varerrorMessage=error.message;});
حداقل طول رمز عبور (از 6 تا 30 کاراکتر؛ پیش‌فرض تا 6 کاراکتر)
حداکثر طول رمز عبور (حداکثر طول 4096 کاراکتر)
شما می توانید اجرای سیاست رمز عبور را در دو حالت فعال کنید:
نیاز : تلاش‌ها برای ثبت نام با شکست مواجه می‌شوند تا زمانی که کاربر رمز عبوری مطابق با خط‌مشی شما را به‌روزرسانی کند.
اطلاع رسانی : کاربران مجاز به ثبت نام با رمز عبور غیرمنطبق هستند. هنگام استفاده از این حالت، باید بررسی کنید که آیا گذرواژه کاربر با خط مشی سمت کلاینت مطابقت دارد یا خیر و از کاربر بخواهید در صورت عدم مطابقت رمز عبور خود را به نحوی به روز کند.
کاربران جدید همیشه باید رمز عبوری را انتخاب کنند که با خط مشی شما مطابقت داشته باشد.
اگر کاربران فعال دارید، توصیه می‌کنیم ارتقاء اجباری را هنگام ورود به سیستم فعال نکنید، مگر اینکه بخواهید دسترسی کاربرانی را که گذرواژه‌شان با خط‌مشی شما مطابقت ندارد مسدود کنید. در عوض، از حالت اطلاع رسانی استفاده کنید، که به کاربران اجازه می دهد با رمزهای عبور فعلی خود وارد سیستم شوند و آنها را از الزاماتی که رمز عبور آنها فاقد آن است آگاه کند.
conststatus=awaitvalidatePassword(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:constneedsLowerCase=status.containsLowercaseLetter!==true;}
توصیه می شود: حفاظت از شمارش ایمیل را فعال کنید
برخی از روش‌های Firebase Authentication که آدرس‌های ایمیل را به‌عنوان پارامتر در نظر می‌گیرند، اگر آدرس ایمیل در زمانی که باید ثبت شود ثبت نشده باشد (مثلاً هنگام ورود با آدرس ایمیل و رمز عبور)، یا زمانی که باید استفاده نشده باشد (مثلاً هنگام تغییر آدرس ایمیل کاربر) ثبت شده باشد، خطاهای خاصی ایجاد می‌کنند. در حالی که این می تواند برای پیشنهاد راه حل های خاص به کاربران مفید باشد، اما می تواند توسط عوامل مخرب برای کشف آدرس های ایمیل ثبت شده توسط کاربران شما مورد سوء استفاده قرار گیرد.
برای کاهش این خطر، توصیه می‌کنیم با استفاده از ابزار Google Cloud gcloud، حفاظت از شمارش ایمیل را برای پروژه خود فعال کنید . توجه داشته باشید که فعال کردن این ویژگی رفتار گزارش خطای Firebase Authentication را تغییر می‌دهد: مطمئن شوید که برنامه شما به خطاهای خاص‌تری متکی نیست.
مراحل بعدی
پس از اینکه کاربر برای اولین بار وارد سیستم شد، یک حساب کاربری جدید ایجاد می‌شود و به اعتبارنامه‌ها (یعنی نام کاربری و رمز عبور، شماره تلفن یا اطلاعات ارائه‌دهنده تاییدیه) مرتبط می‌شود که کاربر با آن وارد شده است. این حساب جدید به‌عنوان بخشی از پروژه Firebase شما ذخیره می‌شود و می‌توان از آن برای شناسایی کاربر در همه برنامه‌های پروژه شما، صرف نظر از نحوه ورود کاربر به سیستم استفاده کرد.
در برنامه های شما، روش توصیه شده برای اطلاع از وضعیت احراز هویت کاربر، تنظیم یک ناظر بر روی شی Auth است. سپس می توانید اطلاعات اولیه پروفایل کاربر را از شی User دریافت کنید. به مدیریت کاربران مراجعه کنید.
در قوانین امنیتیFirebase Realtime Database و Cloud Storage خود، می‌توانید شناسه کاربری منحصر به فرد کاربر واردشده به سیستم را از متغیر auth دریافت کنید و از آن برای کنترل داده‌هایی که کاربر می‌تواند به آن دسترسی داشته باشد استفاده کنید.
تاریخ آخرین به‌روزرسانی 2025-09-04 بهوقت ساعت هماهنگ جهانی.
[[["درک آسان","easyToUnderstand","thumb-up"],["مشکلم را برطرف کرد","solvedMyProblem","thumb-up"],["غیره","otherUp","thumb-up"]],[["اطلاعاتی که نیاز دارم وجود ندارد","missingTheInformationINeed","thumb-down"],["بیشازحد پیچیده/ مراحل بسیار زیاد","tooComplicatedTooManySteps","thumb-down"],["قدیمی","outOfDate","thumb-down"],["مشکل ترجمه","translationIssue","thumb-down"],["مشکل کد / نمونهها","samplesCodeIssue","thumb-down"],["غیره","otherDown","thumb-down"]],["تاریخ آخرین به‌روزرسانی 2025-09-04 بهوقت ساعت هماهنگ جهانی."],[],[],null,["You can use Firebase Authentication to let your users authenticate with\nFirebase using their email addresses and passwords, and to manage your app's\npassword-based accounts.\n\nBefore you begin\n\n1. [Add Firebase to your JavaScript project](/docs/web/setup).\n2. If you haven't yet connected your app to your Firebase project, do so from the [Firebase console](//console.firebase.google.com/).\n3. Enable Email/Password sign-in:\n 1. In the [Firebase console](//console.firebase.google.com/), open the **Auth** section.\n 2. On the **Sign in method** tab, enable the **Email/password** sign-in method and click **Save**.\n\nCreate a password-based account\n\nTo create a new user account with a password, complete the following steps in\nyour app's sign-up page:\n\n1. When a new user signs up using your app's sign-up form, complete any new account validation steps that your app requires, such as verifying that the new account's password was correctly typed and meets your complexity requirements.\n2. Create a new account by passing the new user's email address and password to `createUserWithEmailAndPassword`: \n\n Web \n\n ```javascript\n import { getAuth, createUserWithEmailAndPassword } from \"firebase/auth\";\n\n const auth = getAuth();\n createUserWithEmailAndPassword(auth, email, password)\n .then((userCredential) =\u003e {\n // Signed up \n const user = userCredential.user;\n // ...\n })\n .catch((error) =\u003e {\n const errorCode = error.code;\n const errorMessage = error.message;\n // ..\n });https://github.com/firebase/snippets-web/blob/467eaa165dcbd9b3ab15711e76fa52237ba37f8b/snippets/auth-next/email/auth_signup_password.js#L8-L21\n ```\n\n Web \n\n ```javascript\n firebase.auth().createUserWithEmailAndPassword(email, password)\n .then((userCredential) =\u003e {\n // Signed in \n var user = userCredential.user;\n // ...\n })\n .catch((error) =\u003e {\n var errorCode = error.code;\n var errorMessage = error.message;\n // ..\n });https://github.com/firebase/snippets-web/blob/467eaa165dcbd9b3ab15711e76fa52237ba37f8b/auth/email.js#L28-L38\n ```\n If the new account was created, the user is signed in automatically. Have a look at the Next steps section below to get the signed in user details.\n\n\n This is also where you can catch and handle errors. For a list of error codes have a look at the [Auth Reference Docs](/docs/reference/js/auth#autherrorcodes).\n\n| To protect your project from abuse, Firebase limits the number of new email/password and anonymous sign-ups that your application can have from the same IP address in a short period of time. You can request and schedule temporary changes to this quota from the [Firebase console](//console.firebase.google.com/project/_/authentication/providers).\n\nSign in a user with an email address and password\n\nThe steps for signing in a user with a password are similar to the steps for\ncreating a new account. In your app's sign-in page, do the following:\n\n1. When a user signs in to your app, pass the user's email address and password to `signInWithEmailAndPassword`: \n\n Web \n\n ```javascript\n import { getAuth, signInWithEmailAndPassword } from \"firebase/auth\";\n\n const auth = getAuth();\n signInWithEmailAndPassword(auth, email, password)\n .then((userCredential) =\u003e {\n // Signed in \n const user = userCredential.user;\n // ...\n })\n .catch((error) =\u003e {\n const errorCode = error.code;\n const errorMessage = error.message;\n });https://github.com/firebase/snippets-web/blob/467eaa165dcbd9b3ab15711e76fa52237ba37f8b/snippets/auth-next/email/auth_signin_password.js#L8-L20\n ```\n\n Web \n\n ```javascript\n firebase.auth().signInWithEmailAndPassword(email, password)\n .then((userCredential) =\u003e {\n // Signed in\n var user = userCredential.user;\n // ...\n })\n .catch((error) =\u003e {\n var errorCode = error.code;\n var errorMessage = error.message;\n });https://github.com/firebase/snippets-web/blob/467eaa165dcbd9b3ab15711e76fa52237ba37f8b/auth/email.js#L11-L20\n ```\n Have a look at the Next steps section below to get the signed in user details.\n\n\n This is also where you can catch and handle errors. For a list of error codes have a look at the [Auth Reference Docs](/docs/reference/js/auth#autherrorcodes).\n\nRecommended: Set a password policy \n\nYou can improve account security by enforcing password complexity requirements.\n\nTo configure a password policy for your project, open the **Password policy**\ntab on the Authentication Settings page of the Firebase console:\n\n[Authentication Settings](//console.firebase.google.com/project/_/authentication/settings)\n\nFirebase Authentication password policies support the following password requirements:\n\n- Lowercase character required\n\n- Uppercase character required\n\n- Numeric character required\n\n- Non-alphanumeric character required\n\n The following characters satisfy the non-alphanumeric character requirement:\n `^ $ * . [ ] { } ( ) ? \" ! @ # % & / \\ , \u003e \u003c ' : ; | _ ~`\n- Minimum password length (ranges from 6 to 30 characters; defaults to 6)\n\n- Maximum password length (maximum length of 4096 characters)\n\nYou can enable password policy enforcement in two modes:\n\n- **Require**: Attempts to sign up fail until the user updates to a password\n that complies with your policy.\n\n- **Notify**: Users are allowed to sign up with a non-compliant password. When\n using this mode, you should check if the user's password complies with the\n policy on the client side and prompt the user in some way to update their\n password if it does not comply.\n\nNew users are always required to choose a password that complies with your\npolicy.\n\nIf you have active users, we recommend not enabling force upgrade on sign in\nunless you intend to block access to users whose passwords don't comply with\nyour policy. Instead, use notify mode, which allows users to sign in with their\ncurrent passwords, and inform them of the requirements their password lacks.\n\nValidating a password on the client \n\n import { getAuth, validatePassword } from \"firebase/auth\";\n\n const status = await validatePassword(getAuth(), passwordFromUser);\n if (!status.isValid) {\n // Password could not be validated. Use the status to show what\n // requirements are met and which are missing.\n\n // If a criterion is undefined, it is not required by policy. If the\n // criterion is defined but false, it is required but not fulfilled by\n // the given password. For example:\n const needsLowerCase = status.containsLowercaseLetter !== true;\n }\n\nRecommended: Enable email enumeration protection\n\nSome Firebase Authentication methods that take email addresses as parameters throw\nspecific errors if the email address is unregistered when it must be registered\n(for example, when signing in with an email address and password), or registered\nwhen it must be unused (for example, when changing a user's email address).\nWhile this can be helpful for suggesting specific remedies to users, it can also\nbe abused by malicious actors to discover the email addresses registered by your\nusers.\n\nTo mitigate this risk, we recommend you [enable email enumeration protection](https://cloud.google.com/identity-platform/docs/admin/email-enumeration-protection)\nfor your project using the Google Cloud `gcloud` tool. Note that enabling this\nfeature changes Firebase Authentication's error reporting behavior: be sure your app\ndoesn't rely on the more specific errors.\n\nNext steps\n\nAfter a user signs in for the first time, a new user account is created and\nlinked to the credentials---that is, the user name and password, phone\nnumber, or auth provider information---the user signed in with. This new\naccount is stored as part of your Firebase project, and can be used to identify\na user across every app in your project, regardless of how the user signs in.\n\n- In your apps, the recommended way to know the auth status of your user is to\n set an observer on the `Auth` object. You can then get the user's\n basic profile information from the `User` object. See\n [Manage Users](/docs/auth/web/manage-users).\n\n- In your Firebase Realtime Database and Cloud Storage\n [Security Rules](/docs/database/security/user-security), you can\n get the signed-in user's unique user ID from the `auth` variable,\n and use it to control what data a user can access.\n\nYou can allow users to sign in to your app using multiple authentication\nproviders by [linking auth provider credentials to an\nexisting user account.](/docs/auth/web/account-linking)\n\nTo sign out a user, call [`signOut`](/docs/reference/js/auth#signout): \n\nWeb \n\n```javascript\nimport { getAuth, signOut } from \"firebase/auth\";\n\nconst auth = getAuth();\nsignOut(auth).then(() =\u003e {\n // Sign-out successful.\n}).catch((error) =\u003e {\n // An error happened.\n});https://github.com/firebase/snippets-web/blob/467eaa165dcbd9b3ab15711e76fa52237ba37f8b/snippets/auth-next/index/auth_sign_out.js#L8-L15\n```\n\nWeb \n\n```javascript\nfirebase.auth().signOut().then(() =\u003e {\n // Sign-out successful.\n}).catch((error) =\u003e {\n // An error happened.\n});https://github.com/firebase/snippets-web/blob/467eaa165dcbd9b3ab15711e76fa52237ba37f8b/auth/index.js#L33-L37\n```"]]
