आप फायरबेस प्रमाणीकरण का उपयोग अपने उपयोगकर्ताओं को उनके ईमेल पतों और पासवर्ड का उपयोग करके फायरबेस के साथ प्रमाणित करने और अपने ऐप के पासवर्ड-आधारित खातों को प्रबंधित करने के लिए कर सकते हैं।
शुरू करने से पहले
- अपने C++ प्रोजेक्ट में Firebase जोड़ें ।
- अगर आपने अभी तक अपने ऐप को अपने फायरबेस प्रोजेक्ट से कनेक्ट नहीं किया है, तो फायरबेस कंसोल से ऐसा करें।
- ईमेल/पासवर्ड साइन-इन सक्षम करें:
- Firebase कंसोल में, प्रामाणिक अनुभाग खोलें।
- साइन इन विधि टैब पर, ईमेल/पासवर्ड साइन-इन विधि सक्षम करें और सहेजें पर क्लिक करें।
firebase::auth::Auth
क्लास तक पहुंचें
Auth
क्लास सभी एपीआई कॉल्स के लिए गेटवे है।- प्रामाणिक और ऐप शीर्षलेख फ़ाइलें जोड़ें:
#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::App
के लिएfirebase::auth::Auth
वर्ग प्राप्त करें।App
औरAuth
के बीच वन-टू-वन मैपिंग है।firebase::auth::Auth* auth = firebase::auth::Auth::GetAuth(app);
एक पासवर्ड-आधारित खाता बनाएँ
पासवर्ड के साथ एक नया उपयोगकर्ता खाता बनाने के लिए, अपने ऐप के साइन-इन कोड में निम्न चरणों को पूरा करें:
- जब कोई नया उपयोगकर्ता आपके ऐप के साइन-अप फॉर्म का उपयोग करके साइन अप करता है, तो आपके ऐप के लिए आवश्यक कोई भी नया खाता सत्यापन चरण पूरा करें, जैसे कि यह सत्यापित करना कि नए खाते का पासवर्ड सही तरीके से टाइप किया गया था और आपकी जटिल आवश्यकताओं को पूरा करता है।
-
Auth::CreateUserWithEmailAndPassword
:firebase::Future<firebase::auth::AuthResult> result = auth->CreateUserWithEmailAndPassword(email, password);
को नए उपयोगकर्ता का ईमेल पता और पासवर्ड पास करके एक नया खाता बनाएँ - यदि आपके प्रोग्राम में एक अपडेट लूप है जो नियमित रूप से चलता है (मान लीजिए प्रति सेकंड 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()); } }
के साथ प्रति अपडेट एक बार परिणामों की जांच कर सकते हैं या, यदि आपका प्रोग्राम इवेंट संचालित है, तो आप पसंद कर सकते हैं फ्यूचर पर कॉलबैक दर्ज करने के लिए ।
एक ईमेल पते और पासवर्ड के साथ एक उपयोगकर्ता में साइन इन करें
किसी उपयोगकर्ता को पासवर्ड के साथ साइन इन करने के चरण एक नया खाता बनाने के चरणों के समान हैं। अपने ऐप के साइन-इन फ़ंक्शन में, निम्न कार्य करें:
- जब कोई उपयोगकर्ता आपके ऐप में साइन इन करता है, तो उपयोगकर्ता का ईमेल पता और पासवर्ड
firebase::auth::Auth::SignInWithEmailAndPassword
:firebase::Future<firebase::auth::AuthResult> result = auth->SignInWithEmailAndPassword(email, password);
पास करें - यदि आपके प्रोग्राम में एक अपडेट लूप है जो नियमित रूप से चलता है (मान लें कि प्रति सेकंड 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); }
अनुशंसित: ईमेल गणना सुरक्षा सक्षम करें
कुछ फायरबेस प्रमाणीकरण विधियाँ जो ईमेल पतों को मापदंडों के रूप में लेती हैं, विशिष्ट त्रुटियाँ फेंकती हैं यदि ईमेल पता अपंजीकृत है जब इसे पंजीकृत होना चाहिए (उदाहरण के लिए, ईमेल पते और पासवर्ड के साथ साइन इन करते समय), या पंजीकृत होने पर इसका उपयोग नहीं किया जाना चाहिए (उदाहरण के लिए, उपयोगकर्ता का ईमेल पता बदलते समय)। जबकि यह उपयोगकर्ताओं को विशिष्ट उपाय सुझाने में मददगार हो सकता है, दुर्भावनापूर्ण अभिनेताओं द्वारा आपके उपयोगकर्ताओं द्वारा पंजीकृत ईमेल पतों की खोज करने के लिए इसका दुरुपयोग भी किया जा सकता है।
इस जोखिम को कम करने के लिए, हम अनुशंसा करते हैं कि आप 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();