Firebase App Check की मदद से, Gemini API के गलत इस्तेमाल को रोकना

जब किसी एपीआई को सीधे तौर पर किसी मोबाइल या वेब ऐप्लिकेशन से कॉल किया जाता है, तो एपीआई का गलत इस्तेमाल होने का खतरा रहता है. ऐसा उन क्लाइंट की वजह से होता है जिनके पास एपीआई को ऐक्सेस करने की अनुमति नहीं होती. अगर आपको अपने मोबाइल या वेब ऐप्लिकेशन से सीधे Gemini API को कॉल करना है, तो आपको Firebase AI Logic का इस्तेमाल करके और Firebase App Check को लागू करके, इसे गलत इस्तेमाल से बचाना होगा. App Check को लागू करने पर, यह सिर्फ़ उन अनुरोधों को अनुमति देगा जिनकी पुष्टि आपके असली ऐप्लिकेशन और/या ऐसे डिवाइस से की गई है जिसमें छेड़छाड़ नहीं की गई है.

सेट अप करने के निर्देशों पर जाएं

Firebase AI Logic एक प्रॉक्सी गेटवे उपलब्ध कराता है, जो आपको Firebase App Check के साथ इंटिग्रेट करने की सुविधा देता है. साथ ही, जब आपके मोबाइल और वेब ऐप्लिकेशन से Gemini API को सीधे कॉल किया जाता है, तो यह उसे सुरक्षित रखता है. Firebase AI Logic के लिए App Check लागू होने पर, Gemini Developer API और Agent Platform Gemini API (formerly Vertex AI), दोनों को सुरक्षित रखने में मदद मिलती है.

Firebase AI Logic के लिए App Check, रीप्ले प्रोटेक्शन के साथ भी काम करता है. इसका मतलब है कि App Check टोकन का इस्तेमाल सिर्फ़ एक बार किया जा सकता है.


App Check के काम करने के तरीके की खास जानकारी

App Check की मदद से, आपके ऐप्लिकेशन को चलाने वाले डिवाइस, ऐप्लिकेशन या डिवाइस की पुष्टि करने वाली सेवा देने वाली कंपनी का इस्तेमाल करते हैं. यह कंपनी, इनमें से किसी एक या दोनों की पुष्टि करती है:

  • अनुरोध आपके असली ऐप्लिकेशन से किए गए हों
  • अनुरोध किसी असली और सुरक्षित डिवाइस से किए गए हों

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

App Check सेट अप करते समय, रीप्ले प्रोटेक्शन जोड़ने के बारे में सोचें. इससे App Check टोकन सिर्फ़ एक बार इस्तेमाल किए जा सकते हैं. इस विकल्प से, बुनियादी सुरक्षा के अलावा बेहतर सुरक्षा मिलती है. साथ ही, इससे अपने ऐप्लिकेशन और इस्तेमाल के उदाहरणों के लिए, सुरक्षा का सही लेवल सेट किया जा सकता है.

App Check के बारे में ज़्यादा जानकारी इसके दस्तावेज़ में मिल सकती है. इसमें, अटेस्टेशन की सेवा देने वाली कंपनियों के ब्यौरे के साथ-साथ, लागू होने वाले कोटा और सीमाएं भी शामिल हैं.

App Check सेट अप करें

यहां दिए गए निर्देश, Firebase AI Logic के लिए Firebase App Check नीति उल्लंघन ठीक करने का तरीका सेट अप करने के लिए ऑप्टिमाइज़ किए गए हैं.

पहला चरण: App Check को लागू करना

जुलाई 2026 की शुरुआत से, Firebase कंसोल में सेटअप करने के लिए दिए गए निर्देशों के दौरान, Firebase Firebase AI Logic के लिए Firebase App Check को अपने-आप लागू कर देता है. इससे Gemini API को सुरक्षित रखने में मदद मिलती है.

हालांकि, अगर आपने जुलाई 2026 की शुरुआत से पहले ही अपने Firebase प्रोजेक्ट में Firebase AI Logic को सेट अप कर लिया था (या किसी अन्य वजह से App Check को लागू नहीं किया गया है), तो यहां दिए गए निर्देशों का पालन करके, App Check को खुद लागू किया जा सकता है.

  1. देखें कि Firebase AI Logic के लिए, App Check पहले से लागू है या नहीं.

    1. Firebase कंसोल में, सुरक्षा > App Check > एपीआई टैब पर जाएं.

    2. Firebase AI Logic के लिए पंक्ति ढूंढें. अगर आपको Unenforced दिखता है, तो बाकी निर्देशों का पालन करें.

  2. Firebase AI Logic की लाइन पर क्लिक करें. इसके बाद, आपको मेट्रिक के ग्राफ़ दिखेंगे. उन ग्राफ़ के नीचे, सेट अप करें पर क्लिक करें.

  3. डायलॉग बॉक्स की पहली स्क्रीन (सुरक्षा का बुनियादी लेवल) में, लागू करें को चुनें. इसके बाद, जारी रखें पर क्लिक करें.

  4. अगली स्क्रीन (रीप्ले प्रोटेक्शन) में, बंद है को चुनें. इसके बाद, जारी रखें पर क्लिक करें.

  5. आखिरी स्क्रीन पर, App Check को लागू करने से जुड़ी ज़रूरी बातों की समीक्षा करें, ताकि यह पक्का किया जा सके कि आप App Check को लागू करने के लिए तैयार हैं. अगर आप तैयार हैं, तो जारी रखें पर क्लिक करें.

    अगर आपको सिर्फ़ App Check को लागू करना है और प्री-प्रोडक्शन ऐप्लिकेशन में Firebase AI Logic के साथ सिर्फ़ डीबग प्रोवाइडर का इस्तेमाल करना है, तो आपको अपने ऐप्लिकेशन रजिस्टर करने की ज़रूरत नहीं है. हालांकि, जब आप असली उपयोगकर्ताओं के लिए अपना ऐप्लिकेशन रिलीज़ करने के लिए तैयार हों, तो आपको अपने ऐप्लिकेशन रजिस्टर करने होंगे. ऐसा, प्रोडक्शन अटेस्टेशन प्रोवाइडर (जैसे, App Attest, Play Integrity या reCAPTCHA Enterprise) को सेट अप करने के लिए करना होगा.

दूसरा चरण: लोकल डेवलपमेंट के लिए डीबग प्रोवाइडर सेट अप करना

लोकल डेवलपमेंट के लिए, App Check डीबग प्रोवाइडर को सेट अप किया जा सकता है. साथ ही, Firebase AI Logic के लिए App Check को लागू रखा जा सकता है.

Swift

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

  1. अपने Xcode प्रोजेक्ट में, FirebaseAppCheck को इंपोर्ट करें. इसके बाद, Firebase को कॉन्फ़िगर करने से पहले, डीबग प्रोवाइडर फ़ैक्ट्री की मदद से App Check को शुरू करें.

    import SwiftUI
import FirebaseCore
import FirebaseAppCheck

@main
struct YourApp: App {
  init() {
    let providerFactory = AppCheckDebugProviderFactory()
    AppCheck.setAppCheckProviderFactory(providerFactory)
    FirebaseApp.configure()
  }

  var body: some Scene {
    WindowGroup {
      NavigationView {
        ContentView()
      }
    }
  }
}

  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. अपना ऐप्लिकेशन ढूंढें और ओवरफ़्लो मेन्यू () पर क्लिक करें. इसके बाद, डीबग टोकन मैनेज करें को चुनें.

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

डीबग प्रोवाइडर के बारे में ज़्यादा जानने के लिए, App Check के आधिकारिक दस्तावेज़ देखें. इसमें नया डीबग टोकन पाने का तरीका भी बताया गया है.

Kotlin

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

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

    Firebase.initialize(context = this)
Firebase.appCheck.installAppCheckProviderFactory(
    DebugAppCheckProviderFactory.getInstance(),
)

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

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

    2. अपने लॉग में App Check डीबग टोकन ढूंढें. उदाहरण के लिए:

      D DebugAppCheckProvider: Enter this debug secret into the allow list
in the Firebase Console for your project: 123a4567-b89c-12d3-e456-789012345678

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

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

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

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

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

डीबग प्रोवाइडर के बारे में ज़्यादा जानने के लिए, App Check के आधिकारिक दस्तावेज़ देखें. इसमें नया डीबग टोकन पाने का तरीका भी बताया गया है.

Java

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

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

    FirebaseApp.initializeApp(/*context=*/ this);
FirebaseAppCheck firebaseAppCheck = FirebaseAppCheck.getInstance();
firebaseAppCheck.installAppCheckProviderFactory(
        DebugAppCheckProviderFactory.getInstance());

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

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

    2. अपने लॉग में App Check डीबग टोकन ढूंढें. उदाहरण के लिए:

      D DebugAppCheckProvider: Enter this debug secret into the allow list
in the Firebase Console for your project: 123a4567-b89c-12d3-e456-789012345678

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

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

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

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

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

डीबग प्रोवाइडर के बारे में ज़्यादा जानने के लिए, App Check के आधिकारिक दस्तावेज़ देखें. इसमें नया डीबग टोकन पाने का तरीका भी बताया गया है.

Web

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

  1. App Check को शुरू करने से पहले, डीबग के लिए बिल्ड में डीबग मोड चालू करें. इसके लिए, self.FIREBASE_APPCHECK_DEBUG_TOKEN को true पर सेट करें. उदाहरण के लिए:

    self.FIREBASE_APPCHECK_DEBUG_TOKEN = true;
initializeAppCheck(app, { /* App Check options */ });

  2. अपने वेब ऐप्लिकेशन को स्थानीय तौर पर ऐक्सेस करें और ब्राउज़र के डेवलपर टूल खोलें. डीबग कंसोल में, आपको एक डीबग टोकन दिखेगा:

    AppCheck debug token: "123a4567-b89c-12d3-e456-789012345678".
You will need to safelist it in the Firebase console for it to work.

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

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

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

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

डीबग प्रोवाइडर के बारे में ज़्यादा जानने के लिए, App Check के आधिकारिक दस्तावेज़ देखें. इसमें नया डीबग टोकन पाने का तरीका भी बताया गया है.

Dart

iOS+

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

  1. अपने Firebase ऐप्लिकेशन को शुरू करने के तुरंत बाद, डीबग प्रोवाइडर की मदद से App Check को चालू करें:

    import 'package:flutter/material.dart';
import 'package:firebase_core/firebase_core.dart';

// Import the firebase_app_check plugin
import 'package:firebase_app_check/firebase_app_check.dart';

Future<void> main() async {
  WidgetsFlutterBinding.ensureInitialized();
  await Firebase.initializeApp();
  await FirebaseAppCheck.instance.activate(
    // Set appleProvider to `AppleProvider.debug`
    appleProvider: AppleProvider.debug,
  );
  runApp(App());
}

  2. अपने Xcode प्रोजेक्ट में डीबग लॉगिंग चालू करें:

    1. Product > Scheme > Edit scheme खोलें.
    2. बाईं ओर मौजूद मेन्यू से, Run को चुनें. इसके बाद, Arguments टैब को चुनें.
    3. Arguments Passed on Launch सेक्शन में, -FIRDebugEnabled जोड़ें.

  3. अपना डीबग टोकन पाना:

    1. Xcode की मदद से ios/Runner.xcworkspace खोलें और सिम्युलेटर या टेस्ट डिवाइस पर अपना ऐप्लिकेशन चलाएं.

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

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

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

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

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

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

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

Android

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

  1. अपने Firebase ऐप्लिकेशन को शुरू करने के तुरंत बाद, डीबग प्रोवाइडर की मदद से App Check को चालू करें:

    import 'package:flutter/material.dart';
import 'package:firebase_core/firebase_core.dart';

// Import the firebase_app_check plugin
import 'package:firebase_app_check/firebase_app_check.dart';

Future<void> main() async {
  WidgetsFlutterBinding.ensureInitialized();
  await Firebase.initializeApp();
  await FirebaseAppCheck.instance.activate(
    // Set androidProvider to `AndroidProvider.debug`
    androidProvider: AndroidProvider.debug,
  );
  runApp(App());
}

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

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

    2. अपने लॉग में App Check डीबग टोकन ढूंढें. उदाहरण के लिए:

      D DebugAppCheckProvider: Enter this debug secret into the allow list
in the Firebase Console for your project: 123a4567-b89c-12d3-e456-789012345678

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

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

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

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

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

वेब

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

  1. web/index.html फ़ाइल में, self.FIREBASE_APPCHECK_DEBUG_TOKEN को true पर सेट करके डीबग मोड चालू करें:

    <body>
  <script>
    self.FIREBASE_APPCHECK_DEBUG_TOKEN = true;
  </script>

  ...

</body>

  2. अपने वेब ऐप्लिकेशन को स्थानीय तौर पर चलाएं और ब्राउज़र के डेवलपर टूल खोलें. डीबग कंसोल में, आपको एक डीबग टोकन दिखेगा:

    AppCheck debug token: "123a4567-b89c-12d3-e456-789012345678".
You will need to safelist it in the Firebase console for it to work.

    यह टोकन आपके ब्राउज़र में सेव किया जाता है. इसका इस्तेमाल तब किया जाएगा, जब उसी मशीन पर उसी ब्राउज़र में ऐप्लिकेशन का इस्तेमाल किया जाएगा. अगर आपको टोकन का इस्तेमाल किसी दूसरे ब्राउज़र या मशीन पर करना है, तो self.FIREBASE_APPCHECK_DEBUG_TOKEN को true के बजाय टोकन स्ट्रिंग पर सेट करें.

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

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

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

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

डीबग प्रोवाइडर के बारे में ज़्यादा जानने के लिए, App Check के आधिकारिक दस्तावेज़ देखें. इसमें नया डीबग टोकन पाने का तरीका भी बताया गया है.

Unity

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

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

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

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

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

  2. अपने ऐप्लिकेशन को शुरू करने वाले कोड में, यह जोड़ें:

    using Firebase.AppCheck;

void InitializeFirebase() {
  // Configure the Debug Provider factory with your debug token.
  DebugAppCheckProviderFactory.Instance.SetDebugToken("YOUR_DEBUG_TOKEN");

  // Set App Check to use the debug provider factory
  FirebaseAppCheck.SetAppCheckProviderFactory(
    DebugAppCheckProviderFactory.Instance);

  // Proceed to initialize Firebase as normal
}

डीबग प्रोवाइडर के बारे में ज़्यादा जानने के लिए, App Check के आधिकारिक दस्तावेज़ देखें. इसमें नया डीबग टोकन पाने का तरीका भी बताया गया है.

तीसरा चरण: असली उपयोगकर्ताओं और प्रोडक्शन के लिए App Check सेट अप करना

जब आप असली उपयोगकर्ताओं के लिए अपना ऐप्लिकेशन रिलीज़ करने के लिए तैयार हों, तब आपको अपने ऐप्लिकेशन रजिस्टर करने होंगे. साथ ही, प्रोडक्शन अटेस्टेशन प्रोवाइडर सेट अप करना होगा. जैसे, App Attest, Play Integrity या reCAPTCHA Enterprise.

  1. प्रॉडक्शन अटेस्टेशन की सेवा देने वाली कंपनी चुनें. इसके बाद, यहां दिए गए लिंक पर जाकर, इसे लागू करने के निर्देशों का पालन करें:

    ध्यान दें कि अगर इनमें से कोई भी अटेस्टेशन प्रोवाइडर आपकी ज़रूरतों के हिसाब से सही नहीं है, तो आपके पास कस्टम प्रोवाइडर लागू करने का विकल्प है. यह प्रोवाइडर, तीसरे पक्ष के अटेस्टेशन प्रोवाइडर या आपकी अटेस्टेशन तकनीकों का इस्तेमाल करता है.

  2. (सुझाया गया) रीप्ले प्रोटेक्शन जोड़कर सुरक्षा को बेहतर बनाएं. इसका मतलब है कि App Check टोकन का इस्तेमाल सिर्फ़ एक बार किया जा सकता है.

रीप्ले प्रोटेक्शन जोड़कर सुरक्षा को बेहतर बनाना

हमारा सुझाव है कि आप एसडीके के सबसे नए वर्शन इस्तेमाल करें. हालांकि, यह पक्का करें कि रीप्ले प्रोटेक्शन की सुविधा का इस्तेमाल करने के लिए, इनमें से कम से कम एक वर्शन का इस्तेमाल किया जा रहा हो:
Apple प्लैटफ़ॉर्म v12.2.0+ | Android BoM v34.14.0+ (App Check v19.1.0+) | Web v12.14.0+ | Flutter v4.15.0+ (App Check v4.10.0+) | Unity v13.12.0+

डिफ़ॉल्ट रूप से, App Check सेशन टोकन का इस्तेमाल करता है. इन टोकन के लिए, टाइम टू लिव (टीटीएल) को कॉन्फ़िगर किया जा सकता है. यह 30 मिनट से लेकर सात दिन के बीच हो सकता है. ये सेशन टोकन, App Check SDK टूल से कैश मेमोरी में सेव किए जाते हैं. साथ ही, इन्हें आपके ऐप्लिकेशन से किए गए अनुरोधों के साथ भेजा जाता है. इन्हें टीटीएल खत्म होने तक फिर से इस्तेमाल किया जा सकता है. सेशन टोकन का इस्तेमाल करना, बुनियादी सुरक्षा माना जाता है.

हालांकि, रीप्ले अटैक से सुरक्षा की सुविधा लागू करके, सुरक्षा को और बेहतर बनाया जा सकता है. इसमें एक बार इस्तेमाल होने वाले टोकन का इस्तेमाल किया जाता है. रीप्ले प्रोटेक्शन लागू होने पर, ये काम होते हैं:

  • App Check, Firebase AI Logic के उन अनुरोधों को ब्लॉक कर देगा जिनमें सेशन टोकन का इस्तेमाल किया जाता है. इसके बजाय, App Check सिर्फ़ तब Firebase AI Logic को अनुरोध भेजने की अनुमति देगा, जब वह एक बार इस्तेमाल होने वाले नए टोकन का इस्तेमाल करेगा.

  • एक बार इस्तेमाल होने वाले टोकन की पुष्टि होने के बाद, उसे इस्तेमाल कर लिया जाता है, ताकि उसका इस्तेमाल सिर्फ़ एक बार किया जा सके. इससे, मान्य डेटा को सर्वर के साथ फिर से शेयर करके किए जाने वाले हमलों को रोकने में मदद मिलती है.

  • App Check SDK, हर अनुरोध के लिए एक बार इस्तेमाल होने वाला नया टोकन जनरेट करता है. ध्यान दें कि इस प्रोसेस से आपके अनुरोधों पर असर पड़ सकता है. इससे कुछ इंतज़ार का समय बढ़ सकता है और कभी-कभी लागत भी बढ़ सकती है. यह इस बात पर निर्भर करता है कि पुष्टि करने वाली सेवा देने वाली कंपनी कौनसी है.

रीप्ले अटैक से सुरक्षा की सुविधा को सेट अप करना और उसे लागू करना

इस पेज पर, सेवा देने वाली कंपनी के हिसाब से कॉन्टेंट और कोड देखने के लिए, Gemini API की सेवा देने वाली कंपनी पर क्लिक करें.

रीप्ले प्रोटेक्शन को सेट अप और लागू करने का तरीका यहां बताया गया है:

  1. अगर आपने अब तक ऐसा नहीं किया है, तो इस पेज पर दिए गए निर्देशों का पालन करके, App Check सेट अप करें.

  2. एक बार इस्तेमाल होने वाले टोकन का इस्तेमाल करने की सुविधा चालू करें.

    इंस्टैंशिएशन के दौरान अपने ऐप्लिकेशन में, useLimitedUseAppCheckTokens पैरामीटर को true पर सेट करें:

    Swift 

    
// ...

// During instantiation, enable usage of limited-use tokens.
let ai = FirebaseAI.firebaseAI(
  backend: .googleAI(),
  useLimitedUseAppCheckTokens: true
)

// ...

    Kotlin 

    
// ...

// During instantiation, enable usage of limited-use tokens.
val ai = Firebase.ai(
  backend = GenerativeBackend.googleAI(),
  useLimitedUseAppCheckTokens = true
)

// ...

    Java 

    
// ...

// During instantiation, enable usage of limited-use tokens.
FirebaseAI ai = FirebaseAI.getInstance(
  /* backend: */ GenerativeBackend.googleAI(),
  /* useLimitedUseAppCheckTokens: */ true
);

// ...

    Web 

    
// ...

// During instantiation, enable usage of limited-use tokens.
const ai = getAI(firebaseApp, {
  backend: new GoogleAIBackend(),
  useLimitedUseAppCheckTokens: true
});

// ...

    Dart 

    
// ...

// During instantiation, enable usage of limited-use tokens
final ai = await FirebaseAI.googleAI(
  useLimitedUseAppCheckTokens: true,
);

// ...

    Unity 

    // ...

// During instantiation, enable usage of limited-use tokens
var ai = FirebaseAI.GetInstance(
  useLimitedUseAppCheckTokens: true
);

// ...

  3. रीप्ले प्रोटेक्शन लागू करें.

    1. अपने ऐप्लिकेशन के कोड बेस में, पक्का करें कि आपने एक बार इस्तेमाल होने वाले टोकन चालू किए हों. इसके लिए, पिछला चरण देखें.

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

    3. Firebase AI Logic के लिए, मेट्रिक व्यू को बड़ा करें.

    4. पक्का करें कि बुनियादी सुरक्षा को लागू किया गया हो. इसके बाद, जारी रखें पर क्लिक करें.

    5. रीप्ले प्रोटेक्शन के लिए, लागू नहीं किया गया (सिर्फ़ निगरानी के लिए) या लागू किया गया में से कोई एक विकल्प चुनें.

      रीप्ले प्रोटेक्शन को कब लागू करना है, यह तय करने के लिए इन बातों का ध्यान रखें:

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

      • खास तौर पर, पुष्टि नहीं की गई: फिर से इस्तेमाल किया गया टोकन मेट्रिक को मॉनिटर किया जा सकता है. यह उन अनुरोधों की संख्या है जिनमें ऐसा टोकन है जिसका इस्तेमाल पिछले अनुरोध में पहले ही किया जा चुका है. इस मेट्रिक को Firebase कंसोल में मॉनिटर करें. इसके लिए, सुरक्षा > App Check > एपीआई टैब पर जाएं.

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

Firebase AI Logic को App Check के साथ इंटिग्रेट करने का तरीका जानें

Firebase AI Logic SDK टूल इस्तेमाल करने के लिए, आपके Firebase प्रोजेक्ट में Firebase AI Logic एपीआई (firebasevertexai.googleapis.com) चालू होना चाहिए. इसकी वजह यह है कि Firebase AI Logic एसडीके से किए गए अनुरोध, सबसे पहले Firebase AI Logic सर्वर पर भेजे जाते हैं. यह सर्वर, प्रॉक्सी गेटवे के तौर पर काम करता है. यहां Firebase App Check की पुष्टि की जाती है. इसके बाद, अनुरोध को Gemini API पर भेजा जाता है और Gemini मॉडल को ऐक्सेस किया जाता है.

अक्सर पूछे जाने वाले सवाल और समस्या हल करना

Firebase AI Logic से जुड़े अक्सर पूछे जाने वाले सवाल और समस्या हल करने के तरीके या गड़बड़ी के कोड देखें.