Apple प्लैटफ़ॉर्म पर, पसंद के मुताबिक बनाई गई सेवा देने वाली कंपनी की मदद से, App Check का इस्तेमाल शुरू करें

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

अगर आपको App Check के साथ, पहले से मौजूद प्रोवाइडर का इस्तेमाल करना है, तो App Check के साथ App Attest और App Check के साथ DeviceCheck के दस्तावेज़ देखें.

शुरू करने से पहले

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

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

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

2. App Check प्रोटोकॉल लागू करना

सबसे पहले, आपको ऐसी क्लास बनानी होंगी जो AppCheckProvider और AppCheckProviderFactory प्रोटोकॉल लागू करती हैं.

आपकी AppCheckProvider क्लास में getToken(completion:) तरीका होना चाहिए. यह तरीका, App Check के लिए बने आपके कस्टम प्रोवाइडर को पुष्टि के सबूत के तौर पर ज़रूरी जानकारी इकट्ठा करता है. इसके बाद, यह जानकारी, App Check टोकन के बदले में, टोकन पाने की आपकी सेवा को भेजता है. SDK, टोकन को कैश मेमोरी में सेव करने की सुविधा को मैनेज करता है. इसलिए, के अपने लागू करने के तरीके में हमेशा नया टोकन पाएं.App CheckgetToken(completion:)

Swift

class YourCustomAppCheckProvider: NSObject, AppCheckProvider {
  var app: FirebaseApp

  init(withFirebaseApp app: FirebaseApp) {
    self.app = app
    super.init()
  }

  func getToken() async throws -> AppCheckToken {
    let getTokenTask = Task { () -> AppCheckToken in
      // ...

      // Create AppCheckToken object.
      let exp = Date(timeIntervalSince1970: expirationFromServer)
      let token = AppCheckToken(
        token: tokenFromServer,
        expirationDate: exp
      )

      if Date() > exp {
        throw NSError(domain: "ExampleError", code: 1, userInfo: nil)
      }

      return token
    }

    return try await getTokenTask.value
  }

}

Objective-C

@interface YourCustomAppCheckProvider : NSObject <FIRAppCheckProvider>

@property FIRApp *app;

- (id)initWithApp:(FIRApp *)app;

@end

@implementation YourCustomAppCheckProvider

- (id)initWithApp:app {
    self = [super init];
    if (self) {
        self.app = app;
    }
    return self;
}

- (void)getTokenWithCompletion:(nonnull void (^)(FIRAppCheckToken * _Nullable,
                                                 NSError * _Nullable))handler {
    dispatch_async(dispatch_get_main_queue(), ^{
        // Logic to exchange proof of authenticity for an App Check token.
        // ...

        // Create FIRAppCheckToken object.
        NSTimeInterval exp = expirationFromServer;
        FIRAppCheckToken *token
            = [[FIRAppCheckToken alloc] initWithToken:tokenFromServer
                                       expirationDate:[NSDate dateWithTimeIntervalSince1970:exp]];

        // Pass the token or error to the completion handler.
        handler(token, nil);
    });
}

@end

इसके अलावा, AppCheckProviderFactory क्लास लागू करें. यह क्लास, आपके AppCheckProvider लागू करने के तरीके के इंस्टेंस बनाती है:

Swift

class YourCustomAppCheckProviderFactory: NSObject, AppCheckProviderFactory {
  func createProvider(with app: FirebaseApp) -> AppCheckProvider? {
    return YourCustomAppCheckProvider(withFirebaseApp: app)
  }
}

Objective-C

@interface YourCustomAppCheckProviderFactory : NSObject <FIRAppCheckProviderFactory>
@end

@implementation YourCustomAppCheckProviderFactory

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

@end

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

अपने ऐप्लिकेशन के डेलिगेट या ऐप्लिकेशन के इनिशियलाइज़र में, शुरू करने के लिए यह कोड जोड़ें:

Swift

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

FirebaseApp.configure()

Objective-C

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

[FIRApp configure];

अगले चरण

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

अपडेट किया गया क्लाइंट ऐप्लिकेशन, Firebase को किए जाने वाले हर अनुरोध के साथ App Check टोकन भेजने लगेगा. हालांकि, Firebase प्रॉडक्ट के लिए, टोकन तब तक मान्य नहीं होंगे जब तक कि Firebase कंसोल के App Check सेक्शन में, लागू करने की सुविधा चालू नहीं की जाती.

मेट्रिक मॉनिटर करना और लागू करने की सुविधा चालू करना

हालांकि, लागू करने की सुविधा चालू करने से पहले, आपको यह पक्का करना चाहिए कि ऐसा करने से, आपके मौजूदा असली उपयोगकर्ताओं पर कोई असर न पड़े. दूसरी ओर, अगर आपको अपने ऐप्लिकेशन के संसाधनों के संदिग्ध इस्तेमाल का पता चलता है, तो आपको लागू करने की सुविधा जल्द ही चालू करनी चाहिए.

यह फ़ैसला लेने में मदद पाने के लिए, उन सेवाओं के लिए App Check मेट्रिक देखें जिनका इस्तेमाल किया जाता है:

लागू करने की सुविधा चालू करनाApp Check

जब आपको यह समझ आ जाए कि App Check से आपके उपयोगकर्ताओं पर क्या असर पड़ेगा और आप आगे बढ़ने के लिए तैयार हों, तब App Check को लागू करने की सुविधा चालू की जा सकती है:

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

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

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