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. अगर आपने पहले से ही A/B टेस्टिंग नहीं बनाई है, तो अपने Apple प्रोजेक्ट में Firebase जोड़ें.

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

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

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

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

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

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

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

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

3. Firebase कंसोल में, सुरक्षा > App Check पर जाएं.

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

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

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

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

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

6. ज़रूरी नहीं: बेहतर सेटिंग कॉन्फ़िगर करें.

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

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

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

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

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

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

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

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

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

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

   1. File > Add Packages पर जाएं.

   2. प्रॉम्प्ट मिलने पर, Firebase Apple प्लैटफ़ॉर्म SDK टूल की रिपॉज़िटरी जोड़ें:

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

   3. SDK टूल का सबसे नया वर्शन (v12.17.0 या इसके बाद का वर्शन) चुनें.

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

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

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

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

   1. File > Add Packages पर वापस जाएं

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

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

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

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

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

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

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

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

FirebaseApp.configure()

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

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

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

मेट्रिक मॉनिटर करना

नीति उल्लंघन ठीक करने का तरीका चालू करने से पहले, पक्का करें कि ऐसा करने से आपके मौजूदा उपयोगकर्ताओं को कोई परेशानी न हो. हालांकि, अगर आपको अपने ऐप्लिकेशन के संसाधनों का संदिग्ध इस्तेमाल दिख रहा है, तो हो सकता है कि आप नीति उल्लंघन ठीक करने के तरीके को जल्द से जल्द चालू करना चाहें.

इस बारे में फ़ैसला लेने के लिए, इस्तेमाल की जा रही सेवाओं की App Check मेट्रिक देखें:

• Firebase AI Logic, SQL Connect, Realtime Database, Cloud Firestore, Cloud Storage, Authentication, iOS के लिए Google Identity, Maps JavaScript API, और Places API (नया) के लिए, App Check के अनुरोध की मेट्रिक मॉनिटर करें.
• Cloud Functions के लिए, App Check के अनुरोध की मेट्रिक मॉनिटर करें.

App Check नीति उल्लंघन ठीक करने का तरीका चालू करें

जब आपको यह समझ आ जाए कि App Check से आपके उपयोगकर्ताओं पर क्या असर पड़ेगा और आप आगे बढ़ने के लिए तैयार हों, तो App Check को लागू किया जा सकता है:

• Firebase AI Logic, SQL Connect, Realtime Database, Cloud Firestore, Cloud Storage, Authentication, iOS के लिए Google Identity, Maps JavaScript API, और Places API (नया) के लिए, App Check को लागू करने की सुविधा चालू करें.
• Cloud Functions के लिए, App Check को लागू करने की सुविधा चालू करें.

डीबग एनवायरमेंट में App Check का इस्तेमाल करना

App Check कुछ एनवायरमेंट को अमान्य के तौर पर क्लासिफ़ाई करता है. जैसे, डेवलपमेंट के दौरान या लगातार इंटिग्रेशन (सीआई) एनवायरमेंट से, एम्युलेटर / सिम्युलेटर से मिले अनुरोध.

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

ज़्यादा जानकारी के लिए, Apple प्लैटफ़ॉर्म पर डीबग प्रोवाइडर के साथ App Check का इस्तेमाल करना लेख पढ़ें.

कीमत

जब भी आपका ऐप्लिकेशन अपने App Check टोकन को रीफ़्रेश करता है, तब App Check आपकी ओर से एक आकलन बनाता है. इससे उपयोगकर्ता के रिस्पॉन्स टोकन की पुष्टि की जाती है. बिना किसी शुल्क के मिलने वाले कोटा से ज़्यादा आकलन करने पर, आपके Firebase प्रोजेक्ट से शुल्क लिया जाएगा. ज़्यादा जानकारी के लिए, reCAPTCHA की कीमत देखें.

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