Apple प्लैटफ़ॉर्म पर, App Attest की मदद से App Check का इस्तेमाल शुरू करें

इस पेज पर, Apple ऐप्लिकेशन में App Check को चालू करने का तरीका बताया गया है. इसके लिए, पहले से मौजूद App Attest की सेवा देने वाली कंपनी का इस्तेमाल किया जाता है. App Check को चालू करने पर, यह पक्का किया जा सकता है कि सिर्फ़ आपका ऐप्लिकेशन ही आपके प्रोजेक्ट के Firebase संसाधनों को ऐक्सेस कर पाए. इस सुविधा के बारे में खास जानकारी देखें.

App Check, App Attest का इस्तेमाल करता है, ताकि यह पुष्टि की जा सके कि Firebase की सेवाओं के लिए किए गए अनुरोध, आपके असली ऐप्लिकेशन से आ रहे हैं. फ़िलहाल, App Check धोखाधड़ी के जोखिम का विश्लेषण करने के लिए, App Attest का इस्तेमाल नहीं करता है.

अगर आपको अपनी पसंद के मुताबिक सेवा देने वाली कंपनी के साथ App Check का इस्तेमाल करना है, तो पसंद के मुताबिक App Check सेवा देने वाली कंपनी को लागू करें देखें.

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

1. App Attest का इस्तेमाल करने के लिए, आपके पास Xcode 12.5 या इसके बाद का वर्शन होना चाहिए.

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

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

4. ऐप्लिकेशन टैब में, अपने ऐप्लिकेशन रजिस्टर करें, ताकि App Attest की सेवा देने वाली कंपनी के साथ App Check का इस्तेमाल किया जा सके.

   आम तौर पर, आपको अपने प्रोजेक्ट के सभी ऐप्लिकेशन रजिस्टर करने होंगे. ऐसा इसलिए, क्योंकि किसी Firebase प्रॉडक्ट के लिए नीति उल्लंघन ठीक करने का तरीका चालू करने के बाद, सिर्फ़ रजिस्टर किए गए ऐप्लिकेशन ही उस प्रॉडक्ट के बैकएंड संसाधनों को ऐक्सेस कर पाएंगे.

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

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

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

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

2. अपने ऐप्लिकेशन में App Check लाइब्रेरी जोड़ना

1. Firebase डिपेंडेंसी इंस्टॉल और मैनेज करने के लिए, Swift Package Manager का इस्तेमाल करें.

   Xcode में, अपने ऐप्लिकेशन प्रोजेक्ट को खोलें. इसके बाद, File > Add Packages पर जाएं. Firebase Apple प्लैटफ़ॉर्म SDK टूल रिपॉज़िटरी (https://github.com/firebase/firebase-ios-sdk) जोड़ें. इसके बाद, FirebaseAppCheck लाइब्रेरी चुनें.

2. Xcode में, अपने ऐप्लिकेशन में App Attest सुविधा जोड़ें.

3. अपने प्रोजेक्ट की .entitlements फ़ाइल में, App Attest एनवायरमेंट को production पर सेट करें.

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

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

सबसे पहले, AppCheckProviderFactory का इंप्लिमेंटेशन लिखें. लागू करने का तरीका, आपके इस्तेमाल के उदाहरण पर निर्भर करेगा.

उदाहरण के लिए, अगर आपके पास सिर्फ़ iOS 14 और उसके बाद के वर्शन वाले उपयोगकर्ता हैं, तो हमेशा AppAttestProvider ऑब्जेक्ट बनाए जा सकते हैं:

class YourSimpleAppCheckProviderFactory: NSObject, AppCheckProviderFactory {
  func createProvider(with app: FirebaseApp) -> AppCheckProvider? {
    return AppAttestProvider(app: app)
  }
}

@interface YourSimpleAppCheckProviderFactory : NSObject <FIRAppCheckProviderFactory>
@end

@implementation YourSimpleAppCheckProviderFactory

- (nullable id<FIRAppCheckProvider>)createProviderWithApp:(nonnull FIRApp *)app {
  return [[FIRAppAttestProvider alloc] initWithApp:app];
}

@end

इसके अलावा, iOS 14 और इसके बाद के वर्शन पर AppAttestProvider ऑब्जेक्ट बनाए जा सकते हैं. साथ ही, पिछले वर्शन पर DeviceCheckProvider का इस्तेमाल किया जा सकता है:

class YourAppCheckProviderFactory: NSObject, AppCheckProviderFactory {
  func createProvider(with app: FirebaseApp) -> AppCheckProvider? {
    if #available(iOS 14.0, *) {
      return AppAttestProvider(app: app)
    } else {
      return DeviceCheckProvider(app: app)
    }
  }
}

@interface YourAppCheckProviderFactory : NSObject <FIRAppCheckProviderFactory>
@end

@implementation YourAppCheckProviderFactory

- (nullable id<FIRAppCheckProvider>)createProviderWithApp:(nonnull FIRApp *)app {
  if (@available(iOS 14.0, *)) {
    return [[FIRAppAttestProvider alloc] initWithApp:app];
  } else {
    return [[FIRDeviceCheckProvider alloc] initWithApp:app];
  }
}

@end

AppCheckProviderFactory क्लास लागू करने के बाद, इसका इस्तेमाल करने के लिए App Check को कॉन्फ़िगर करें:

let providerFactory = YourAppCheckProviderFactory()
AppCheck.setAppCheckProviderFactory(providerFactory)

FirebaseApp.configure()

YourAppCheckProviderFactory *providerFactory =
        [[YourAppCheckProviderFactory alloc] init];
[FIRAppCheck setAppCheckProviderFactory:providerFactory];

[FIRApp configure];

अगले चरण

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

अपडेट किया गया क्लाइंट ऐप्लिकेशन, Firebase को भेजे जाने वाले हर अनुरोध के साथ App Check टोकन भेजना शुरू कर देगा. हालांकि, Firebase के प्रॉडक्ट के लिए टोकन तब तक मान्य नहीं होंगे, जब तक Firebase कंसोल के 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 का इस्तेमाल करना देखें.