वेब ऐप्लिकेशन में reCAPTCHA Enterprise की मदद से, ऐप्लिकेशन जांचने की सुविधा का इस्तेमाल शुरू करें

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

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

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

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

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

2. Google Cloud console में, Fraud Defense पेज पर जाएं. इसके बाद, reCAPTCHA Enterprise प्रोवाइडर के लिए यह काम करें:

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

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

   3. वेब टाइप की कुंजी बनाएं. इसके बाद, अपने वेब ऐप्लिकेशन के लिए हर डोमेन की जानकारी दें.

      • App Check App Check, 250 से ज़्यादा डोमेन पर काम करने वाले वेब ऐप्लिकेशन के साथ नहीं काम करता है.

      • reCAPTCHA की ऐसी कुंजी में कभी भी localhost को डोमेन के तौर पर न जोड़ें जिसे reCAPTCHA प्रोडक्शन में डिप्लॉय किया गया है या डिप्लॉय किया जाना है.

      • "चेकबॉक्स वाली चुनौती का इस्तेमाल करें" विकल्प को नहीं चुना जाना चाहिए.

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

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

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

4. ऐप्लिकेशन टैब में, App Check का इस्तेमाल करने के लिए, अपने वेब ऐप्लिकेशन रजिस्टर करें reCAPTCHA Enterprise प्रोवाइडर के साथ. आपको वह कुंजी देनी होगी जो आपको Google Cloud console में मिली है.

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 लाइब्रेरी जोड़ना

अगर आपने अब तक ऐसा नहीं किया है, तो Firebase JavaScript SDK इंस्टॉल करें और अपने ऐप्लिकेशन में Firebase शुरू करें.

3. App Check शुरू करना

अपने ऐप्लिकेशन में, यह App Check कोड, सबसे पहले जोड़ें. इससे, आपके ऐप्लिकेशन में Firebase की किसी भी सेवा को ऐक्सेस करने से पहले, यह कोड चलेगा.

पक्का करें कि आपने वही reCAPTCHA कुंजी पास की हो जिसका इस्तेमाल अपने ऐप्लिकेशन को reCAPTCHA Enterprise के साथ रजिस्टर करने के लिए किया था. इसके लिए, Firebase console में गाइड का पहला सेक्शन देखें.

import { initializeApp } from "firebase/app";
import { initializeAppCheck, ReCaptchaEnterpriseProvider } from "firebase/app-check";

const app = initializeApp({
  // Your Firebase configuration object.
});

// Create a ReCaptchaEnterpriseProvider instance
// using your reCAPTCHA Enterprise key and pass it to `initializeAppCheck()`.
const appCheck = initializeAppCheck(app, {
  provider: new ReCaptchaEnterpriseProvider(RECAPTCHA_KEY),
  isTokenAutoRefreshEnabled: true // Set to true to allow auto-refresh.
});

firebase.initializeApp({
  // Your Firebase configuration object.
});

// Create a ReCaptchaEnterpriseProvider instance
// using your reCAPTCHA Enterprise key and pass it to `activate()`.
const appCheck = firebase.appCheck();
appCheck.activate(
  new firebase.appCheck.ReCaptchaEnterpriseProvider(
    RECAPTCHA_KEY
  ),
  true // Set to true to allow auto-refresh.
);

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 कुछ एनवायरमेंट को अमान्य के तौर पर क्लासिफ़ाई करता है. जैसे, डेवलपमेंट के दौरान localhost से किए गए अनुरोध या लगातार इंटिग्रेशन (सीआई) एनवायरमेंट से किए गए अनुरोध.

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

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

कीमत

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

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