Apple प्लैटफ़ॉर्म पर, reCAPTCHA Enterprise के साथ App Check का इस्तेमाल शुरू करना

इस पेज पर, reCAPTCHA Enterprise प्रोवाइडर का इस्तेमाल करके, Apple प्लैटफ़ॉर्म के किसी ऐप्लिकेशन में App Check सेट अप करने का तरीका बताया गया है. App Check यह पक्का करने में मदद करता है कि आपके प्रोजेक्ट के बैकएंड संसाधनों को सिर्फ़ आपका ऐप्लिकेशन ऐक्सेस कर सकता है. ज़्यादा जानने के लिए, App Check की खास जानकारी देखें.

App Check के लिए, स्कोर के आधार पर reCAPTCHA कुंजियों का इस्तेमाल करना ज़रूरी है. इससे यह उपयोगकर्ताओं को नहीं दिखता. इसका मतलब है कि reCAPTCHA Enterpriseप्रदाता को किसी भी समय उपयोगकर्ताओं से चुनौती हल करने के लिए नहीं कहना पड़ेगा.

अगर इस्तेमाल के आपके उदाहरण के लिए, reCAPTCHA Enterprise की ऐसी सुविधाओं की ज़रूरत है जिन्हें App Check ने लागू नहीं किया है या अगर आपको App Check का इस्तेमाल अपने कस्टम प्रोवाइडर के साथ करना है, तो कस्टम App Check प्रोवाइडर लागू करना लेख पढ़ें.

1. Firebase प्रोजेक्ट सेट अप करना

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

2. Google Cloud कंसोल में, धोखाधड़ी से बचाव पेज पर जाएं. इसके बाद, reCAPTCHA Enterprise प्रोवाइडर के लिए यह तरीका अपनाएं:

   1. पक्का करें कि आपने सही प्रोजेक्ट चुना हो. इसके लिए, स्क्रीन पर सबसे ऊपर मौजूद प्रोजेक्ट चुनने वाले टूल को देखें.

   2. अगर कहा जाए, तो reCAPTCHA Enterprise API चालू करें.

   3. iOS टाइप का पासकोड बनाएं और अपने ऐप्लिकेशन का बंडल आईडी डालें. उदाहरण के लिए, com.example.my_app.

      • पक्का करें कि आपने वही बंडल आईडी डाला हो जो आपने Firebase प्रोजेक्ट में Firebase Apple ऐप्लिकेशन बनाते समय दिया था. बंडल आईडी की वैल्यू केस-सेंसिटिव होती है.

      • App Check के लिए, हर बंडल आईडी सिर्फ़ एक reCAPTCHA कुंजी से जुड़ा हो सकता है.

      ज़्यादा जानकारी के लिए, स्कोर के आधार पर reCAPTCHA कुंजियां बनाना लेख पढ़ें.

   4. इस कुंजी को नोट कर लें. आपको इसे Firebase कंसोल में रजिस्ट्रेशन फ़्लो में जोड़ना होगा.

3. Firebase console में, Security > App Check पर जाएं.

4. ऐप्लिकेशन टैब में जाकर, Apple प्लैटफ़ॉर्म पर मौजूद ऐप्लिकेशन रजिस्टर करें, ताकि उन्हें reCAPTCHA Enterprise की सेवा देने वाली कंपनी के साथ App Check इस्तेमाल किया जा सके. आपको Google Cloud कंसोल में मिला कोड डालना होगा.

5. ज़रूरी नहीं: टोकन का टाइम टू लिव (टीटीएल) सेट करें.

   ऐप्लिकेशन रजिस्ट्रेशन सेटिंग में जाकर, App Check टोकन के लिए कस्टम टाइम टू लिव (टीटीएल) सेट करें. टीटीएल को 30 मिनट से लेकर सात दिनों के बीच की किसी भी वैल्यू पर सेट किया जा सकता है. इस वैल्यू को बदलते समय, इन बातों का ध्यान रखें:

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

   ज़्यादातर ऐप्लिकेशन के लिए, डिफ़ॉल्ट टीटीएल एक घंटा होता है. ध्यान दें कि App Check लाइब्रेरी, टीटीएल की अवधि के आधे समय में टोकन रीफ़्रेश करती है.

6. ज़रूरी नहीं: ऐडवांस सेटिंग कॉन्फ़िगर करें.

7. सेव करें पर क्लिक करें.

(ज़रूरी नहीं) ऐडवांस सेटिंग कॉन्फ़िगर करना

जब कोई उपयोगकर्ता आपका ऐप्लिकेशन खोलता है, तो reCAPTCHA Enterprise, मुख्य जोखिमों के आधार पर उपयोगकर्ता के इंटरैक्शन के जोखिम के लेवल का आकलन करता है. इसके बाद, 0.0 से 1.0 के बीच का स्कोर दिखाता है. यह स्कोर 0.1 के अंतर से बढ़ता है.

• 0.0 स्कोर का मतलब है कि इंटरैक्शन से ज़्यादा जोखिम है और यह धोखाधड़ी वाला हो सकता है.
• स्कोर 1.0 का मतलब है कि इंटरैक्शन में जोखिम कम है और यह सही है.

App Check की मदद से, ऐप्लिकेशन के जोखिम का थ्रेशोल्ड कॉन्फ़िगर किया जा सकता है. इससे, इस जोखिम को लेकर अपनी जोखिम उठाने की क्षमता को अडजस्ट किया जा सकता है.

ज़्यादातर इस्तेमाल के उदाहरणों के लिए, थ्रेशोल्ड की डिफ़ॉल्ट वैल्यू 0.5 का इस्तेमाल करने का सुझाव दिया जाता है. अगर आपको इस्तेमाल के उदाहरण के हिसाब से इस वैल्यू में बदलाव करना है, तो Firebase Console में जाकर, अपने हर ऐप्लिकेशन के लिए इस वैल्यू को कॉन्फ़िगर किया जा सकता है. इसके लिए, सुरक्षा > App Check पर जाएं. यहां दिए गए ऐप्लिकेशन के जोखिम थ्रेशोल्ड को कॉन्फ़िगर करने से जुड़ी कुछ ज़रूरी बातों को ध्यान से पढ़ें.

2. अपने ऐप्लिकेशन में App Check SDK जोड़ना

Firebase डिपेंडेंसी को इंस्टॉल और मैनेज करने के लिए, Swift Package Manager (SPM) का इस्तेमाल करें. अगर पहले से Firebase का इस्तेमाल किया जा रहा है, तो पक्का करें कि आपका Firebase पैकेज v12.17.0 या इसके बाद का वर्शन हो.

1. Xcode में, अपना ऐप्लिकेशन प्रोजेक्ट खोलें.

2. Firebase लाइब्रेरी जोड़ें:

   1. फ़ाइल > पैकेज जोड़ें पर जाएं.

   2. जब आपसे कहा जाए, तब Firebase Apple प्लैटफ़ॉर्म SDK टूल की रिपॉज़िटरी जोड़ें:

      https://github.com/firebase/firebase-ios-sdk
      

   3. एसडीके टूल का नया वर्शन (12.17.0 या इसके बाद का वर्शन) चुनें.

   4. FirebaseAppCheck लाइब्रेरी चुनें.

   5. Add Package पर क्लिक करें. Xcode, डिपेंडेंसी से जुड़ी समस्या को हल करेगा और उन्हें डाउनलोड करेगा.

   6. जब आपसे कहा जाए, तब लाइब्रेरी को अपने ऐप्लिकेशन टारगेट में जोड़ें.

3. reCAPTCHA Enterprise लाइब्रेरी जोड़ें:

   1. फ़ाइल > पैकेज जोड़ें पर वापस जाएं

   2. जब कहा जाए, तब reCAPTCHA Enterprise SDK रिपॉज़िटरी जोड़ें:

      https://github.com/GoogleCloudPlatform/recaptcha-enterprise-mobile-sdk
      

   3. RecaptchaEnterprise लाइब्रेरी चुनें.

   4. Add Package पर क्लिक करें. जब आपसे कहा जाए, तब लाइब्रेरी को अपने ऐप्लिकेशन के टारगेट में जोड़ें.

3. App Check शुरू करें

अपने ऐप्लिकेशन में, आपको अन्य Firebase सेवाओं का इस्तेमाल करने से पहले App Check को शुरू करना होगा.

अपनी reCAPTCHA कुंजी पास करके, RecaptchaProviderFactory का एक इंस्टेंस बनाएं. इसके बाद, इसका इस्तेमाल करने के लिए App Check को कॉन्फ़िगर करें:

let providerFactory = RecaptchaProviderFactory(siteKey: "SITE_KEY")
AppCheck.setAppCheckProviderFactory(providerFactory)

FirebaseApp.configure()

4. मेट्रिक मॉनिटर करना और उल्लंघन ठीक करने के तरीके लागू करना

अपने ऐप्लिकेशन में App Check सेट अप करने के बाद, अपडेट किए गए ऐप्लिकेशन को उपयोगकर्ताओं के लिए रिलीज़ करें.

अपडेट किया गया क्लाइंट ऐप्लिकेशन, Firebase को की जाने वाली हर रिक्वेस्ट के साथ App Check टोकन भेजेगा. हालांकि, App Check लागू होने तक, App Check अमान्य टोकन वाले अनुरोधों को ब्लॉक नहीं करेगा.