Apple प्लैटफ़ॉर्म पर, डीबग की सेवा देने वाली कंपनी के साथ ऐप्लिकेशन की जांच करने की सुविधा का इस्तेमाल करना

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

में तुरंत मिटा दें.

सिम्युलेटर में डीबग प्रोवाइडर का इस्तेमाल करना

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

1. अपने डीबग बिल्ड में, Firebase की किसी भी बैकएंड सेवा का इस्तेमाल करने से पहले, App Check डीबग प्रोवाइडर फ़ैक्ट्री बनाएं और सेट करें:

   Swift

   let providerFactory = AppCheckDebugProviderFactory()
   AppCheck.setAppCheckProviderFactory(providerFactory)
   
   FirebaseApp.configure()

   Objective-C

   FIRAppCheckDebugProviderFactory *providerFactory =
         [[FIRAppCheckDebugProviderFactory alloc] init];
   [FIRAppCheck setAppCheckProviderFactory:providerFactory];
   
   // Use Firebase library to configure APIs
   [FIRApp configure];

2. अपना डीबग टोकन पाएं:

   1. सिम्युलेटर या अपने टेस्ट के लिए डिवाइस पर, अपना ऐप्लिकेशन लॉन्च करें.

   2. Xcode कंसोल खोलें और App Check डीबग टोकन ढूंढें. उदाहरण के लिए:

      <Warning> [AppCheckCore][I-GAC004001] App Check debug token: '123a4567-b89c-12d3-e456-789012345678'.
      

   3. टोकन कॉपी करें. उदाहरण के लिए, 123a4567-b89c-12d3-e456-789012345678.

3. App Check के साथ अपना डीबग टोकन रजिस्टर करें:

   1. Firebase कंसोल में, सुरक्षा > App Check > ऐप्लिकेशन टैब पर जाएं.

   2. अपना ऐप्लिकेशन ढूंढें, तीन बिंदु वाले ओवरफ़्लो मेन्यू (more_vert) पर क्लिक करें. इसके बाद, डीबग टोकन मैनेज करें को चुनें.

   3. अपना डीबग टोकन रजिस्टर करने के लिए, स्क्रीन पर दिए गए निर्देशों का पालन करें.

   

App Check के साथ टोकन रजिस्टर करने के बाद, आपकी बैकएंड सेवाएं इसे मान्य मानेंगी.

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

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

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

1. Firebase कंसोल में, डीबग टोकन बनाएं:

   1. Firebase कंसोल में, सुरक्षा > App Check > ऐप्लिकेशन टैब पर जाएं.

   2. अपना ऐप्लिकेशन ढूंढें, तीन बिंदु वाले ओवरफ़्लो मेन्यू (more_vert) पर क्लिक करें. इसके बाद, डीबग टोकन मैनेज करें को चुनें.

   3. नया डीबग टोकन बनाने के लिए, स्क्रीन पर दिए गए निर्देशों का पालन करें.

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

   

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

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

4. Xcode में, अपने टेस्टिंग स्कीम में AppCheckDebugToken नाम से एक एनवायरमेंट वैरिएबल जोड़ें. साथ ही, वैल्यू के तौर पर $(APP_CHECK_DEBUG_TOKEN) जैसा कुछ जोड़ें.

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

   xcodebuild test -scheme YOUR_TEST_SCHEME -workspace YOUR_PROJECT.xcworkspace \
   APP_CHECK_DEBUG_TOKEN=$(APP_CHECK_DEBUG_TOKEN_FROM_CI)

6. अपने डीबग बिल्ड में, Firebase की किसी भी बैकएंड सेवा का इस्तेमाल करने से पहले, App Check डीबग प्रोवाइडर फ़ैक्ट्री बनाएं और सेट करें:

   Swift

   let providerFactory = AppCheckDebugProviderFactory()
   AppCheck.setAppCheckProviderFactory(providerFactory)
   
   FirebaseApp.configure()

   Objective-C

   FIRAppCheckDebugProviderFactory *providerFactory =
         [[FIRAppCheckDebugProviderFactory alloc] init];
   [FIRAppCheck setAppCheckProviderFactory:providerFactory];
   
   // Use Firebase library to configure APIs
   [FIRApp configure];

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