C++ का उपयोग करके पासवर्ड-आधारित खातों का उपयोग करके फायरबेस से प्रमाणित करें

आप अपने उपयोगकर्ताओं को उनके ईमेल पते और पासवर्ड का उपयोग करके फायरबेस से प्रमाणित करने और अपने ऐप के पासवर्ड-आधारित खातों को प्रबंधित करने के लिए फायरबेस प्रमाणीकरण का उपयोग कर सकते हैं।

शुरू करने से पहले

1. अपने C++ प्रोजेक्ट में Firebase जोड़ें ।
2. यदि आपने अभी तक अपने ऐप को अपने फायरबेस प्रोजेक्ट से कनेक्ट नहीं किया है, तो फायरबेस कंसोल से ऐसा करें।
3. ईमेल/पासवर्ड साइन-इन सक्षम करें:
   1. फायरबेस कंसोल में, ऑथ सेक्शन खोलें।
   2. साइन इन विधि टैब पर, ईमेल/पासवर्ड साइन-इन विधि सक्षम करें और सहेजें पर क्लिक करें।

firebase::auth::Auth क्लास तक पहुंचें

Auth क्लास सभी एपीआई कॉल के लिए प्रवेश द्वार है।

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::App के लिए firebase::auth::Auth क्लास प्राप्त करें। 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());
     }
   }
   

   या, यदि आपका प्रोग्राम इवेंट संचालित है, तो आप पसंद कर सकते हैं Future पर कॉलबैक पंजीकृत करने के लिए।

आपके प्रोजेक्ट को दुरुपयोग से बचाने के लिए, फायरबेस नए ईमेल/पासवर्ड और अज्ञात साइन-अप की संख्या को सीमित करता है जो आपके एप्लिकेशन में कम समय में एक ही आईपी पते से हो सकते हैं। आप फायरबेस कंसोल से इस कोटा में अस्थायी परिवर्तन का अनुरोध और शेड्यूल कर सकते हैं।

किसी उपयोगकर्ता को ईमेल पते और पासवर्ड से साइन इन करें

किसी उपयोगकर्ता को पासवर्ड के साथ साइन इन करने के चरण नया खाता बनाने के चरणों के समान हैं। अपने ऐप के साइन-इन फ़ंक्शन में, निम्नलिखित कार्य करें:

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());
     }
   }
   

   या, यदि आपका प्रोग्राम इवेंट संचालित है, तो आप पसंद कर सकते हैं Future पर कॉलबैक पंजीकृत करने के लिए।

फ़्यूचर पर कॉलबैक पंजीकृत करें

कुछ प्रोग्रामों में 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);
}

अनुशंसित: ईमेल गणना सुरक्षा सक्षम करें

कुछ फायरबेस प्रमाणीकरण विधियां जो ईमेल पते को पैरामीटर के रूप में लेती हैं, विशिष्ट त्रुटियां उत्पन्न करती हैं यदि ईमेल पता अपंजीकृत है जब इसे पंजीकृत किया जाना चाहिए (उदाहरण के लिए, ईमेल पते और पासवर्ड के साथ साइन इन करते समय), या तब पंजीकृत किया जाता है जब इसका उपयोग नहीं किया जाना चाहिए (उदाहरण के लिए, उपयोगकर्ता का ईमेल पता बदलते समय)। हालाँकि यह उपयोगकर्ताओं को विशिष्ट उपाय सुझाने में सहायक हो सकता है, लेकिन दुर्भावनापूर्ण अभिनेताओं द्वारा आपके उपयोगकर्ताओं द्वारा पंजीकृत ईमेल पते की खोज करने के लिए इसका दुरुपयोग भी किया जा सकता है।

इस जोखिम को कम करने के लिए, हम अनुशंसा करते हैं कि आप Google क्लाउड gcloud टूल का उपयोग करके अपने प्रोजेक्ट के लिए ईमेल गणना सुरक्षा सक्षम करें । ध्यान दें कि इस सुविधा को सक्षम करने से फायरबेस प्रमाणीकरण का त्रुटि रिपोर्टिंग व्यवहार बदल जाता है: सुनिश्चित करें कि आपका ऐप अधिक विशिष्ट त्रुटियों पर भरोसा नहीं करता है।

अगले कदम

किसी उपयोगकर्ता द्वारा पहली बार साइन इन करने के बाद, एक नया उपयोगकर्ता खाता बनाया जाता है और क्रेडेंशियल्स से लिंक किया जाता है - यानी, उपयोगकर्ता नाम और पासवर्ड, फोन नंबर, या ऑथ प्रदाता जानकारी - जिस उपयोगकर्ता के साथ साइन इन किया जाता है। यह नया खाता आपके फायरबेस प्रोजेक्ट के हिस्से के रूप में संग्रहीत है, और इसका उपयोग आपके प्रोजेक्ट के प्रत्येक ऐप में उपयोगकर्ता की पहचान करने के लिए किया जा सकता है, भले ही उपयोगकर्ता कैसे भी साइन इन करता हो।

• अपने ऐप्स में, आप उपयोगकर्ता की मूल प्रोफ़ाइल जानकारी 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();
  }
  

• अपने फायरबेस रीयलटाइम डेटाबेस और क्लाउड स्टोरेज सुरक्षा नियमों में, आप साइन-इन किए गए उपयोगकर्ता की अद्वितीय उपयोगकर्ता आईडी को auth वेरिएबल से प्राप्त कर सकते हैं, और इसका उपयोग यह नियंत्रित करने के लिए कर सकते हैं कि उपयोगकर्ता किस डेटा तक पहुंच सकता है।

आप किसी मौजूदा उपयोगकर्ता खाते से प्रमाणीकरण प्रदाता क्रेडेंशियल्स को लिंक करके उपयोगकर्ताओं को एकाधिक प्रमाणीकरण प्रदाताओं का उपयोग करके अपने ऐप में साइन इन करने की अनुमति दे सकते हैं।

किसी उपयोगकर्ता को साइन आउट करने के लिए, SignOut() पर कॉल करें:

auth->SignOut();