قم بالمصادقة مع Firebase باستخدام الحسابات المستندة إلى كلمة المرور باستخدام C++

يمكنك استخدام مصادقة Firebase للسماح للمستخدمين بالمصادقة مع Firebase باستخدام عناوين البريد الإلكتروني وكلمات المرور الخاصة بهم، ولإدارة الحسابات المستندة إلى كلمة المرور لتطبيقك.

قبل ان تبدأ

1. أضف Firebase إلى مشروع C++ الخاص بك .
2. إذا لم تكن قد قمت بعد بربط تطبيقك بمشروع Firebase الخاص بك، فقم بذلك من وحدة تحكم Firebase .
3. تمكين تسجيل الدخول بالبريد الإلكتروني/كلمة المرور:
   1. في وحدة تحكم Firebase ، افتح قسم المصادقة .
   2. في علامة التبويب طريقة تسجيل الدخول ، قم بتمكين طريقة تسجيل الدخول بالبريد الإلكتروني/كلمة المرور وانقر فوق حفظ .

الوصول إلى فئة firebase::auth::Auth

فئة Auth هي البوابة لجميع استدعاءات API.

1. أضف ملفات رأس المصادقة والتطبيق:

   #include "firebase/app.h"
   #include "firebase/auth.h"
   

2. في رمز التهيئة الخاص بك، قم بإنشاء فئة 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__)
   

3. احصل على فئة firebase::auth::Auth لقاعدة firebase::App الخاصة بك. يوجد تعيين واحد لواحد بين App و Auth .

   firebase::auth::Auth* auth = firebase::auth::Auth::GetAuth(app);
   

إنشاء حساب يعتمد على كلمة المرور

لإنشاء حساب مستخدم جديد بكلمة مرور، أكمل الخطوات التالية في رمز تسجيل الدخول لتطبيقك:

1. عندما يقوم مستخدم جديد بالتسجيل باستخدام نموذج الاشتراك في تطبيقك، أكمل أي خطوات جديدة للتحقق من صحة الحساب يتطلبها تطبيقك، مثل التحقق من كتابة كلمة مرور الحساب الجديد بشكل صحيح وتلبية متطلبات التعقيد الخاصة بك.
2. قم بإنشاء حساب جديد عن طريق تمرير عنوان البريد الإلكتروني وكلمة المرور للمستخدم الجديد إلى Auth::CreateUserWithEmailAndPassword :

   firebase::Future<firebase::auth::AuthResult> result =
       auth->CreateUserWithEmailAndPassword(email, password);
   

3. إذا كان برنامجك يحتوي على حلقة تحديث يتم تشغيلها بانتظام (على سبيل المثال، 30 أو 60 مرة في الثانية)، فيمكنك التحقق من النتائج مرة واحدة لكل تحديث باستخدام Auth::CreateUserWithEmailAndPasswordLastResult :

   firebase::Future<firebase::auth::AuthResult> result =
       auth->CreateUserWithEmailAndPasswordLastResult();
   if (result.status() == firebase::kFutureStatusComplete) {
     if (result.error() == firebase::auth::kAuthErrorNone) {
       const firebase::auth::AuthResult auth_result = *result.result();
       printf("Create user succeeded for email %s\n",
              auth_result.user.email().c_str());
     } else {
       printf("Created user failed with error '%s'\n", result.error_message());
     }
   }
   

   أو، إذا كان برنامجك يعتمد على الأحداث، فقد تفضل لتسجيل رد على المستقبل .

تسجيل دخول المستخدم باستخدام عنوان البريد الإلكتروني وكلمة المرور

تشبه خطوات تسجيل دخول المستخدم بكلمة مرور خطوات إنشاء حساب جديد. في وظيفة تسجيل الدخول لتطبيقك، قم بما يلي:

1. عندما يقوم مستخدم بتسجيل الدخول إلى تطبيقك، قم بتمرير عنوان البريد الإلكتروني وكلمة المرور للمستخدم إلى firebase::auth::Auth::SignInWithEmailAndPassword :

   firebase::Future<firebase::auth::AuthResult> result =
       auth->SignInWithEmailAndPassword(email, password);
   

2. إذا كان برنامجك يحتوي على حلقة تحديث يتم تشغيلها بانتظام (على سبيل المثال، 30 أو 60 مرة في الثانية)، فيمكنك التحقق من النتائج مرة واحدة لكل تحديث باستخدام Auth::SignInWithEmailAndPasswordLastResult :

   firebase::Future<firebase::auth::AuthResult> result =
       auth->SignInWithEmailAndPasswordLastResult();
   if (result.status() == firebase::kFutureStatusComplete) {
     if (result.error() == firebase::auth::kAuthErrorNone) {
       const firebase::auth::AuthResult auth_result = *result.result();
       printf("Sign in succeeded for email %s\n",
              auth_result.user.email().c_str());
     } else {
       printf("Sign in failed with error '%s'\n", result.error_message());
     }
   }
   

   أو، إذا كان برنامجك يعتمد على الأحداث، فقد تفضل لتسجيل رد على المستقبل .

تسجيل رد الاتصال على المستقبل

تحتوي بعض البرامج على وظائف Update يتم استدعاؤها 30 أو 60 مرة في الثانية. على سبيل المثال، العديد من الألعاب تتبع هذا النموذج. يمكن لهذه البرامج استدعاء وظائف LastResult لاستقصاء المكالمات غير المتزامنة. ومع ذلك، إذا كان برنامجك مدفوعًا بالأحداث، فقد تفضل تسجيل وظائف رد الاتصال. يتم استدعاء وظيفة رد الاتصال عند الانتهاء من المستقبل.

void OnCreateCallback(const firebase::Future<firebase::auth::User*>& result,
                      void* user_data) {
  // The callback is called when the Future enters the `complete` state.
  assert(result.status() == firebase::kFutureStatusComplete);

  // Use `user_data` to pass-in program context, if you like.
  MyProgramContext* program_context = static_cast<MyProgramContext*>(user_data);

  // Important to handle both success and failure situations.
  if (result.error() == firebase::auth::kAuthErrorNone) {
    firebase::auth::User* user = *result.result();
    printf("Create user succeeded for email %s\n", user->email().c_str());

    // Perform other actions on User, if you like.
    firebase::auth::User::UserProfile profile;
    profile.display_name = program_context->display_name;
    user->UpdateUserProfile(profile);

  } else {
    printf("Created user failed with error '%s'\n", result.error_message());
  }
}

void CreateUser(firebase::auth::Auth* auth) {
  // Callbacks work the same for any firebase::Future.
  firebase::Future<firebase::auth::AuthResult> result =
      auth->CreateUserWithEmailAndPasswordLastResult();

  // `&my_program_context` is passed verbatim to OnCreateCallback().
  result.OnCompletion(OnCreateCallback, &my_program_context);
}

يمكن أن تكون وظيفة رد الاتصال أيضًا لامدا، إذا كنت تفضل ذلك.

void CreateUserUsingLambda(firebase::auth::Auth* auth) {
  // Callbacks work the same for any firebase::Future.
  firebase::Future<firebase::auth::AuthResult> result =
      auth->CreateUserWithEmailAndPasswordLastResult();

  // The lambda has the same signature as the callback function.
  result.OnCompletion(
      [](const firebase::Future<firebase::auth::User*>& result,
         void* user_data) {
        // `user_data` is the same as &my_program_context, below.
        // Note that we can't capture this value in the [] because std::function
        // is not supported by our minimum compiler spec (which is pre C++11).
        MyProgramContext* program_context =
            static_cast<MyProgramContext*>(user_data);

        // Process create user result...
        (void)program_context;
      },
      &my_program_context);
}

موصى به: تمكين حماية تعداد البريد الإلكتروني

تؤدي بعض طرق مصادقة Firebase التي تأخذ عناوين البريد الإلكتروني كمعلمات إلى حدوث أخطاء محددة إذا كان عنوان البريد الإلكتروني غير مسجل عندما يجب تسجيله (على سبيل المثال، عند تسجيل الدخول باستخدام عنوان بريد إلكتروني وكلمة مرور)، أو مسجل عندما يجب أن يكون غير مستخدم (على سبيل المثال، عند تغيير عنوان البريد الإلكتروني للمستخدم). على الرغم من أن هذا يمكن أن يكون مفيدًا في اقتراح حلول محددة للمستخدمين، إلا أنه يمكن أيضًا إساءة استخدامه من قبل جهات ضارة لاكتشاف عناوين البريد الإلكتروني المسجلة بواسطة المستخدمين.

للتخفيف من هذه المخاطر، نوصيك بتمكين حماية تعداد البريد الإلكتروني لمشروعك باستخدام أداة Google Cloud gcloud . لاحظ أن تمكين هذه الميزة يغير سلوك الإبلاغ عن الأخطاء في مصادقة Firebase: تأكد من أن تطبيقك لا يعتمد على الأخطاء الأكثر تحديدًا.

الخطوات التالية

بعد قيام المستخدم بتسجيل الدخول لأول مرة، يتم إنشاء حساب مستخدم جديد وربطه ببيانات الاعتماد - أي اسم المستخدم وكلمة المرور أو رقم الهاتف أو معلومات موفر المصادقة - التي قام المستخدم بتسجيل الدخول بها. يتم تخزين هذا الحساب الجديد كجزء من مشروع Firebase الخاص بك، ويمكن استخدامه لتحديد المستخدم عبر كل تطبيق في مشروعك، بغض النظر عن كيفية تسجيل دخول المستخدم.

• في تطبيقاتك، يمكنك الحصول على معلومات الملف الشخصي الأساسية للمستخدم من كائن firebase::auth::User :

  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 وقواعد أمان التخزين السحابي، يمكنك الحصول على معرف المستخدم الفريد للمستخدم الذي قام بتسجيل الدخول من متغير auth ، واستخدامه للتحكم في البيانات التي يمكن للمستخدم الوصول إليها.

يمكنك السماح للمستخدمين بتسجيل الدخول إلى تطبيقك باستخدام موفري مصادقة متعددين عن طريق ربط بيانات اعتماد موفر المصادقة بحساب مستخدم موجود.

لتسجيل خروج مستخدم، اتصل بـ SignOut() :

auth->SignOut();