अपने उपयोगकर्ताओं को Yahoo जैसे OAuth प्रोवाइडर का इस्तेमाल करके, Firebase से पुष्टि करने की सुविधा दी जा सकती है. इसके लिए, आपको Firebase SDK टूल का इस्तेमाल करके, अपने ऐप्लिकेशन में वेब पर आधारित सामान्य OAuth लॉगिन को इंटिग्रेट करना होगा. इससे साइन-इन करने की प्रोसेस को शुरू से लेकर आखिर तक पूरा किया जा सकता है. इस फ़्लो के लिए, फ़ोन पर काम करने वाले Firebase SDK टूल का इस्तेमाल करना ज़रूरी है. इसलिए, यह सिर्फ़ Android और Apple प्लैटफ़ॉर्म पर काम करता है.
शुरू करने से पहले
- अपने C++ प्रोजेक्ट में Firebase जोड़ें.
- Firebase कंसोल में, सुरक्षा > पुष्टि करना पर जाएं.
- साइन-इन का तरीका टैब में, Yahoo से साइन-इन करने की सुविधा देने वाली सेवा चालू करें.
-
सेवा देने वाली कंपनी के डेवलपर कंसोल से क्लाइंट आईडी और क्लाइंट सीक्रेट को सेवा देने वाली कंपनी के कॉन्फ़िगरेशन में जोड़ें:
-
Yahoo OAuth क्लाइंट को रजिस्टर करने के लिए, Yahoo डेवलपर के दस्तावेज़ में दिए गए निर्देशों का पालन करें. इसमें Yahoo के साथ वेब ऐप्लिकेशन को रजिस्टर करने के बारे में बताया गया है.
OpenID Connect API की ये दो अनुमतियां ज़रूर चुनें:
profileऔरemail. -
इन सेवा देने वाली कंपनियों के साथ ऐप्लिकेशन रजिस्टर करते समय, अपने प्रोजेक्ट के लिए
*.firebaseapp.comडोमेन को अपने ऐप्लिकेशन के रीडायरेक्ट डोमेन के तौर पर रजिस्टर करना न भूलें.
-
- सेव करें पर क्लिक करें.
firebase::auth::Auth क्लास को ऐक्सेस करना
Auth क्लास, सभी एपीआई कॉल के लिए गेटवे है.
- Auth और App हेडर फ़ाइलें जोड़ें:
#include <cassert> #include <cinttypes> #include <cstdint> #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);
Firebase SDK टूल की मदद से, साइन-इन फ़्लो को मैनेज करना
Firebase SDK टूल की मदद से साइन-इन फ़्लो को मैनेज करने के लिए, यह तरीका अपनाएं:
Yahoo के लिए सही प्रोवाइडर आईडी के साथ कॉन्फ़िगर किए गए
FederatedOAuthProviderDataका इंस्टेंस बनाएं.firebase::auth::FederatedOAuthProviderData provider_data(firebase::auth::YahooAuthProvider::kProviderId);ज़रूरी नहीं: OAuth अनुरोध के साथ भेजे जाने वाले, पसंद के मुताबिक बनाए गए अतिरिक्त OAuth पैरामीटर की जानकारी दें.
// Prompt user to re-authenticate to Yahoo. provider_data.custom_parameters["prompt"] = "login"; // Localize to French. provider_data.custom_parameters["language"] = "fr";Yahoo के साथ काम करने वाले पैरामीटर के लिए, Yahoo OAuth दस्तावेज़ देखें. ध्यान दें कि
custom_parameters()के साथ, Firebase के लिए ज़रूरी पैरामीटर पास नहीं किए जा सकते. ये पैरामीटर हैं: client_id, redirect_uri, response_type, scope, और state.ज़रूरी नहीं:
profileऔरemailके अलावा, OAuth 2.0 के अन्य स्कोप तय करें जिनके लिए आपको पुष्टि करने वाली सेवा से अनुरोध करना है. अगर आपके ऐप्लिकेशन को Yahoo API से उपयोगकर्ता के निजी डेटा को ऐक्सेस करने की ज़रूरत है, तो आपको Yahoo डेवलपर कंसोल में एपीआई अनुमतियां में जाकर, Yahoo API से अनुमतियों का अनुरोध करना होगा. अनुरोध किए गए OAuth स्कोप, ऐप्लिकेशन की एपीआई अनुमतियों में पहले से कॉन्फ़िगर किए गए स्कोप से पूरी तरह मैच होने चाहिए. उदाहरण के लिए, अगर उपयोगकर्ता के संपर्कों को पढ़ने/लिखने के ऐक्सेस का अनुरोध किया जाता है और ऐप्लिकेशन की एपीआई अनुमतियों में पहले से कॉन्फ़िगर किया गया है, तो रीड-ओनली OAuth स्कोपsdct-rके बजायsdct-wको पास करना होगा. ऐसा न करने पर,फ़्लो पूरा नहीं होगा और असली उपयोगकर्ता को गड़बड़ी का मैसेज दिखेगा.// Request access to Yahoo Mail API. provider_data.scopes.push_back("mail-r"); // This must be preconfigured in the app's API permissions. provider_data.scopes.push_back("sdct-w");ज़्यादा जानने के लिए, Yahoo के स्कोप से जुड़ा दस्तावेज़ देखें.
सेवा देने वाली कंपनी का डेटा कॉन्फ़िगर होने के बाद, इसका इस्तेमाल करके FederatedOAuthProvider बनाएं.
// Construct a FederatedOAuthProvider for use in Auth methods. firebase::auth::FederatedOAuthProvider provider(provider_data);पुष्टि करने की सेवा देने वाली कंपनी के ऑब्जेक्ट का इस्तेमाल करके, Firebase से पुष्टि करें. ध्यान दें कि FirebaseAuth के अन्य ऑपरेशन की तरह, यह आपके यूज़र इंटरफ़ेस (यूआई) को कंट्रोल करेगा. इसके लिए, यह एक वेब व्यू पॉप-अप करेगा, जिसमें उपयोगकर्ता अपने क्रेडेंशियल डाल सकता है.
साइन इन करने की प्रोसेस शुरू करने के लिए,
SignInWithProviderको कॉल करें:firebase::Future<firebase::auth::AuthResult> result = auth->SignInWithProvider(provider_data);इसके बाद, आपका ऐप्लिकेशन इंतज़ार कर सकता है या फ़्यूचर पर कॉलबैक रजिस्टर कर सकता है.
ऊपर दिए गए उदाहरण, साइन-इन करने के फ़्लो पर फ़ोकस करते हैं. हालांकि, आपके पास
LinkWithProviderका इस्तेमाल करके, Yahoo की सेवा देने वाली कंपनी को किसी मौजूदा उपयोगकर्ता से लिंक करने का विकल्प भी है. उदाहरण के लिए, एक ही उपयोगकर्ता के लिए कई प्रोवाइडर लिंक किए जा सकते हैं. इससे उपयोगकर्ता, किसी भी प्रोवाइडर का इस्तेमाल करके साइन इन कर सकता है.firebase::Future<firebase::auth::AuthResult> result = user.LinkWithProvider(provider_data);इसी पैटर्न का इस्तेमाल
ReauthenticateWithProviderके साथ किया जा सकता है. इसका इस्तेमाल, संवेदनशील कार्रवाइयों के लिए नए क्रेडेंशियल पाने के लिए किया जा सकता है. इन कार्रवाइयों के लिए, हाल ही में लॉगिन करना ज़रूरी होता है.firebase::Future<firebase::auth::AuthResult> result = user.ReauthenticateWithProvider(provider_data);इसके बाद, आपका ऐप्लिकेशन इंतज़ार कर सकता है या फ़्यूचर पर कॉलबैक रजिस्टर कर सकता है.
अगले चरण
जब कोई उपयोगकर्ता पहली बार साइन इन करता है, तो एक नया उपयोगकर्ता खाता बन जाता है. साथ ही, यह खाता उन क्रेडेंशियल से लिंक हो जाता है जिनका इस्तेमाल करके उपयोगकर्ता ने साइन इन किया है. जैसे, उपयोगकर्ता नाम और पासवर्ड, फ़ोन नंबर या पुष्टि करने वाली सेवा की जानकारी. यह नया खाता आपके 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 Database और Cloud Storage सुरक्षा नियमों में, साइन इन किए हुए उपयोगकर्ता का यूनीक यूज़र आईडी,
authवैरिएबल से पाया जा सकता है. साथ ही, इसका इस्तेमाल करके यह कंट्रोल किया जा सकता है कि उपयोगकर्ता कौनसा डेटा ऐक्सेस कर सकता है.
पुष्टि करने वाली सेवा देने वाली कंपनी के क्रेडेंशियल को किसी मौजूदा उपयोगकर्ता खाते से लिंक करके, उपयोगकर्ताओं को पुष्टि करने वाली सेवा देने वाली कई कंपनियों का इस्तेमाल करके आपके ऐप्लिकेशन में साइन इन करने की अनुमति दी जा सकती है.
किसी उपयोगकर्ता को साइन आउट करने के लिए,
SignOut() को कॉल करें:
auth->SignOut();