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

इस पेज पर, Apple प्लैटफ़ॉर्म पर बने किसी ऐप्लिकेशन में, App Check सेट अप करने का तरीका बताया गया है, reCAPTCHA Enterprise की सुविधा का इस्तेमाल करके. 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 console में, Fraud Defense पेज पर जाएं. इसके बाद, reCAPTCHA Enterprise की सुविधा का इस्तेमाल करने के लिए, यह काम करें:

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

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

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

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

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

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

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

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

4. ऐप्लिकेशन टैब में, Apple प्लैटफ़ॉर्म पर बने अपने ऐप्लिकेशन रजिस्टर करें, ताकि वे App Check की सुविधा का इस्तेमाल करके, reCAPTCHA Enterprise की सुविधा का इस्तेमाल कर सकें. इसके लिए, आपको वह कुंजी डालनी होगी जो आपको 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 (एसपीएम) का इस्तेमाल करें. अगर पहले से ही Firebase का इस्तेमाल किया जा रहा है, तो पक्का करें कि आपका Firebase पैकेज, v12.17.0 या इसके बाद का वर्शन हो.

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

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

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

   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. फ़ाइल > पैकेज जोड़ें पर वापस जाएं

   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 मेट्रिक देखी जा सकती हैं:

• के लिए, 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 को लागू करने की सुविधा चालू की जा सकती है:

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

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

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

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

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

कीमत

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

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