फ़ोन नंबर का इस्तेमाल करके, Apple प्लैटफ़ॉर्म पर Firebase से पुष्टि करें

आप उपयोगकर्ता के फ़ोन पर मैसेज (एसएमएस) भेजकर साइन इन करने के लिए Firebase से पुष्टि करने की सुविधा का इस्तेमाल कर सकते हैं. उपयोगकर्ता, एसएमएस मैसेज में मौजूद एक बार इस्तेमाल होने वाले कोड का इस्तेमाल करके साइन इन करता है.

अपने ऐप्लिकेशन में फ़ोन नंबर से साइन-इन करने का सबसे आसान तरीका FirebaseUI का इस्तेमाल करना है. इसमें ड्रॉप-इन साइन-इन विजेट शामिल होता है, जो फ़ोन नंबर साइन-इन के लिए साइन-इन फ़्लो को लागू करता है. इसके अलावा, पासवर्ड-आधारित और फ़ेडरेटेड साइन-इन भी शामिल होता है. इस दस्तावेज़ में Firebase SDK टूल का इस्तेमाल करके फ़ोन नंबर साइन-इन फ़्लो लागू करने का तरीका बताया गया है.

वेब कंटेनर इंस्टॉल करने से पहले

  1. अगर आपने अभी तक अपने ऐप्लिकेशन को Firebase प्रोजेक्ट से कनेक्ट नहीं किया है, तो Firebase कंसोल से ऐसा करें.

  2. Firebase डिपेंडेंसी इंस्टॉल और मैनेज करने के लिए, Swift पैकेज मैनेजर का इस्तेमाल करें.

    1. Xcode में, अपना ऐप्लिकेशन प्रोजेक्ट खोलने के लिए, फ़ाइल > पैकेज जोड़ें पर जाएं.
    2. जब कहा जाए, तब Firebase Apple प्लैटफ़ॉर्म SDK टूल का रिपॉज़िटरी जोड़ें:
      3.   https://github.com/firebase/firebase-ios-sdk.git
    3. Firebase से पुष्टि करने की लाइब्रेरी चुनें.
    4. अपने टारगेट की बिल्ड सेटिंग के अन्य लिंकर फ़्लैग सेक्शन में -ObjC फ़्लैग जोड़ें.
    5. यह काम पूरा होने के बाद, Xcode बैकग्राउंड में आपकी डिपेंडेंसी को अपने-आप रिज़ॉल्व और डाउनलोड करना शुरू कर देगा.

सुरक्षा से जुड़ी समस्याएं

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

अगर आपके ऐप्लिकेशन में फ़ोन नंबर के ज़रिए साइन इन करने की सुविधा का इस्तेमाल किया जाता है, तो आपको साइन-इन करने के ज़्यादा सुरक्षित तरीकों के साथ-साथ इसकी सुविधा भी देनी चाहिए. साथ ही, उपयोगकर्ताओं को फ़ोन नंबर से साइन-इन करने के सुरक्षित तरीकों के बारे में जानकारी देनी चाहिए.

अपने Firebase प्रोजेक्ट के लिए, फ़ोन नंबर से साइन-इन करने की सुविधा चालू करना

उपयोगकर्ताओं को एसएमएस से साइन इन करने के लिए, आपको सबसे पहले अपने Firebase प्रोजेक्ट के लिए, फ़ोन नंबर से साइन इन करने का तरीका चालू करना होगा:

  1. Firebase कंसोल में, पुष्टि करने की सुविधा वाला सेक्शन खोलें.
  2. साइन इन करने का तरीका पेज पर, फ़ोन नंबर से साइन इन करने का तरीका चालू करें.

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

ऐप्लिकेशन की पुष्टि करने की सुविधा चालू करें

फ़ोन नंबर की पुष्टि करने की सुविधा का इस्तेमाल करने के लिए, Firebase को यह पुष्टि करनी होगी कि फ़ोन नंबर से साइन-इन करने के अनुरोध आपके ऐप्लिकेशन से आ रहे हैं. ऐसा दो तरीकों से किया जा सकता है:

  • साइलेंट एपीएन सूचनाएं: जब किसी उपयोगकर्ता को उसके फ़ोन नंबर से साइन इन करने के लिए, किसी डिवाइस पर पहली बार साइन इन किया जाता है, तो Firebase से पुष्टि करने की सुविधा, साइलेंट पुश नोटिफ़िकेशन का इस्तेमाल करके उस उपयोगकर्ता को टोकन भेजती है. अगर आपके ऐप्लिकेशन को Firebase से सूचना मिलती है, तो फ़ोन नंबर से साइन इन किया जा सकता है.

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

  • re कैप्चा की पुष्टि करना: अगर किसी साइलेंट पुश नोटिफ़िकेशन को भेजने या पाने की सुविधा मुमकिन नहीं है, जैसे कि जब उपयोगकर्ता ने आपके ऐप्लिकेशन के लिए बैकग्राउंड रीफ़्रेश की सुविधा बंद की हो या iOS सिम्युलेटर पर आपके ऐप्लिकेशन की जांच की जा रही हो, तो Firebase से पुष्टि करने की सुविधा, फ़ोन पर साइन इन की प्रोसेस को पूरा करने के लिए reCAPTCHA की पुष्टि का इस्तेमाल करती है. reCAPTCHA की चुनौती को पूरा करने के लिए, उपयोगकर्ता को अपनी समस्या हल करने की ज़रूरत नहीं होती.

जब साइलेंट पुश नोटिफ़िकेशन को सही तरीके से कॉन्फ़िगर किया जाता है, तो कुछ ही प्रतिशत उपयोगकर्ताओं को reCAPTCHA फ़्लो का अनुभव होता है. फिर भी, आपको यह यह पक्का करना चाहिए कि फ़ोन नंबर से साइन-इन करने की सुविधा ठीक से काम करे, चाहे साइलेंट पुश नोटिफ़िकेशन उपलब्ध हों या नहीं.

सूचनाओं के लिए आवाज़ बंद होने पर सूचना पाएं

Firebase से पुष्टि करने की सुविधा के साथ इस्तेमाल करने के लिए, एपीएन से जुड़ी सूचनाएं पाने की सुविधा चालू करने के लिए:

  1. Xcode में, अपने प्रोजेक्ट के लिए पुश नोटिफ़िकेशन चालू करें.

  2. अपनी एपीएन की पुष्टि करने वाली कुंजी को Firebase पर अपलोड करें. अगर आपके पास पहले से एपीएन की पुष्टि करने वाली कुंजी नहीं है, तो Apple Developer Member Center में जाकर एक कुंजी बनाएं.

    1. Firebase कंसोल में, अपने प्रोजेक्ट में गियर आइकॉन चुनें, प्रोजेक्ट सेटिंग चुनें, और फिर क्लाउड से मैसेज टैब चुनें.

    2. iOS ऐप्लिकेशन कॉन्फ़िगरेशन में, APNs पुष्टि कुंजी में अपलोड करें बटन पर क्लिक करें.

    3. उस जगह ब्राउज़ करें जहां आपने अपनी कुंजी सेव की है. इसके बाद, उसे चुनें और खोलें पर क्लिक करें. कुंजी के लिए कुंजी आईडी जोड़ें ( Apple Developer के सदस्य केंद्र में उपलब्ध) और अपलोड करें पर क्लिक करें.

    अगर आपके पास पहले से कोई एपीएन सर्टिफ़िकेट है, तो आपके पास सर्टिफ़िकेट अपलोड करने का विकल्प भी है.

reCAPTCHA से पुष्टि करने की सुविधा सेट अप करें

Firebase SDK टूल को reCAPTCHA की पुष्टि करने की सुविधा चालू करने के लिए:

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

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

      Xcode के कस्टम यूआरएल स्कीम के सेटअप इंटरफ़ेस का स्क्रीनशॉट
  2. ज़रूरी नहीं: अगर आपको उपयोगकर्ता को reCAPTCHA दिखाते समय अपने ऐप्लिकेशन के SFSafariViewController दिखाने का तरीका पसंद के मुताबिक बनाना है, तो AuthUIDelegate प्रोटोकॉल के मुताबिक एक कस्टम क्लास बनाएं और उसे verifyPhoneNumber(_:uiDelegate:completion:) को पास करें.

उपयोगकर्ता के फ़ोन पर पुष्टि करने के लिए कोड भेजें

फ़ोन नंबर से साइन-इन करने के लिए, उपयोगकर्ता को ऐसा इंटरफ़ेस दिखाएं जो उसे अपना फ़ोन नंबर देने के लिए कहता है. इसके बाद, verifyPhoneNumber(_:uiDelegate:completion:) को कॉल करके अनुरोध करें कि Firebase, मैसेज (एसएमएस) के ज़रिए उपयोगकर्ता के फ़ोन पर पुष्टि करने वाला कोड भेजे:

  1. उपयोगकर्ता का फ़ोन नंबर पाएं.

    कानूनी समझौते की शर्तें अलग-अलग हो सकती हैं. हालांकि, सबसे सही तरीका यह है कि अपने उपयोगकर्ताओं के लिए उम्मीदें तय करने के लिए, उन्हें यह जानकारी दी जानी चाहिए कि अगर वे फ़ोन से साइन-इन की सुविधा इस्तेमाल करते हैं, तो उन्हें पुष्टि के लिए एक मैसेज (एसएमएस) मिल सकता है. साथ ही, उन्हें पुष्टि करने के लिए एक एसएमएस मिल सकता है. साथ ही, आपको सामान्य दरें लागू होंगी.

  2. verifyPhoneNumber(_:uiDelegate:completion:) को कॉल करें और उसे उपयोगकर्ता का फ़ोन नंबर दें.

    Swift

    PhoneAuthProvider.provider()
  .verifyPhoneNumber(phoneNumber, uiDelegate: nil) { verificationID, error in
      if let error = error {
        self.showMessagePrompt(error.localizedDescription)
        return
      }
      // Sign in using the verificationID and the code sent to the user
      // ...
  }

    Objective-C

    [[FIRPhoneAuthProvider provider] verifyPhoneNumber:userInput
                                        UIDelegate:nil
                                        completion:^(NSString * _Nullable verificationID, NSError * _Nullable error) {
  if (error) {
    [self showMessagePrompt:error.localizedDescription];
    return;
  }
  // Sign in using the verificationID and the code sent to the user
  // ...
}];

    verifyPhoneNumber तरीका फिर से शामिल किया गया है: अगर इसे कई बार कॉल किया जाता है, जैसे कि किसी व्यू के onAppear तरीके से, तो verifyPhoneNumber तरीका तब तक दूसरा एसएमएस नहीं भेजेगा, जब तक मूल अनुरोध का समय खत्म नहीं हो जाता.

    verifyPhoneNumber(_:uiDelegate:completion:) को कॉल करने पर, Firebase आपके ऐप्लिकेशन को साइलेंट पुश नोटिफ़िकेशन भेजता है या उपयोगकर्ता को reCAPTCHA चैलेंज जारी करता है. जब आपके ऐप्लिकेशन को सूचना मिल जाती है या उपयोगकर्ता reCAPTCHA चैलेंज पूरा कर लेता है, तो Firebase आपके बताए गए फ़ोन नंबर पर पुष्टि करने वाला कोड वाला एक मैसेज (एसएमएस) भेजता है. साथ ही, पुष्टि करने से जुड़ा एक आईडी आपके पास करता है. उपयोगकर्ता को साइन इन करने के लिए, आपको पुष्टि करने वाला कोड और आईडी, दोनों की ज़रूरत होगी.

    Firebase से भेजे गए एसएमएस को स्थानीय भाषा में भी भेजा जा सकता है. इसके लिए, आपको अपने ऑथराइज़ेशन इंस्टेंस में languageCode प्रॉपर्टी के ज़रिए पुष्टि की भाषा तय करनी होगी.

    Swift

     // Change language code to french.
 Auth.auth().languageCode = "fr";

    Objective-C

     // Change language code to french.
 [FIRAuth auth].languageCode = @"fr";

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

    पुष्टि करने वाले आईडी को सेव करके रखा जा सकता है. NSUserDefaults ऑब्जेक्ट के साथ, पुष्टि करने के आईडी को सेव करने का आसान तरीका है:

    Swift

    UserDefaults.standard.set(verificationID, forKey: "authVerificationID")

    Objective-C

    NSUserDefaults *defaults = [NSUserDefaults standardUserDefaults];
[defaults setObject:verificationID forKey:@"authVerificationID"];

    इसके बाद, सेव की गई वैल्यू को वापस लाया जा सकता है:

    Swift

    let verificationID = UserDefaults.standard.string(forKey: "authVerificationID")

    Objective-C

    NSString *verificationID = [defaults stringForKey:@"authVerificationID"];

अगर verifyPhoneNumber(_:uiDelegate:completion:) पर कॉल पूरा हो जाता है, तो उपयोगकर्ता को एसएमएस मैसेज में पुष्टि कोड मिलने पर उसे टाइप करने का प्रॉम्प्ट दिया जा सकता है.

पुष्टि करने के कोड से उपयोगकर्ता को साइन इन करें

उपयोगकर्ता की ओर से आपके ऐप्लिकेशन को मैसेज (एसएमएस) से मिला पुष्टि करने वाला कोड मिलने के बाद, पुष्टि करने के कोड और पुष्टि आईडी से एक FIRPhoneAuthCredential ऑब्जेक्ट बनाकर और उस ऑब्जेक्ट को signInWithCredential:completion: को पास करके, उपयोगकर्ता को साइन इन करें.

  1. उपयोगकर्ता से पुष्टि करने के लिए कोड पाएं.
  2. पुष्टि करने के कोड और पुष्टि आईडी की मदद से, FIRPhoneAuthCredential ऑब्जेक्ट बनाएं.

    Swift

    let credential = PhoneAuthProvider.provider().credential(
  withVerificationID: verificationID,
  verificationCode: verificationCode
)

    Objective-C

    FIRAuthCredential *credential = [[FIRPhoneAuthProvider provider]
    credentialWithVerificationID:verificationID
                verificationCode:userInput];
  3. FIRPhoneAuthCredential ऑब्जेक्ट वाले उपयोगकर्ता को साइन इन करें:

    Swift

    Auth.auth().signIn(with: credential) { authResult, error in
    if let error = error {
      let authError = error as NSError
      if isMFAEnabled, authError.code == AuthErrorCode.secondFactorRequired.rawValue {
        // The user is a multi-factor user. Second factor challenge is required.
        let resolver = authError
          .userInfo[AuthErrorUserInfoMultiFactorResolverKey] as! MultiFactorResolver
        var displayNameString = ""
        for tmpFactorInfo in resolver.hints {
          displayNameString += tmpFactorInfo.displayName ?? ""
          displayNameString += " "
        }
        self.showTextInputPrompt(
          withMessage: "Select factor to sign in\n\(displayNameString)",
          completionBlock: { userPressedOK, displayName in
            var selectedHint: PhoneMultiFactorInfo?
            for tmpFactorInfo in resolver.hints {
              if displayName == tmpFactorInfo.displayName {
                selectedHint = tmpFactorInfo as? PhoneMultiFactorInfo
              }
            }
            PhoneAuthProvider.provider()
              .verifyPhoneNumber(with: selectedHint!, uiDelegate: nil,
                                 multiFactorSession: resolver
                                   .session) { verificationID, error in
                if error != nil {
                  print(
                    "Multi factor start sign in failed. Error: \(error.debugDescription)"
                  )
                } else {
                  self.showTextInputPrompt(
                    withMessage: "Verification code for \(selectedHint?.displayName ?? "")",
                    completionBlock: { userPressedOK, verificationCode in
                      let credential: PhoneAuthCredential? = PhoneAuthProvider.provider()
                        .credential(withVerificationID: verificationID!,
                                    verificationCode: verificationCode!)
                      let assertion: MultiFactorAssertion? = PhoneMultiFactorGenerator
                        .assertion(with: credential!)
                      resolver.resolveSignIn(with: assertion!) { authResult, error in
                        if error != nil {
                          print(
                            "Multi factor finanlize sign in failed. Error: \(error.debugDescription)"
                          )
                        } else {
                          self.navigationController?.popViewController(animated: true)
                        }
                      }
                    }
                  )
                }
              }
          }
        )
      } else {
        self.showMessagePrompt(error.localizedDescription)
        return
      }
      // ...
      return
    }
    // User is signed in
    // ...
}

    Objective-C

    [[FIRAuth auth] signInWithCredential:credential
                          completion:^(FIRAuthDataResult * _Nullable authResult,
                                       NSError * _Nullable error) {
    if (isMFAEnabled && error && error.code == FIRAuthErrorCodeSecondFactorRequired) {
      FIRMultiFactorResolver *resolver = error.userInfo[FIRAuthErrorUserInfoMultiFactorResolverKey];
      NSMutableString *displayNameString = [NSMutableString string];
      for (FIRMultiFactorInfo *tmpFactorInfo in resolver.hints) {
        [displayNameString appendString:tmpFactorInfo.displayName];
        [displayNameString appendString:@" "];
      }
      [self showTextInputPromptWithMessage:[NSString stringWithFormat:@"Select factor to sign in\n%@", displayNameString]
                           completionBlock:^(BOOL userPressedOK, NSString *_Nullable displayName) {
       FIRPhoneMultiFactorInfo* selectedHint;
       for (FIRMultiFactorInfo *tmpFactorInfo in resolver.hints) {
         if ([displayName isEqualToString:tmpFactorInfo.displayName]) {
           selectedHint = (FIRPhoneMultiFactorInfo *)tmpFactorInfo;
         }
       }
       [FIRPhoneAuthProvider.provider
        verifyPhoneNumberWithMultiFactorInfo:selectedHint
        UIDelegate:nil
        multiFactorSession:resolver.session
        completion:^(NSString * _Nullable verificationID, NSError * _Nullable error) {
          if (error) {
            [self showMessagePrompt:error.localizedDescription];
          } else {
            [self showTextInputPromptWithMessage:[NSString stringWithFormat:@"Verification code for %@", selectedHint.displayName]
                                 completionBlock:^(BOOL userPressedOK, NSString *_Nullable verificationCode) {
             FIRPhoneAuthCredential *credential =
                 [[FIRPhoneAuthProvider provider] credentialWithVerificationID:verificationID
                                                              verificationCode:verificationCode];
             FIRMultiFactorAssertion *assertion = [FIRPhoneMultiFactorGenerator assertionWithCredential:credential];
             [resolver resolveSignInWithAssertion:assertion completion:^(FIRAuthDataResult * _Nullable authResult, NSError * _Nullable error) {
               if (error) {
                 [self showMessagePrompt:error.localizedDescription];
               } else {
                 NSLog(@"Multi factor finanlize sign in succeeded.");
               }
             }];
           }];
          }
        }];
     }];
    }
  else if (error) {
    // ...
    return;
  }
  // User successfully signed in. Get user data from the FIRUser object
  if (authResult == nil) { return; }
  FIRUser *user = authResult.user;
  // ...
}];

काल्पनिक फ़ोन नंबर के साथ परीक्षण करें

Firebase कंसोल के ज़रिए, डेवलपमेंट के लिए काल्पनिक फ़ोन नंबर सेट अप किए जा सकते हैं. काल्पनिक फ़ोन नंबरों के साथ टेस्ट करने के ये फ़ायदे हैं:

  • इस्तेमाल करने का कोटा खर्च किए बिना, फ़ोन नंबर की पुष्टि करने की सुविधा की जांच करें.
  • वास्तविक एसएमएस मैसेज भेजे बिना ही फ़ोन नंबर की पुष्टि करके देखें.
  • थ्रॉटल किए बिना, एक ही फ़ोन नंबर से लगातार टेस्ट करें. इससे, अगर समीक्षक ने जांच के लिए एक ही फ़ोन नंबर का इस्तेमाल किया है, तो ऐप स्टोर की समीक्षा की प्रक्रिया के दौरान, आवेदन अस्वीकार किए जाने का जोखिम कम हो जाता है.
  • ऐप्लिकेशन की डेवलपमेंट एनवायरमेंट में आसानी से जांच करें. इसके लिए आपको अलग से कुछ नहीं करना पड़ता. जैसे, Google Play services के बिना, iOS सिम्युलेटर या Android एम्युलेटर में ऐप्लिकेशन डेवलप करने की क्षमता.
  • इंटिग्रेशन टेस्ट में सुरक्षा जांच से बचने की ज़रूरत नहीं होती. आम तौर पर, यह जांच प्रोडक्शन एनवायरमेंट में, असली फ़ोन नंबर पर लागू होती हैं.

काल्पनिक फ़ोन नंबर इन शर्तों के मुताबिक होने चाहिए:

  1. पक्का करें कि आप ऐसे फ़ोन नंबर इस्तेमाल करें जो असल में काल्पनिक हैं और जो पहले से मौजूद नहीं हैं. Firebase से पुष्टि करने की सुविधा से, ऐसे मौजूदा फ़ोन नंबरों को टेस्ट नंबर के तौर पर सेट करने की अनुमति नहीं मिलती जिनका इस्तेमाल असल उपयोगकर्ता करते हैं. अमेरिका के टेस्ट फ़ोन नंबर के तौर पर, इससे पहले 555 नंबर का इस्तेमाल किया जा सकता है. उदाहरण के लिए: +1 650-555-3434
  2. फ़ोन नंबर लंबाई और दूसरी चीज़ों को ध्यान में रखते हुए सही तरीके से फ़ॉर्मैट किए जाने चाहिए. उन्हें अब भी उसी तरह से पुष्टि की जाएगी जिस तरह किसी असली उपयोगकर्ता के फ़ोन नंबर की पुष्टि की जाती है.
  3. डेवलपमेंट के लिए, ज़्यादा से ज़्यादा 10 फ़ोन नंबर जोड़े जा सकते हैं.
  4. ऐसे टेस्ट फ़ोन नंबर/कोड का इस्तेमाल करें जिनका अनुमान लगाना मुश्किल हो और जिन्हें बार-बार बदला जा सके.

काल्पनिक फ़ोन नंबर और पुष्टि करने के लिए कोड बनाएं

  1. Firebase कंसोल में, पुष्टि करने की सुविधा सेक्शन खोलें.
  2. साइन इन करने का तरीका टैब में, अगर आपने पहले से फ़ोन की सेवा देने वाली कंपनी को चालू नहीं किया है, तो उसे चालू करें.
  3. टेस्टिंग के लिए फ़ोन नंबर अकॉर्डियन मेन्यू खोलें.
  4. वह फ़ोन नंबर दें जिसकी आपको जांच करनी है. उदाहरण के लिए: +1 650-555-3434.
  5. उस खास नंबर के लिए छह अंकों का पुष्टि करने वाला कोड दें, जैसे कि: 654321.
  6. नंबर जोड़ें. अगर ज़रूरत हो, तो फ़ोन नंबर और उससे जुड़े कोड को मिटाने के लिए, उससे जुड़ी लाइन पर कर्सर घुमाएं और ट्रैश आइकॉन पर क्लिक करें.

मैन्युअल तरीके से जांच करने की सुविधा

अपने ऐप्लिकेशन में, किसी काल्पनिक फ़ोन नंबर का इस्तेमाल सीधे तौर पर शुरू किया जा सकता है. इससे, डेवलपमेंट स्टेज के दौरान मैन्युअल तरीके से जांच की जा सकती है. इसके लिए, कोटा की समस्याओं या थ्रॉटलिंग की ज़रूरत नहीं पड़ती. Google Play services को इंस्टॉल किए बिना भी, सीधे iOS सिम्युलेटर या Android Emulator से भी जांच की जा सकती है.

जब आप काल्पनिक फ़ोन नंबर देते हैं और पुष्टि करने के लिए कोड भेजते हैं, तो कोई मैसेज (एसएमएस) नहीं भेजा जाता है. इसके बजाय, साइन इन करने के लिए, आपको पहले से कॉन्फ़िगर किया गया पुष्टि करने वाला कोड देना होगा.

साइन-इन पूरा होने पर, उस फ़ोन नंबर से एक Firebase उपयोगकर्ता बन जाता है. इस उपयोगकर्ता का व्यवहार और प्रॉपर्टी बिलकुल असली फ़ोन नंबर इस्तेमाल करने वाले व्यक्ति की तरह ही होती हैं और वह रीयलटाइम डेटाबेस/Cloud Firestore और दूसरी सेवाओं को भी इसी तरह ऐक्सेस कर सकता है. इस प्रोसेस के दौरान बनाए गए आईडी टोकन का हस्ताक्षर वही होता है जो फ़ोन नंबर इस्तेमाल करने वाले किसी व्यक्ति का होता है.

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

इंटिग्रेशन की जांच करना

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

iOS पर, verifyPhoneNumber को कॉल करने से पहले, appVerificationDisabledForTesting की सेटिंग को TRUE पर सेट करना होगा. इसे किसी एपीएन टोकन की ज़रूरत के बिना या बैकग्राउंड में साइलेंट पुश नोटिफ़िकेशन भेजे बिना प्रोसेस किया जाता है. इससे सिम्युलेटर में टेस्ट करना आसान हो जाता है. इससे reCAPTCHA फ़ॉलबैक फ़्लो भी बंद हो जाता है.

ध्यान दें कि ऐप्लिकेशन की पुष्टि की सुविधा बंद होने पर, किसी गैर-काल्पनिक फ़ोन नंबर का इस्तेमाल करके साइन इन नहीं किया जा सकेगा. इस एपीआई के साथ सिर्फ़ काल्पनिक फ़ोन नंबर इस्तेमाल किए जा सकते हैं.

Swift

let phoneNumber = "+16505554567"

// This test verification code is specified for the given test phone number in the developer console.
let testVerificationCode = "123456"

Auth.auth().settings.isAppVerificationDisabledForTesting = TRUE
PhoneAuthProvider.provider().verifyPhoneNumber(phoneNumber, uiDelegate:nil) {
                                                            verificationID, error in
    if (error) {
      // Handles error
      self.handleError(error)
      return
    }
    let credential = PhoneAuthProvider.provider().credential(withVerificationID: verificationID ?? "",
                                                               verificationCode: testVerificationCode)
    Auth.auth().signInAndRetrieveData(with: credential) { authData, error in
      if (error) {
        // Handles error
        self.handleError(error)
        return
      }
      _user = authData.user
    }];
}];

Objective-C

NSString *phoneNumber = @"+16505554567";

// This test verification code is specified for the given test phone number in the developer console.
NSString *testVerificationCode = @"123456";

[FIRAuth auth].settings.appVerificationDisabledForTesting = YES;
[[FIRPhoneAuthProvider provider] verifyPhoneNumber:phoneNumber
                                        completion:^(NSString *_Nullable verificationID,
                                                     NSError *_Nullable error) {
    if (error) {
      // Handles error
      [self handleError:error];
      return;
    }
    FIRAuthCredential *credential =
        [FIRPhoneAuthProvider credentialWithVerificationID:verificationID
                                          verificationCode:testVerificationCode];
    [FIRAuth auth] signInWithAndRetrieveDataWithCredential:credential
                                                completion:^(FIRUser *_Nullable user,
                                                             NSError *_Nullable error) {
      if (error) {
        // Handles error
        [self handleError:error];
        return;
      }
      _user = user;
    }];
}];

अपेंडिक्स: स्वाइप किए बिना फ़ोन साइन-इन का इस्तेमाल करना

Firebase से पुष्टि करने की सुविधा, आपके ऐप्लिकेशन का एपीएन टोकन अपने-आप पाने के लिए स्विज़लिंग के तरीके का इस्तेमाल करती है. इससे, Firebase आपके ऐप्लिकेशन पर भेजे जाने वाले साइलेंट पुश नोटिफ़िकेशन को मैनेज करता है. साथ ही, पुष्टि के दौरान reCAPTCHA की पुष्टि करने वाले पेज से कस्टम स्कीम रीडायरेक्ट को अपने-आप इंटरसेप्ट करता है.

अगर आपको स्विज़लिंग का इस्तेमाल नहीं करना है, तो अपने ऐप्लिकेशन की Info.plist फ़ाइल में FirebaseAppDelegateProxyEnabled फ़्लैग जोड़कर और उसे NO पर सेट करके, इसे बंद किया जा सकता है. ध्यान दें कि इस फ़्लैग को NO पर सेट करने से, Firebase के दूसरे प्रॉडक्ट के लिए स्वाइप करने की सुविधा बंद हो जाती है. इनमें Firebase क्लाउड से मैसेज भी शामिल हैं.

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

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

एपीएन डिवाइस टोकन पाने के लिए, application(_:didRegisterForRemoteNotificationsWithDeviceToken:) तरीका लागू करें. इसके बाद, इसमें डिवाइस टोकन को Auth के setAPNSToken(_:type:) वाले तरीके से पास करें.

Swift

func application(_ application: UIApplication, didRegisterForRemoteNotificationsWithDeviceToken deviceToken: Data) {
  // Pass device token to auth
  Auth.auth().setAPNSToken(deviceToken, type: .prod)

  // Further handling of the device token if needed by the app
  // ...
}

Objective-C

- (void)application:(UIApplication *)application
    didRegisterForRemoteNotificationsWithDeviceToken:(NSData *)deviceToken {
  // Pass device token to auth.
  [[FIRAuth auth] setAPNSToken:deviceToken type:FIRAuthAPNSTokenTypeProd];
  // Further handling of the device token if needed by the app.
}

पुश नोटिफ़िकेशन मैनेज करने के लिए, application(_:didReceiveRemoteNotification:fetchCompletionHandler:): वाले तरीके में Auth के canHandleNotification(_:) तरीके को कॉल करके, Firebase से पुष्टि होने से जुड़ी सूचनाएं देखें.

Swift

func application(_ application: UIApplication,
    didReceiveRemoteNotification notification: [AnyHashable : Any],
    fetchCompletionHandler completionHandler: @escaping (UIBackgroundFetchResult) -> Void) {
  if Auth.auth().canHandleNotification(notification) {
    completionHandler(.noData)
    return
  }
  // This notification is not auth related; it should be handled separately.
}

Objective-C

- (void)application:(UIApplication *)application
    didReceiveRemoteNotification:(NSDictionary *)notification
          fetchCompletionHandler:(void (^)(UIBackgroundFetchResult))completionHandler {
  // Pass notification to auth and check if they can handle it.
  if ([[FIRAuth auth] canHandleNotification:notification]) {
    completionHandler(UIBackgroundFetchResultNoData);
    return;
  }
  // This notification is not auth related; it should be handled separately.
}

कस्टम स्कीम के रीडायरेक्ट यूआरएल को मैनेज करने के लिए, application(_:open:options:) तरीका लागू करें. इसके बाद, उसमें Auth के canHandleURL(_:) वाले तरीके को यूआरएल पास करें.

Swift

func application(_ application: UIApplication, open url: URL,
    options: [UIApplicationOpenURLOptionsKey : Any]) -> Bool {
  if Auth.auth().canHandle(url) {
    return true
  }
  // URL not auth related; it should be handled separately.
}

Objective-C

- (BOOL)application:(UIApplication *)app
            openURL:(NSURL *)url
            options:(NSDictionary<UIApplicationOpenURLOptionsKey, id> *)options {
  if ([[FIRAuth auth] canHandleURL:url]) {
    return YES;
  }
  // URL not auth related; it should be handled separately.
}

अगर आपने SwiftUI या UISceneDelegate का इस्तेमाल किया है, तो रीडायरेक्ट यूआरएल को हैंडल करने के लिए, scene(_:openURLContexts:) वाला तरीका लागू करें. इसके बाद, उनमें यूआरएल को Auth के canHandleURL(_:) वाले तरीके को पास करें.

Swift

func scene(_ scene: UIScene, openURLContexts URLContexts: Set<UIOpenURLContext>) {
  for urlContext in URLContexts {
      let url = urlContext.url
      Auth.auth().canHandle(url)
  }
  // URL not auth related; it should be handled separately.
}

Objective-C

- (void)scene:(UIScene *)scene openURLContexts:(NSSet<UIOpenURLContext *> *)URLContexts {
  for (UIOpenURLContext *urlContext in URLContexts) {
    [FIRAuth.auth canHandleURL:urlContext.url];
    // URL not auth related; it should be handled separately.
  }
}

अगले चरण

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

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

  • अपने Firebase रीयल टाइम डेटाबेस और 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;
}

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