از کجا باید با «اصالت‌سنجی 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++ را ببینید.

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

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