این صفحه به‌وسیله ‏Cloud Translation API‏ ترجمه شده است.

احراز هویت با Firebase با استفاده از یک سیستم احراز هویت سفارشی و C++

می‌توانید با تغییر سرور احراز هویت خود برای تولید نشانه‌های امضا شده سفارشی زمانی که کاربر با موفقیت وارد سیستم می‌شود، احراز هویت Firebase را با یک سیستم احراز هویت سفارشی ادغام کنید. برنامه شما این نشانه را دریافت می‌کند و از آن برای احراز هویت با Firebase استفاده می‌کند.

قبل از اینکه شروع کنی

Firebase را به پروژه C++ خود اضافه کنید .
کلیدهای سرور پروژه خود را دریافت کنید:
1. در تنظیمات پروژه خود به صفحه حساب های سرویس بروید .
2. روی Generate New Private Key در پایین بخش Firebase Admin SDK صفحه حساب‌های سرویس کلیک کنید.
3. جفت کلید عمومی/خصوصی حساب سرویس جدید به طور خودکار در رایانه شما ذخیره می شود. این فایل را در سرور احراز هویت خود کپی کنید.

با Firebase احراز هویت

کلاس Auth دروازه همه تماس های API است.

فایل‌های هدر Auth و App را اضافه کنید:
```
#include "firebase/app.h"
#include "firebase/auth.h"
```

در کد اولیه خود، یک کلاس firebase::App ایجاد کنید.

#if defined(__ANDROID__)
  firebase::App* app =
      firebase::App::Create(firebase::AppOptions(), my_jni_env, my_activity);
#else
  firebase::App* app = firebase::App::Create(firebase::AppOptions());
#endif  // defined(__ANDROID__)

firebase::auth::Auth را برای firebase::App خود بدست آورید. یک نگاشت یک به یک بین App و Auth وجود دارد.
```
firebase::auth::Auth* auth = firebase::auth::Auth::GetAuth(app);
```

Auth::SignInWithCustomToken را با توکن سرور احراز هویت خود تماس بگیرید.

وقتی کاربران وارد برنامه شما می‌شوند، اعتبارنامه ورود به سیستم (به عنوان مثال، نام کاربری و رمز عبور آنها) را به سرور احراز هویت خود ارسال کنید. سرور شما اعتبارنامه ها را بررسی می کند و در صورت معتبر بودن یک توکن سفارشی برمی گرداند.
پس از دریافت رمز سفارشی از سرور احراز هویت خود، آن را به Auth::SignInWithCustomToken کنید تا وارد کاربر شود:
```
firebase::Future<firebase::auth::AuthResult> result =
    auth->SignInWithCustomToken(custom_token);
```
اگر برنامه شما دارای یک حلقه به‌روزرسانی است که به طور منظم اجرا می‌شود (مثلاً 30 یا 60 بار در ثانیه)، می‌توانید نتایج را یک بار در هر به‌روزرسانی با Auth::SignInWithCustomTokenLastResult :
```
firebase::Future<firebase::auth::AuthResult> result =
    auth->SignInWithCustomTokenLastResult();
if (result.status() == firebase::kFutureStatusComplete) {
  if (result.error() == firebase::auth::kAuthErrorNone) {
    firebase::auth::AuthResult auth_result = *result.result();
    printf("Sign in succeeded for `%s`\n",
           auth_result.user.display_name().c_str());
  } else {
    printf("Sign in failed with error '%s'\n", result.error_message());
  }
}
```
بررسی کنید یا اگر برنامه شما مبتنی بر رویداد است، ممکن است ترجیح دهید. برای ثبت تماس برگشتی در آینده .

مراحل بعدی

پس از اینکه کاربر برای اولین بار وارد سیستم شد، یک حساب کاربری جدید ایجاد می‌شود و به اعتبارنامه‌ها (یعنی نام کاربری و رمز عبور، شماره تلفن یا اطلاعات ارائه‌دهنده تاییدیه) مرتبط می‌شود که کاربر با آن وارد شده است. این حساب جدید به‌عنوان بخشی از پروژه Firebase شما ذخیره می‌شود و می‌توان از آن برای شناسایی کاربر در همه برنامه‌های پروژه‌تان، صرف نظر از نحوه ورود کاربر به سیستم استفاده کرد.

در برنامه های خود، می توانید اطلاعات اولیه نمایه کاربر را از firebase::auth::User object:

firebase::auth::User user = auth->current_user();
if (user.is_valid()) {
  std::string name = user.display_name();
  std::string email = user.email();
  std::string photo_url = user.photo_url();
  // The user's ID, unique to the Firebase project.
  // Do NOT use this value to authenticate with your backend server,
  // if you have one. Use firebase::auth::User::Token() instead.
  std::string uid = user.uid();
}

در قوانین امنیتی Firebase Realtime Database و Cloud Storage، می‌توانید شناسه کاربری منحصر به فرد کاربر واردشده به سیستم را از متغیر auth دریافت کنید و از آن برای کنترل داده‌هایی که کاربر می‌تواند به آن دسترسی داشته باشد استفاده کنید.

می‌توانید به کاربران اجازه دهید با استفاده از چندین ارائه‌دهنده احراز هویت، با پیوند دادن اعتبار ارائه‌دهنده تأیید اعتبار به یک حساب کاربری موجود، به برنامه شما وارد شوند.

برای خروج از سیستم کاربر، SignOut() را فراخوانی کنید:

auth->SignOut();