Apple प्लैटफ़ॉर्म पर Yahoo का इस्तेमाल करके पुष्टि करें

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

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

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

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

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

    2. इन सेवा देने वाली कंपनियों के साथ ऐप्लिकेशन रजिस्टर करते समय, अपने प्रोजेक्ट के लिए *.firebaseapp.com डोमेन को अपने ऐप्लिकेशन के रीडायरेक्ट डोमेन के तौर पर रजिस्टर करना न भूलें.
  5. सेव करें पर क्लिक करें.

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

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

  1. अपने Xcode प्रोजेक्ट में कस्टम यूआरएल स्कीम जोड़ें:

    1. अपने प्रोजेक्ट का कॉन्फ़िगरेशन खोलें: बाईं ओर मौजूद ट्री व्यू में, प्रोजेक्ट के नाम पर दो बार क्लिक करें. टारगेट सेक्शन में जाकर अपना ऐप्लिकेशन चुनें. इसके बाद, जानकारी टैब चुनें और यूआरएल टाइप सेक्शन को बड़ा करें.
    2. + बटन पर क्लिक करें और अपने एन्कोड किए गए ऐप्लिकेशन आईडी को यूआरएल स्कीम के तौर पर जोड़ें. अन्य फ़ील्ड खाली छोड़ दें.

      आपको Firebase कंसोल में, एन्कोड किया गया ऐप्लिकेशन आईडी मिल सकता है: सेटिंग > सामान्य टैब पर जाएं. इसके बाद, नीचे की ओर स्क्रोल करके आपके ऐप्लिकेशन सेक्शन पर जाएं और अपने iOS ऐप्लिकेशन के बारे में जानकारी देखें.

      कॉन्फ़िगरेशन पूरा होने के बाद, आपका कॉन्फ़िगरेशन कुछ ऐसा दिखना चाहिए (लेकिन आपके ऐप्लिकेशन के हिसाब से वैल्यू के साथ):

      Xcode के कस्टम यूआरएल स्कीम सेटअप इंटरफ़ेस का स्क्रीनशॉट

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

    Swift

    var provider = OAuthProvider(providerID: "yahoo.com")
        

    Objective-C

    FIROAuthProvider *provider = [FIROAuthProvider providerWithProviderID:@"yahoo.com"];
        
  3. ज़रूरी नहीं: OAuth अनुरोध के साथ भेजे जाने वाले, पसंद के मुताबिक बनाए गए अतिरिक्त OAuth पैरामीटर की जानकारी दें.

    Swift

    provider.customParameters = [
    "prompt": "login",
    "language": "fr"
    ]
        

    Objective-C

    [provider setCustomParameters:@{@"prompt": @"login", @"language": @"fr"}];
        

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

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

    Swift

    // Request access to Yahoo Mail API.
    // Request read/write access to user contacts.
    // This must be preconfigured in the app's API permissions.
    provider.scopes = ["mail-r", "sdct-w"]
        

    Objective-C

    // Request access to Yahoo Mail API.
    // Request read/write access to user contacts.
    // This must be preconfigured in the app's API permissions.
    [provider setScopes:@[@"mail-r", @"sdct-w"]];
        

    ज़्यादा जानने के लिए, Yahoo के स्कोप से जुड़ा दस्तावेज़ देखें.

  5. ज़रूरी नहीं: अगर आपको उपयोगकर्ता को reCAPTCHA दिखाते समय, SFSafariViewController या UIWebView को दिखाने के तरीके को पसंद के मुताबिक बनाना है, तो AuthUIDelegate प्रोटोकॉल के मुताबिक कस्टम क्लास बनाएं और उसे credentialWithUIDelegate को पास करें.

  6. OAuth प्रोवाइडर ऑब्जेक्ट का इस्तेमाल करके, Firebase से पुष्टि करें.

    Swift

    provider.getCredentialWith(nil) { credential, error in
    if error != nil {
    // Handle error.
    }
    if credential != nil {
    Auth().signIn(with: credential) { authResult, error in
      if error != nil {
        // Handle error.
      }
      // User is signed in.
      // IdP data available in authResult.additionalUserInfo.profile.
      // Yahoo OAuth access token can also be retrieved by:
      // (authResult.credential as? OAuthCredential)?.accessToken
      // Yahoo OAuth ID token can be retrieved by calling:
      // (authResult.credential as? OAuthCredential)?.idToken
    }
    }
    }
        

    Objective-C

    [provider getCredentialWithUIDelegate:nil
                           completion:^(FIRAuthCredential *_Nullable credential, NSError *_Nullable error) {
    if (error) {
    // Handle error.
    }
    if (credential) {
    [[FIRAuth auth] signInWithCredential:credential
                              completion:^(FIRAuthDataResult *_Nullable authResult, NSError *_Nullable error) {
      if (error) {
        // Handle error.
      }
      // User is signed in.
      // IdP data available in authResult.additionalUserInfo.profile.
      // Yahoo OAuth access token can also be retrieved by:
      // ((FIROAuthCredential *)authResult.credential).accessToken
      // Yahoo OAuth ID token can be retrieved by calling:
      // ((FIROAuthCredential *)authResult.credential).idToken
    }];
    }
    }];
        

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

    उदाहरण के लिए, प्रोफ़ाइल की बुनियादी जानकारी पाने के लिए, REST API को कॉल किया जा सकता है. इसके लिए, Authorization हेडर में ऐक्सेस टोकन पास करें:

    https://social.yahooapis.com/v1/user/YAHOO_USER_UID/profile?format=json

    जहां YAHOO_USER_UID, Yahoo उपयोगकर्ता का आईडी है. इसे Auth.auth.currentUser.providerData[0].uid फ़ील्ड या authResult.additionalUserInfo.profile से वापस पाया जा सकता है.

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

    Swift

    Auth().currentUser.link(withCredential: credential) { authResult, error in
    if error != nil {
    // Handle error.
    }
    // Yahoo credential is linked to the current user.
    // IdP data available in authResult.additionalUserInfo.profile.
    // Yahoo OAuth access token can also be retrieved by:
    // (authResult.credential as? OAuthCredential)?.accessToken
    // Yahoo OAuth ID token can be retrieved by calling:
    // (authResult.credential as? OAuthCredential)?.idToken
    }
        

    Objective-C

    [[FIRAuth auth].currentUser
    linkWithCredential:credential
            completion:^(FIRAuthDataResult * _Nullable authResult, NSError * _Nullable error) {
    if (error) {
    // Handle error.
    }
    // Yahoo credential is linked to the current user.
    // IdP data available in authResult.additionalUserInfo.profile.
    // Yahoo OAuth access token is can also be retrieved by:
    // ((FIROAuthCredential *)authResult.credential).accessToken
    // Yahoo OAuth ID token can be retrieved by calling:
    // ((FIROAuthCredential *)authResult.credential).idToken
    }];
        
  8. reauthenticateWithPopup या reauthenticateWithRedirect के साथ भी इसी पैटर्न का इस्तेमाल किया जा सकता है. इससे, संवेदनशील कार्रवाइयों के लिए नए क्रेडेंशियल वापस पाए जा सकते हैं. इन कार्रवाइयों के लिए, हाल ही में लॉगिन करना ज़रूरी होता है.

    Swift

    Auth().currentUser.reauthenticateWithCredential(withCredential: credential) { authResult, error in
    if error != nil {
    // Handle error.
    }
    // User is re-authenticated with fresh tokens minted and
    // should be able to perform sensitive operations like account
    // deletion and email or password update.
    // IdP data available in result.additionalUserInfo.profile.
    // Additional OAuth access token is can also be retrieved by:
    // (authResult.credential as? OAuthCredential)?.accessToken
    // Yahoo OAuth ID token can be retrieved by calling:
    // (authResult.credential as? OAuthCredential)?.idToken
    }
        

    Objective-C

    [[FIRAuth auth].currentUser
    reauthenticateWithCredential:credential
                      completion:^(FIRAuthDataResult * _Nullable authResult, NSError * _Nullable error) {
    if (error) {
    // Handle error.
    }
    // User is re-authenticated with fresh tokens minted and
    // should be able to perform sensitive operations like account
    // deletion and email or password update.
    // IdP data available in result.additionalUserInfo.profile.
    // Additional OAuth access token is can also be retrieved by:
    // ((FIROAuthCredential *)authResult.credential).accessToken
    // Yahoo OAuth ID token can be retrieved by calling:
    // ((FIROAuthCredential *)authResult.credential).idToken
    }];
        

अगले चरण

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

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

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

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

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

Swift

let firebaseAuth = Auth.auth()
do {
  try firebaseAuth.signOut()
} catch let signOutError as NSError {
  print("Error signing out: %@", signOutError)
}

Objective-C

NSError *signOutError;
BOOL status = [[FIRAuth auth] signOut:&signOutError];
if (!status) {
  NSLog(@"Error signing out: %@", signOutError);
  return;
}

पुष्टि करने से जुड़ी सभी गड़बड़ियों के लिए, गड़बड़ी को मैनेज करने वाला कोड भी जोड़ा जा सकता है. गड़बड़ियां ठीक करना देखें.