Google अश्वेत समुदायों के लिए नस्लीय इक्विटी को आगे बढ़ाने के लिए प्रतिबद्ध है। देखो कैसे।
इस पेज का अनुवाद Cloud Translation API से किया गया है.
Switch to English

IOS पर GitHub का उपयोग करके प्रमाणित करें

आप अपने उपयोगकर्ताओं को अपने ऐप में जेनिट OAuth लॉगिन को एकीकृत करके OAuth प्रदाताओं जैसे GitHub का उपयोग करके Firebase के साथ प्रमाणित कर सकते हैं, साइन-इन प्रवाह के अंत को समाप्त करने के लिए Firebase SDK का उपयोग कर सकते हैं।

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

GitHub खातों का उपयोग करने वाले उपयोगकर्ताओं में साइन इन करने के लिए, आपको सबसे पहले GitHub को अपने फायरबेस सर्वर के लिए साइन-इन प्रदाता के रूप में सक्षम करना होगा:

  1. अपने iOS प्रोजेक्ट में Firebase जोड़ें
    pod 'Firebase/Auth'
    
  2. में Firebase कंसोल , प्राधिकरण अनुभाग खोलें।
  3. साइन इन विधि टैब पर, GitHub प्रदाता को सक्षम करें।
  4. उस प्रदाता के डेवलपर कंसोल से क्लाइंट आईडी और क्लाइंट सीक्रेट को प्रदाता कॉन्फ़िगरेशन में जोड़ें:
    1. GitHub पर डेवलपर एप्लिकेशन के रूप में अपना ऐप पंजीकृत करें और अपने ऐप का OAuth 2.0 क्लाइंट आईडी और क्लाइंट सीक्रेट प्राप्त करें
    2. सुनिश्चित करें कि आपके Firebase OAuth रीडायरेक्ट यूआरआई (जैसे my-app-12345.firebaseapp.com/__/auth/handler ) अपने पर अपने ऐप के सेटिंग पृष्ठ में अपने प्राधिकरण कॉलबैक URL के रूप में सेट कर दिया जाता GitHub एप्लिकेशन की config
  5. सहेजें पर क्लिक करें

फायरबेस एसडीके के साथ साइन-इन प्रवाह को संभालें

Firebase iOS SDK के साथ साइन-इन प्रवाह को संभालने के लिए, इन चरणों का पालन करें:

  1. अपने Xcode प्रोजेक्ट में कस्टम URL योजनाएँ जोड़ें:

    1. अपना प्रोजेक्ट कॉन्फ़िगरेशन खोलें: बाएं ट्री दृश्य में प्रोजेक्ट नाम पर डबल-क्लिक करें। TARGETS अनुभाग से अपना एप्लिकेशन चुनें, फिर जानकारी टैब चुनें, और URL प्रकार अनुभाग का विस्तार करें।
    2. + बटन पर क्लिक करें, और अपने उलट ग्राहक आईडी के लिए एक URL योजना जोड़ें। इस मान को खोजने के लिए, GoogleService-Info.plist कॉन्फ़िगरेशन फ़ाइल खोलें, और REVERSED_CLIENT_ID कुंजी खोजें। उस कुंजी का मान कॉपी करें, और उसे कॉन्फ़िगरेशन पृष्ठ पर URL स्कीम्स बॉक्स में पेस्ट करें। बाकी खेतों को खाली छोड़ दें।

      जब पूरा हो जाए, तो आपका कॉन्फिगर निम्नलिखित के समान दिखना चाहिए (लेकिन आपके एप्लिकेशन-विशिष्ट मानों के साथ):

  2. प्रदाता ID github.com का उपयोग करके OAuthProvider का एक उदाहरण बनाएं।

    तीव्र

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

    उद्देश्य सी

        FIROAuthProvider *provider = [FIROAuthProvider providerWithProviderID:@"github.com"];
        
  3. वैकल्पिक : अतिरिक्त कस्टम OAuth पैरामीटर निर्दिष्ट करें जिसे आप OAuth अनुरोध के साथ भेजना चाहते हैं।

    तीव्र

        provider.customParameters = [
          "allow_signup": "false"
        ]
        

    उद्देश्य सी

        [provider setCustomParameters:@{@"allow_signup": @"false"}];
        

    GitHub के मापदंडों के लिए, GitHub OAuth प्रलेखन देखें । ध्यान दें कि आप setCustomParameters साथ setCustomParameters -आवश्यक पैरामीटर पास नहीं कर सकते। ये पैरामीटर हैं client_id , redirect_uri , response_type , गुंजाइश और स्थिति

  4. वैकल्पिक : मूल प्रोफ़ाइल से परे अतिरिक्त OAuth 2.0 स्कोप निर्दिष्ट करें जिसे आप प्रमाणीकरण प्रदाता से अनुरोध करना चाहते हैं। यदि आपके एप्लिकेशन को GitHub API से निजी उपयोगकर्ता डेटा तक पहुंच की आवश्यकता है, तो आपको GitHub डेवलपर कंसोल में API API के तहत GitHubs तक पहुंचने के लिए अनुमति का अनुरोध करना होगा। अनुरोधित OAuth स्कोप्स को ऐप के एपीआई अनुमतियों में पूर्व-निर्धारित लोगों के लिए सटीक मिलान होना चाहिए।

    तीव्र

        // Request read access to a user's email addresses.
        // This must be preconfigured in the app's API permissions.
        provider.scopes = ["user:email"]
        

    उद्देश्य सी

        // Request read access to a user's email addresses.
        // This must be preconfigured in the app's API permissions.
        [provider setScopes:@[@"user:email"]];
        

    अधिक जानने के लिए, GitHub scopes प्रलेखन देखें

  5. वैकल्पिक : यदि आप उपयोगकर्ता को reCAPTCHA प्रदर्शित करते समय अपने ऐप को SFSafariViewController या UIWebView प्रस्तुत करने के तरीके को अनुकूलित करना चाहते हैं, तो एक कस्टम वर्ग बनाएं, जो FIRAuthUIDelegate प्रोटोकॉल के अनुरूप है, और इसे प्राप्त करने के लिए पास करें getCredentialWithUIDelegate:completion: :।

  6. OAuth प्रदाता ऑब्जेक्ट का उपयोग करके Firebase के साथ प्रमाणीकरण।

    तीव्र

        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.
              // GitHub OAuth access token can also be retrieved by:
              // authResult.credential.accessToken
              // GitHub OAuth ID token can be retrieved by calling:
              // authResult.credential.idToken
            }
          }
        }
        

    उद्देश्य सी

        [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.
              // GitHub OAuth access token can also be retrieved by:
              // authResult.credential.accessToken
              // GitHub OAuth ID token can be retrieved by calling:
              // authResult.credential.idToken
            }];
          }
        }];
        

    OAuth एक्सेस टोकन का उपयोग करके, आप GitHub API को कॉल कर सकते हैं।

    उदाहरण के लिए, मूल प्रोफ़ाइल जानकारी प्राप्त करने के लिए, आप REST API को कॉल कर सकते हैं, Authorization शीर्षलेख में पहुंच टोकन पास कर सकते हैं:

    https://api.github.com/user
    
  7. जबकि उपरोक्त उदाहरण साइन-इन फ्लो पर ध्यान केंद्रित करते हैं, आपके पास एक मौजूदा उपयोगकर्ता के लिए GitHub प्रदाता को लिंक करने की क्षमता भी है। उदाहरण के लिए, आप एक से अधिक प्रदाताओं को एक ही उपयोगकर्ता से लिंक कर सकते हैं जिससे वे या तो साइन इन कर सकते हैं।

    तीव्र

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

    उद्देश्य सी

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

    तीव्र

        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.accessToken
          // GitHub OAuth ID token can be retrieved by calling:
          // authResult.credential.idToken
        }
        

    उद्देश्य सी

        [[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:
          // authResult.credential.accessToken
          // GitHub OAuth ID token can be retrieved by calling:
          // authResult.credential.idToken
        }];
        

अगला कदम

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

  • अपने ऐप्स में, आप FIRUser ऑब्जेक्ट से उपयोगकर्ता की मूल प्रोफ़ाइल जानकारी प्राप्त कर सकते हैं। उपयोगकर्ता प्रबंधित करें देखें।

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

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

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

तीव्र

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

उद्देश्य सी

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

आप प्रमाणीकरण त्रुटियों की पूरी श्रृंखला के लिए त्रुटि हैंडलिंग कोड भी जोड़ना चाह सकते हैं। हैंडल एरर्स देखें।