App Check का इस्तेमाल करके, Google के बाहर मौजूद कस्टम बैकएंड संसाधनों को सुरक्षित रखा जा सकता है. जैसे, खुद होस्ट किया गया बैकएंड. इसके लिए, आपको ये दोनों काम करने होंगे:
- अपने ऐप्लिकेशन क्लाइंट में बदलाव करें, ताकि वह आपके बैकएंड को हर अनुरोध के साथ App Check टोकन भेज सके. इसके बारे में इस पेज पर बताया गया है.
- अपने बैकएंड में बदलाव करें, ताकि हर अनुरोध के साथ मान्य App Check टोकन की ज़रूरत पड़े. इसके बारे में कस्टम बैकएंड से App Check टोकन की पुष्टि करना लेख में बताया गया है.
शुरू करने से पहले
डिफ़ॉल्ट Play Integrity provider या कस्टम प्रोवाइडर का इस्तेमाल करके, अपने ऐप्लिकेशन में App Check जोड़ें.
बैकएंड अनुरोधों के साथ App Check टोकन भेजना
यह पक्का करने के लिए कि आपके बैकएंड अनुरोधों में मान्य और समयसीमा खत्म न हुआ App Check टोकन शामिल हो, हर अनुरोध को getAppCheckToken() कॉल में रैप करें. अगर ज़रूरी होगा, तो App Check लाइब्रेरी टोकन को रीफ़्रेश करेगी. साथ ही, आपको टोकन को तरीके के सफलता लिसनर में ऐक्सेस करने की अनुमति मिलेगी.
मान्य टोकन मिलने के बाद, इसे अपने बैकएंड को भेजे जाने वाले अनुरोध के साथ भेजें. इसे भेजने का तरीका आपके हिसाब से तय किया जा सकता है. हालांकि, यूआरएल के हिस्से के तौर पर App Check टोकन न भेजें. इनमें क्वेरी पैरामीटर भी शामिल हैं. ऐसा इसलिए, क्योंकि इससे टोकन के गलती से लीक होने और इंटरसेप्ट होने का खतरा बढ़ जाता है. हमारा सुझाव है कि टोकन को कस्टम एचटीटीपी हेडर में भेजें.
उदाहरण के लिए, अगर Retrofit का इस्तेमाल किया जाता है, तो:
Kotlin
class ApiWithAppCheckExample { interface YourExampleBackendService { @GET("yourExampleEndpoint") fun exampleData( @Header("X-Firebase-AppCheck") appCheckToken: String, ): Call<List<String>> } var yourExampleBackendService: YourExampleBackendService = Retrofit.Builder() .baseUrl("https://yourbackend.example.com/") .build() .create(YourExampleBackendService::class.java) fun callApiExample() { Firebase.appCheck.getAppCheckToken(false).addOnSuccessListener { appCheckToken -> val token = appCheckToken.token val apiCall = yourExampleBackendService.exampleData(token) // ... } } }
Java
public class ApiWithAppCheckExample { private interface YourExampleBackendService { @GET("yourExampleEndpoint") Call<List<String>> exampleData( @Header("X-Firebase-AppCheck") String appCheckToken); } YourExampleBackendService yourExampleBackendService = new Retrofit.Builder() .baseUrl("https://yourbackend.example.com/") .build() .create(YourExampleBackendService.class); public void callApiExample() { FirebaseAppCheck.getInstance() .getAppCheckToken(false) .addOnSuccessListener(new OnSuccessListener<AppCheckToken>() { @Override public void onSuccess(@NonNull AppCheckToken appCheckToken) { String token = appCheckToken.getToken(); Call<List<String>> apiCall = yourExampleBackendService.exampleData(token); // ... } }); } }
रीप्ले प्रोटेक्शन (बीटा वर्शन)
जिस एंडपॉइंट के लिए आपने रीप्ले सुरक्षा चालू की है उसके लिए अनुरोध करते समय, अनुरोध को getAppCheckToken() के बजाय getLimitedUseAppCheckToken() के कॉल में रैप करें:
Kotlin
Firebase.appCheck.limitedUseAppCheckToken.addOnSuccessListener { // ... }
Java
FirebaseAppCheck.getInstance() .getLimitedUseAppCheckToken().addOnSuccessListener( new OnSuccessListener<AppCheckToken>() { @Override public void onSuccess(AppCheckToken appCheckToken) { String token = appCheckToken.getToken(); // ... } } );