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

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

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

localhost पर डीबग प्रोवाइडर का इस्तेमाल करना

localhost से अपने ऐप्लिकेशन को चलाते समय, डीबग प्रोवाइडर का इस्तेमाल करने के लिए (उदाहरण के लिए, डेवलपमेंट के दौरान), यह तरीका अपनाएं:

चेतावनी: reCAPTCHA के अनुमति वाले डोमेन में localhost जोड़कर, localhost डीबग करने की सुविधा को चालू न करें. ऐसा करने पर, कोई भी व्यक्ति अपनी लोकल मशीन से आपका ऐप्लिकेशन चला सकता है!

1. अपने डीबग बिल्ड में, App Check को शुरू करने से पहले, self.FIREBASE_APPCHECK_DEBUG_TOKEN को true पर सेट करके डीबग मोड चालू करें. उदाहरण के लिए:

   Web

   self.FIREBASE_APPCHECK_DEBUG_TOKEN = true;
   initializeAppCheck(app, { /* App Check options */ });
   

   Web

   self.FIREBASE_APPCHECK_DEBUG_TOKEN = true;
   firebase.appCheck().activate(/* site key or provider */);
   

   ध्यान दें: Firebase वेब SDK टूल के v9 से पहले के वर्शन में, self.FIREBASE_APPCHECK_DEBUG_TOKEN को इंपोर्ट के समय पढ़ा जाता है, न कि शुरू करने/चालू करने के समय. इसके लिए, कोड बंडल लोड होने से पहले, इसे index.html में सेट करना ज़रूरी था. इस पाबंदी से बचने के लिए, वर्शन 9 पर अपग्रेड करें.

2. अपने वेब ऐप्लिकेशन पर जाएं और ब्राउज़र का डेवलपर टूल खोलें. डिबग कंसोल में, आपको एक डिबग टोकन दिखेगा:

   AppCheck debug token: "123a4567-b89c-12d3-e456-789012345678". You will
   need to safelist it in the Firebase console for it to work.

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

   

टोकन रजिस्टर करने के बाद, Firebase बैकएंड सेवाएं इसे मान्य के तौर पर स्वीकार कर लेंगी.

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

यह टोकन आपके ब्राउज़र में लोकल तौर पर सेव होता है. जब भी उसी कंप्यूटर पर उसी ब्राउज़र में ऐप्लिकेशन का इस्तेमाल किया जाएगा, तब इसका इस्तेमाल किया जाएगा. अगर आपको किसी दूसरे ब्राउज़र या किसी दूसरी मशीन पर टोकन का इस्तेमाल करना है, तो true के बजाय self.FIREBASE_APPCHECK_DEBUG_TOKEN को टोकन स्ट्रिंग पर सेट करें.

सीआई (कंट्रोल इंटिग्रेशन) एनवायरमेंट में डीबग प्रोवाइडर का इस्तेमाल करना

डीबग प्रोवाइडर को लगातार इंटिग्रेशन (सीआई) वाले एनवायरमेंट में इस्तेमाल करने के लिए, ये करें:

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

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

   

2. अपने CI सिस्टम के सुरक्षित पासकोड स्टोर में, अभी बनाया गया डीबग टोकन जोड़ें. उदाहरण के लिए, GitHub Actions का एन्क्रिप्ट किया गया पासवर्ड या Travis CI का एन्क्रिप्ट किया गया वैरिएबल.

3. अगर ज़रूरी हो, तो अपने सीआई सिस्टम को कॉन्फ़िगर करें, ताकि आपका डीबग टोकन, सीआई एनवायरमेंट में एनवायरमेंट वैरिएबल के तौर पर उपलब्ध हो. वैरिएबल को APP_CHECK_DEBUG_TOKEN_FROM_CI जैसा कोई नाम दें.

4. अपने डीबग बिल्ड में, डीबग मोड चालू करें. इसके लिए, App Check को इंपोर्ट करने से पहले, self.FIREBASE_APPCHECK_DEBUG_TOKEN को डीबग टोकन एनवायरमेंट वैरिएबल की वैल्यू पर सेट करें. उदाहरण के लिए:

   Web

   self.FIREBASE_APPCHECK_DEBUG_TOKEN = process.env.APP_CHECK_DEBUG_TOKEN_FROM_CI;
   initializeAppCheck(app, { /* App Check options */ });
   

   Web

   self.FIREBASE_APPCHECK_DEBUG_TOKEN = process.env.APP_CHECK_DEBUG_TOKEN_FROM_CI;
   firebase.appCheck().activate(/* site key or provider */);
   

जब आपका ऐप्लिकेशन किसी सीआई एनवायरमेंट में चलता है, तो Firebase की बैकएंड सेवाएं, भेजे गए टोकन को मान्य के तौर पर स्वीकार कर लेंगी.