ऐप्पल प्लेटफ़ॉर्म पर कस्टम प्रदाता के साथ ऐप चेक का उपयोग करना प्रारंभ करें, ऐप्पल प्लेटफ़ॉर्म पर कस्टम प्रदाता के साथ ऐप चेक का उपयोग करना प्रारंभ करें

यह पृष्ठ आपको दिखाता है कि अपने कस्टम ऐप चेक प्रदाता का उपयोग करके ऐप्पल ऐप में ऐप चेक कैसे सक्षम करें। जब आप ऐप चेक सक्षम करते हैं, तो आप यह सुनिश्चित करने में सहायता करते हैं कि केवल आपका ऐप ही आपके प्रोजेक्ट के फायरबेस संसाधनों तक पहुंच सकता है।

यदि आप बिल्ट-इन प्रदाताओं के साथ ऐप चेक का उपयोग करना चाहते हैं, तो ऐप चेक विद ऐप अटेस्ट और ऐप चेक विथ डिवाइसचेक के लिए डॉक्स देखें।

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

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

• अपने कस्टम ऐप चेक प्रदाता के सर्वर-साइड लॉजिक को लागू करें ।

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

1. अपने प्रोजेक्ट के Podfile में ऐप चेक के लिए निर्भरता जोड़ें:

   pod 'FirebaseAppCheck'

   या, वैकल्पिक रूप से, आप इसके बजाय स्विफ्ट पैकेज मैनेजर का उपयोग कर सकते हैं।

   साथ ही, सुनिश्चित करें कि आप किसी भी फायरबेस सेवा क्लाइंट लाइब्रेरी के नवीनतम संस्करण का उपयोग कर रहे हैं, जिस पर आप निर्भर हैं।

2. pod install चलाएँ और बनाई गई .xcworkspace फ़ाइल खोलें।

2. ऐप चेक प्रोटोकॉल लागू करें

सबसे पहले, आपको AppCheckProvider और AppCheckProviderFactory प्रोटोकॉल को लागू करने वाली कक्षाएं बनाने की आवश्यकता है।

आपके AppCheckProvider क्लास में एक getToken(completion:) मेथड होना चाहिए, जो प्रामाणिकता के प्रमाण के रूप में आपके कस्टम ऐप चेक प्रदाता को जो भी जानकारी चाहिए, उसे एकत्र करता है, और ऐप चेक टोकन के बदले में इसे आपकी टोकन अधिग्रहण सेवा को भेजता है। ऐप चेक एसडीके टोकन कैशिंग को संभालता है, इसलिए getToken(completion:) के कार्यान्वयन में हमेशा एक नया टोकन प्राप्त करें।

class YourCustomAppCheckProvider: NSObject, AppCheckProvider {
    var app: FirebaseApp

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

    func getToken(completion handler: @escaping (AppCheckToken?, Error?) -> Void) {
        DispatchQueue.main.async {
            // Logic to exchange proof of authenticity for an App Check token.
            // ...

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

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

@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 कार्यान्वयन के उदाहरण बनाता है:

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

@interface YourCustomAppCheckProviderFactory : NSObject <FIRAppCheckProviderFactory>
@end

@implementation YourCustomAppCheckProviderFactory

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

@end

3. ऐप चेक को इनिशियलाइज़ करें

अपने ऐप डेलिगेट या ऐप इनिशियलाइज़र में निम्नलिखित इनिशियलाइज़ेशन कोड जोड़ें:

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

FirebaseApp.configure()

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

[FIRApp configure];

अगले कदम

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

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

मेट्रिक्स की निगरानी करें और प्रवर्तन सक्षम करें

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

यह निर्णय लेने में सहायता के लिए, आप अपने द्वारा उपयोग की जाने वाली सेवाओं के लिए ऐप चेक मेट्रिक्स देख सकते हैं:

• रीयलटाइम डेटाबेस, क्लाउड फायरस्टोर और क्लाउड स्टोरेज के लिए मॉनिटर ऐप चेक अनुरोध मेट्रिक्स ।
• क्लाउड फ़ंक्शंस के लिए मॉनिटर ऐप चेक अनुरोध मेट्रिक्स ।

ऐप जांच प्रवर्तन सक्षम करें

जब आप समझते हैं कि ऐप चेक आपके उपयोगकर्ताओं को कैसे प्रभावित करेगा और आप आगे बढ़ने के लिए तैयार हैं, तो आप ऐप चेक प्रवर्तन सक्षम कर सकते हैं:

• रीयलटाइम डेटाबेस, क्लाउड फायरस्टोर और क्लाउड स्टोरेज के लिए ऐप चेक एनफ़ोर्समेंट सक्षम करें ।
• क्लाउड फ़ंक्शंस के लिए ऐप चेक प्रवर्तन सक्षम करें ।

डिबग वातावरण में ऐप चेक का उपयोग करें

यदि, ऐप चेक के लिए अपना ऐप पंजीकृत करने के बाद, आप अपने ऐप को ऐसे वातावरण में चलाना चाहते हैं, जो ऐप चेक सामान्य रूप से वैध के रूप में वर्गीकृत नहीं होगा, जैसे कि विकास के दौरान एक सिम्युलेटर, या एक निरंतर एकीकरण (CI) वातावरण से, आप कर सकते हैं अपने ऐप का डिबग बिल्ड बनाएं जो वास्तविक सत्यापन प्रदाता के बजाय ऐप चेक डीबग प्रदाता का उपयोग करता है।

Apple प्लेटफॉर्म पर डिबग प्रदाता के साथ ऐप चेक का उपयोग करें देखें।