از کجا باید با «اصالت‌سنجی Firebase» شروع کنم؟

برای کمک هوش مصنوعی، پیام‌واره زیر را در عامل کدنویسی هوش مصنوعی خود (مانند Gemini در Android Studio،‏ 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. I want to add Firebase Authentication to my app. Help me choose the best option for my app based on my use case, experience, and app architecture.

درحال‌حاضر سیستم اصالت‌سنجی دارم

اگر برنامه‌تان ازقبل پیاده‌سازی ورود به سیستم دارد و می‌خواهید از آن برای اصالت‌سنجی با سرویس‌های پس‌بک Firebase استفاده کنید، از اصالت‌سنجی سفارشی استفاده کنید. این شامل برنامه‌هایی می‌شود که از هریک از موارد زیر استفاده می‌کنند:

  • راه‌حل‌های سفارشی‌سازی‌شده، مانند سیستم‌های سفارشی مبتنی بر گذرواژه.
  • سرویس‌های مدیریت هویت طرف سوم، مانند Auth0 یا Okta.
  • ادغام‌های موجود با ارائه‌دهندگان هویت فدرال، مانند Google، Facebook، یا Apple. (و اگر هنوز از هویت فدرال پشتیبانی نمی‌کنید، اما می‌خواهید این کار را انجام دهید، بخش بعدی را ببینید.)

با اصالت‌سنجی سفارشی، کاربران را با سیستم انتخابی خودتان به سیستم وارد می‌کنید، یک کد Firebase برای کاربر در باطن خود ایجاد می‌کنید، و سپس از کد کارخواه برای اصالت‌سنجی با Firebase استفاده می‌کنید.

اسناد مربوط به iOS+، Android، وب، Flutter، Unity، یا C++ را ببینید.

می‌خواهم سیستم اصالت‌سنجی‌ام را با Firebase بسازم

اگر درحال ساختن برنامه جدیدی هستید یا می‌خواهید ورود به سیستم را به برنامه موجودی اضافه کنید، Firebase کتابخانه‌ها و سرویس‌هایی دارد که می‌تواند به شما کمک کند اصالت‌سنجی ایمن را بدون نیاز به ساختن باطن اصالت‌سنجی توسط خودتان پیاده‌سازی کنید. Firebase Authentication یک راهکار کامل باطن برای ورود به سیستم با گذرواژه، ارائه‌دهندگان هویت فدراسیونی، پیوندهای ایمیل، و پیامک است.

می‌خواهم راه‌حلی داشته باشم که استفاده از آن آسان باشد

سریع‌ترین و آسان‌ترین راه برای افزودن اصالت‌سنجی به برنامه استفاده از FirebaseUI Auth، کتابخانه میانای کاربر جایگزین، است. FirebaseUI جریان‌های کامل کاربر را برای همه روش‌های ورود به سیستم پشتیبانی‌شده Firebase Authentication پیاده‌سازی می‌کند.

چون FirebaseUI Auth یک راه‌حل آماده است، تجربه کاربری خاصی دارد که ممکن است نیازهای شما را برآورده نکند. اگر می‌خواهید UX را تغییر دهید، می‌توانید کتابخانه را که متن‌باز است، منشعب کنید و از نسخه خودتان استفاده کنید. بااین‌حال، برای جریان‌های ورود به سیستم اساساً متفاوت، ممکن است ترجیح دهید جریان‌های خود را با کیت توسعه نرم‌افزار Firebase پیاده‌سازی کنید، همان‌طور که در بخش بعدی بحث شده است.

اسناد FirebaseUI Auth را برای iOS، Android، یا وب ببینید.

می‌خواهم کنترل کامل تجربه ورود به سیستم را داشته باشم

برای کنترل بیشتر بر تجربه ورود به سیستم برنامه‌تان، می‌توانید جریان‌های اصالت‌سنجی خودتان را پیاده‌سازی کنید و از کیت توسعه نرم‌افزار Firebase برای کار با سرویس‌های اصالت‌سنجی Firebase استفاده کنید. برای مثال، جریان نشانی ایمیل و گذرواژه خودتان یا جریان «ورود به سیستم با Google» را بسازید و نشانی ایمیل و گذرواژه کاربر یا کد شناسه Google را به Firebase ارسال کنید تا کاربر اصالت‌سنجی شود.

اسناد کیت توسعه نرم‌افزار Firebase Authentication را ببینید:

سرویس‌های Firebase
ورود به سیستم با نشانی ایمیل و گذرواژه iOS+ | Android | وب | Flutter | Unity | C++
ورود به سیستم با شماره تلفن iOS+ | Android | وب | Flutter | Unity | C++
ورود به سیستم با پیوند ایمیل iOS+ | Android | وب | Flutter | Unity | C++
هویت مشارکتی
Google iOS+ | Android | وب | Flutter | Unity | C++
فیس‌بوک iOS+ | Android | وب | Flutter | Unity | C++
Apple iOS+ | Android | وب | Flutter | Unity | C++
بازی‌های Play Android | Unity | C++
Game Center iOS+
GitHub iOS+ | Android | وب | Flutter | Unity | C++
Microsoft iOS+ | Android | وب | Unity | C++
توییتر iOS+ | Android | وب | Flutter | Unity | C++
Yahoo iOS+ | Android | وب | Unity | C++

می‌خواهم تجربه‌های غنی پیش‌از ورود به سیستم بسازم

می‌توانید به کاربران اجازه دهید قبل‌از اینکه واقعاً به سیستم وارد شوند، بااستفاده از احراز هویت ناشناس از ویژگی‌های ورود به سیستم برنامه‌تان استفاده کنند. با «ورود به سیستم» ناشناس، حساب‌های تک‌جلسه‌ای موقت ایجاد می‌کنید که می‌توانید مانند حساب واقعی از آن‌ها استفاده کنید. سپس، بعداز اینکه کاربر به سیستم وارد شد یا ثبت‌نام کرد، حساب موقت را به حساب واقعی پیوند دهید تا بتواند از جایی که متوقف شده بود ادامه دهد.

«اصالت‌سنجی ناشناس» در کنار «اصالت‌سنجی سفارشی» یا هریک از سرویس‌های اصالت‌سنجی Firebase به‌خوبی کار می‌کند.

اسناد مربوط به iOS+، Android، وب، Flutter، Unity، یا C++ را ببینید.

می‌خواهم از زیرینه‌ام به سرویس‌های Firebase دسترسی داشته باشم

برای دسترسی به خدمات Firebase از سرور، نیازی به استفاده از Firebase Authentication ندارید. درعوض، از Admin SDK استفاده کنید. وقتی Admin SDK را مقداردهی اولیه می‌کنید، با اعتبارنامه‌های حساب سرویس اصالت‌سنجی می‌کنید، که به‌جای کاربر خاصی، پروژه Firebase شما را نشان می‌دهد و دسترسی کامل به منابع پروژه‌تان را اعطا می‌کند.