Android पर Yahoo का इस्तेमाल करके पुष्टि करें

वेब पर काम करने वाले सामान्य OAuth लॉगिन को Firebase SDK टूल की मदद से अपने ऐप्लिकेशन में इंटिग्रेट करके, उपयोगकर्ताओं को Yahoo जैसे OAuth प्रोवाइडर की मदद से Firebase में पुष्टि करने की अनुमति दी जा सकती है. इससे, साइन-इन की पूरी प्रोसेस को मैनेज किया जा सकता है.

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

Yahoo खातों का इस्तेमाल करके उपयोगकर्ताओं को साइन इन करने की अनुमति देने के लिए, आपको सबसे पहले अपने Firebase प्रोजेक्ट के लिए Yahoo को साइन-इन प्रोवाइडर के तौर पर चालू करना होगा:

  1. अपने Android प्रोजेक्ट में Firebase जोड़ें.

  2. Firebase कंसोल में, सुरक्षा > पुष्टि पर जाएं.
  3. साइन-इन करने का तरीका टैब में, Yahoo साइन-इन प्रोवाइडर को चालू करें.
  4. प्रोवाइडर के कॉन्फ़िगरेशन में, उस प्रोवाइडर के डेवलपर कंसोल से क्लाइंट आईडी और क्लाइंट सीक्रेट जोड़ें:
    1. Yahoo OAuth क्लाइंट रजिस्टर करने के लिए, Yahoo के साथ वेब ऐप्लिकेशन रजिस्टर करने के बारे में Yahoo के डेवलपर दस्तावेज़ देखें .

      OpenID Connect API की इन दो अनुमतियों को ज़रूर चुनें: profile और email.

    2. इन प्रोवाइडर के साथ ऐप्लिकेशन रजिस्टर करते समय, अपने प्रोजेक्ट के लिए *.firebaseapp.com डोमेन को अपने ऐप्लिकेशन के रीडायरेक्ट डोमेन के तौर पर रजिस्टर करना न भूलें.
  5. सेव करें पर क्लिक करें.
  6. अगर आपने अब तक अपने ऐप्लिकेशन का SHA-1 फ़िंगरप्रिंट नहीं बताया है, तो उसे बताएं.

    1. Firebase कंसोल में, सेटिंग सेटिंग > सामान्य टैब पर जाएं.

    2. स्क्रोल करके आपके ऐप्लिकेशन कार्ड पर जाएं. इसके बाद, अपना Android ऐप्लिकेशन चुनें और SHA सर्टिफ़िकेट फ़िंगरप्रिंट फ़ील्ड में अपना SHA-1 फ़िंगरप्रिंट जोड़ें.

    अपने ऐप्लिकेशन का SHA फ़िंगरप्रिंट पाने के तरीके के बारे में जानने के लिए, अपने क्लाइंट की पुष्टि करना लेख पढ़ें.

Firebase SDK टूल की मदद से साइन-इन की प्रोसेस को मैनेज करना

अगर कोई Android ऐप्लिकेशन बनाया जा रहा है, तो उपयोगकर्ताओं को उनके Yahoo खातों की मदद से Firebase में पुष्टि करने की अनुमति देने का सबसे आसान तरीका है कि Firebase Android SDK टूल की मदद से, साइन-इन की पूरी प्रोसेस को मैनेज किया जाए.

Firebase Android SDK टूल की मदद से साइन-इन की प्रोसेस को मैनेज करने के लिए, यह तरीका अपनाएं:

  1. प्रोवाइडर आईडी yahoo.com के साथ, OAuthProvider का कोई इंस्टेंस बनाने के लिए, उसके बिल्डर का इस्तेमाल करें.

    Kotlin

    val provider = OAuthProvider.newBuilder("yahoo.com")

    Java

    OAuthProvider.Builder provider = OAuthProvider.newBuilder("yahoo.com");

  2. ज़रूरी नहीं: OAuth के ऐसे अतिरिक्त कस्टम पैरामीटर तय करें जिन्हें OAuth के अनुरोध के साथ भेजना है.

    Kotlin

    // Prompt user to re-authenticate to Yahoo.
    provider.addCustomParameter("prompt", "login")
    
    // Localize to French.
    provider.addCustomParameter("language", "fr")

    Java

    // Prompt user to re-authenticate to Yahoo.
    provider.addCustomParameter("prompt", "login");
    
    // Localize to French.
    provider.addCustomParameter("language", "fr");

    Yahoo के जिन पैरामीटर के साथ काम किया जा सकता है उनके बारे में जानने के लिए, देखें Yahoo OAuth के दस्तावेज़. ध्यान दें कि setCustomParameters() के साथ, Firebase के लिए ज़रूरी पैरामीटर नहीं भेजे जा सकते. ये पैरामीटर client_id, redirect_uri, response_type, scope और state हैं.

  3. ज़रूरी नहीं: OAuth 2.0 के ऐसे अतिरिक्त स्कोप तय करें जिन्हें पुष्टि करने वाले प्रोवाइडर से अनुरोध करना है. ये स्कोप profile और email के अलावा होने चाहिए. अगर आपके ऐप्लिकेशन को Yahoo API से, उपयोगकर्ता के निजी डेटा को ऐक्सेस करने की अनुमति चाहिए, तो आपको Yahoo डेवलपर कंसोल में एपीआई की अनुमतियां में जाकर, Yahoo API के लिए अनुमतियों का अनुरोध करना होगा. OAuth के जिन स्कोप का अनुरोध किया गया है वे, ऐप्लिकेशन की एपीआई अनुमतियों में पहले से कॉन्फ़िगर किए गए स्कोप से पूरी तरह मेल खाने चाहिए. उदाहरण के लिए, अगर उपयोगकर्ता के संपर्कों को पढ़ने/लिखने की अनुमति का अनुरोध किया गया है और ऐप्लिकेशन की एपीआई अनुमतियों में यह पहले से कॉन्फ़िगर है, तो सिर्फ़ पढ़ने की अनुमति वाले OAuth स्कोप sdct-r के बजाय, sdct-w को पास करना होगा. ऐसा न करने पर,प्रोसेस पूरी नहीं होगी और उपयोगकर्ता को गड़बड़ी का मैसेज दिखेगा.

    Kotlin

    // Request read access to a user's email addresses.
    // This must be preconfigured in the app's API permissions.
    provider.scopes = listOf("mail-r", "sdct-w")

    Java

    // Request read access to a user's email addresses.
    // This must be preconfigured in the app's API permissions.
    List<String> scopes =
            new ArrayList<String>() {
                {
                    // Request access to Yahoo Mail API.
                    add("mail-r");
                    // This must be preconfigured in the app's API permissions.
                    add("sdct-w");
                }
            };
    provider.setScopes(scopes);
    ज़्यादा जानने के लिए, Yahoo के स्कोप के दस्तावेज़ देखें.

  4. OAuth प्रोवाइडर ऑब्जेक्ट का इस्तेमाल करके, Firebase में पुष्टि करें. ध्यान दें कि FirebaseAuth की अन्य कार्रवाइयों के उलट, यह कार्रवाई Chrome के कस्टम टैब को पॉप-अप करके, आपके यूज़र इंटरफ़ेस (यूआई) को कंट्रोल करेगी. इसलिए, OnSuccessListeners और OnFailureListeners में अपनी गतिविधि का रेफ़रंस न दें. ऐसा इसलिए, क्योंकि कार्रवाई के यूज़र इंटरफ़ेस (यूआई) को शुरू करते ही, ये तुरंत अलग हो जाएंगे.

    आपको सबसे पहले यह देखना चाहिए कि आपको पहले से कोई जवाब मिला है या नहीं. इस तरीके से साइन इन करने पर, आपकी गतिविधि बैकग्राउंड में चली जाती है. इसका मतलब है कि साइन इन की प्रोसेस के दौरान, सिस्टम इसे वापस पा सकता है. यह पक्का करने के लिए कि ऐसा होने पर, उपयोगकर्ता को फिर से कोशिश न करनी पड़े, आपको यह देखना चाहिए कि कोई नतीजा पहले से मौजूद है या नहीं.

    यह देखने के लिए कि कोई नतीजा पेंडिंग है या नहीं, getPendingAuthResult को कॉल करें:

    Kotlin

    val pendingResultTask = firebaseAuth.pendingAuthResult
    if (pendingResultTask != null) {
        // There's something already here! Finish the sign-in for your user.
        pendingResultTask
            .addOnSuccessListener {
                // User is signed in.
                // IdP data available in
                // authResult.getAdditionalUserInfo().getProfile().
                // The OAuth access token can also be retrieved:
                // ((OAuthCredential)authResult.getCredential()).getAccessToken().
                // The OAuth secret can be retrieved by calling:
                // ((OAuthCredential)authResult.getCredential()).getSecret().
            }
            .addOnFailureListener {
                // Handle failure.
            }
    } else {
        // There's no pending result so you need to start the sign-in flow.
        // See below.
    }

    Java

    Task<AuthResult> pendingResultTask = firebaseAuth.getPendingAuthResult();
    if (pendingResultTask != null) {
        // There's something already here! Finish the sign-in for your user.
        pendingResultTask
                .addOnSuccessListener(
                        new OnSuccessListener<AuthResult>() {
                            @Override
                            public void onSuccess(AuthResult authResult) {
                                // User is signed in.
                                // IdP data available in
                                // authResult.getAdditionalUserInfo().getProfile().
                                // The OAuth access token can also be retrieved:
                                // ((OAuthCredential)authResult.getCredential()).getAccessToken().
                                // The OAuth secret can be retrieved by calling:
                                // ((OAuthCredential)authResult.getCredential()).getSecret().
                            }
                        })
                .addOnFailureListener(
                        new OnFailureListener() {
                            @Override
                            public void onFailure(@NonNull Exception e) {
                                // Handle failure.
                            }
                        });
    } else {
        // There's no pending result so you need to start the sign-in flow.
        // See below.
    }

    साइन इन की प्रोसेस शुरू करने के लिए, startActivityForSignInWithProvider को कॉल करें:

    Kotlin

    firebaseAuth
        .startActivityForSignInWithProvider(activity, provider.build())
        .addOnSuccessListener {
            // User is signed in.
            // IdP data available in
            // authResult.getAdditionalUserInfo().getProfile().
            // The OAuth access token can also be retrieved:
            // ((OAuthCredential)authResult.getCredential()).getAccessToken().
            // The OAuth secret can be retrieved by calling:
            // ((OAuthCredential)authResult.getCredential()).getSecret().
        }
        .addOnFailureListener {
            // Handle failure.
        }

    Java

    firebaseAuth
            .startActivityForSignInWithProvider(/* activity= */ this, provider.build())
            .addOnSuccessListener(
                    new OnSuccessListener<AuthResult>() {
                        @Override
                        public void onSuccess(AuthResult authResult) {
                            // User is signed in.
                            // IdP data available in
                            // authResult.getAdditionalUserInfo().getProfile().
                            // The OAuth access token can also be retrieved:
                            // ((OAuthCredential)authResult.getCredential()).getAccessToken().
                            // The OAuth secret can be retrieved by calling:
                            // ((OAuthCredential)authResult.getCredential()).getSecret().
                        }
                    })
            .addOnFailureListener(
                    new OnFailureListener() {
                        @Override
                        public void onFailure(@NonNull Exception e) {
                            // Handle failure.
                        }
                    });

    प्रोसेस पूरी होने पर, प्रोवाइडर से जुड़ा OAuth ऐक्सेस टोकन, दिखाए गए OAuthCredential ऑब्जेक्ट से वापस पाया जा सकता है.

    OAuth ऐक्सेस टोकन का इस्तेमाल करके, Yahoo API को कॉल किया जा सकता है.

    यहां YAHOO_USER_UID Yahoo उपयोगकर्ता का आईडी है. इसे firebaseAuth.getCurrentUser().getProviderData().get(0).getUid() फ़ील्ड या authResult.getAdditionalUserInfo().getProfile() से पार्स किया जा सकता है.

  5. ऊपर दिए गए उदाहरणों में, साइन-इन की प्रोसेस पर फ़ोकस किया गया है. हालांकि, आपके पास startActivityForLinkWithProvider का इस्तेमाल करके, किसी मौजूदा उपयोगकर्ता से Yahoo प्रोवाइडर को लिंक करने की सुविधा भी होती है. उदाहरण के लिए, एक ही उपयोगकर्ता से कई प्रोवाइडर को लिंक किया जा सकता है. इससे उपयोगकर्ता, इनमें से किसी भी प्रोवाइडर की मदद से साइन इन कर सकता है.

    Kotlin

    // The user is already signed-in.
    val firebaseUser = firebaseAuth.currentUser!!
    firebaseUser
        .startActivityForLinkWithProvider(activity, provider.build())
        .addOnSuccessListener {
            // Provider credential is linked to the current user.
            // IdP data available in
            // authResult.getAdditionalUserInfo().getProfile().
            // The OAuth access token can also be retrieved:
            // authResult.getCredential().getAccessToken().
            // The OAuth secret can be retrieved by calling:
            // authResult.getCredential().getSecret().
        }
        .addOnFailureListener {
            // Handle failure.
        }

    Java

    // The user is already signed-in.
    FirebaseUser firebaseUser = firebaseAuth.getCurrentUser();
    
    firebaseUser
            .startActivityForLinkWithProvider(/* activity= */ this, provider.build())
            .addOnSuccessListener(
                    new OnSuccessListener<AuthResult>() {
                        @Override
                        public void onSuccess(AuthResult authResult) {
                            // Provider credential is linked to the current user.
                            // IdP data available in
                            // authResult.getAdditionalUserInfo().getProfile().
                            // The OAuth access token can also be retrieved:
                            // authResult.getCredential().getAccessToken().
                            // The OAuth secret can be retrieved by calling:
                            // authResult.getCredential().getSecret().
                        }
                    })
            .addOnFailureListener(
                    new OnFailureListener() {
                        @Override
                        public void onFailure(@NonNull Exception e) {
                            // Handle failure.
                        }
                    });

  6. startActivityForReauthenticateWithProvider के साथ भी इसी पैटर्न का इस्तेमाल किया जा सकता है. इसका इस्तेमाल, संवेदनशील कार्रवाइयों के लिए नए क्रेडेंशियल पाने के लिए किया जा सकता है. इन कार्रवाइयों के लिए, हाल ही में लॉगिन करना ज़रूरी होता है.

    Kotlin

    // The user is already signed-in.
    val firebaseUser = firebaseAuth.currentUser!!
    firebaseUser
        .startActivityForReauthenticateWithProvider(activity, provider.build())
        .addOnSuccessListener {
            // User is re-authenticated with fresh tokens and
            // should be able to perform sensitive operations
            // like account deletion and email or password
            // update.
        }
        .addOnFailureListener {
            // Handle failure.
        }

    Java

    // The user is already signed-in.
    FirebaseUser firebaseUser = firebaseAuth.getCurrentUser();
    
    firebaseUser
            .startActivityForReauthenticateWithProvider(/* activity= */ this, provider.build())
            .addOnSuccessListener(
                    new OnSuccessListener<AuthResult>() {
                        @Override
                        public void onSuccess(AuthResult authResult) {
                            // User is re-authenticated with fresh tokens and
                            // should be able to perform sensitive operations
                            // like account deletion and email or password
                            // update.
                        }
                    })
            .addOnFailureListener(
                    new OnFailureListener() {
                        @Override
                        public void onFailure(@NonNull Exception e) {
                            // Handle failure.
                        }
                    });

अगले चरण

जब कोई उपयोगकर्ता पहली बार साइन इन करता है, तो एक नया उपयोगकर्ता खाता बनाया जाता है. इसे उन क्रेडेंशियल से लिंक किया जाता है जिनकी मदद से उपयोगकर्ता ने साइन इन किया है. जैसे, उपयोगकर्ता नाम और पासवर्ड, फ़ोन नंबर या पुष्टि करने वाले प्रोवाइडर की जानकारी. यह नया खाता, आपके Firebase प्रोजेक्ट के हिस्से के तौर पर सेव किया जाता है. इसका इस्तेमाल, आपके प्रोजेक्ट के हर ऐप्लिकेशन में किसी उपयोगकर्ता की पहचान करने के लिए किया जा सकता है. भले ही, उपयोगकर्ता किसी भी तरीके से साइन इन करे.

  • अपने ऐप्लिकेशन में, उपयोगकर्ता की बुनियादी प्रोफ़ाइल की जानकारी FirebaseUser ऑब्जेक्ट से पाई जा सकती है. उपयोगकर्ताओं को मैनेज करना लेख देखें.

  • अपने Firebase Realtime Database और Cloud Storage सुरक्षा नियमों में, आप auth वैरिएबल से साइन इन किए हुए उपयोगकर्ता का यूनीक उपयोगकर्ता आईडी पा सकते हैं. इसका इस्तेमाल, यह कंट्रोल करने के लिए किया जा सकता है कि उपयोगकर्ता किस डेटा को ऐक्सेस कर सकता है.

पुष्टि करने वाले प्रोवाइडर के क्रेडेंशियल को किसी मौजूदा उपयोगकर्ता खाते से लिंक करके, उपयोगकर्ताओं को पुष्टि करने वाले कई प्रोवाइडर की मदद से अपने ऐप्लिकेशन में साइन इन करने की अनुमति दी जा सकती है.

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

Kotlin

Firebase.auth.signOut()

Java

FirebaseAuth.getInstance().signOut();