منع إساءة استخدام Gemini API باستخدام ميزة "فحص التطبيقات من Firebase"

عند طلب بيانات من واجهة برمجة تطبيقات مباشرةً من تطبيق ويب أو تطبيق متوافق مع الأجهزة الجوّالة، تكون واجهة برمجة التطبيقات عرضةً لإساءة الاستخدام من قِبل عملاء غير مصرَّح لهم. إذا أردت استدعاء Gemini API مباشرةً من تطبيق الويب أو الأجهزة الجوّالة، عليك المساعدة في حمايته من إساءة الاستخدام من خلال استخدام Firebase AI Logic وفرض Firebase App Check. عند فرض App Check، سيتم السماح فقط بالطلبات الواردة التي تم التحقّق من أنّها واردة من تطبيقك الفعلي و/أو جهاز لم يتم التلاعب به.

الانتقال إلى تعليمات الإعداد

يوفّر Firebase AI Logic بوابة خادم وكيل تتيح لك التكامل مع Firebase App Check وحماية Gemini API عند استدعائه مباشرةً من خلال تطبيقات الويب والأجهزة الجوّالة. عند فرض App Check على Firebase AI Logic، يساعد ذلك في حماية كل من Gemini Developer API وAgent Platform Gemini API (formerly Vertex AI).

يتيح App Check لـ Firebase AI Logic أيضًا الحماية من إعادة التشغيل، ما يعني أنّه لا يمكن استخدام رمز App Check المميّز إلا مرة واحدة.


ملخّص عام عن طريقة عمل "App Check"

باستخدام App Check، تستخدم الأجهزة التي تشغّل تطبيقك مقدّم خدمة مصادقة التطبيقات أو الأجهزة الذي يتحقّق من أحد الأمرين التاليين أو كليهما:

  • الطلبات واردة من تطبيقك الأصلي
  • الطلبات صادرة من جهاز أصلي لم يتم التلاعب به

يتم إرفاق هذا التصديق بكل طلب يرسله تطبيقك باستخدام حزمة تطوير برامج (SDK) من Firebase AI Logic. عند تنفيذ App Check، سيتم رفض الطلبات الواردة من العملاء بدون شهادة صالحة، وكذلك أي طلب وارد من تطبيق أو منصة لم تسمح بها.

عند إعداد App Check، ننصحك بإضافة الحماية من إعادة التشغيل، ما يجعل رموز App Check المميّزة صالحة للاستخدام مرة واحدة فقط. يوفّر هذا الخيار حماية محسّنة تتجاوز مستوى الحماية الأساسي، ويتيح لك ضبط مستوى حماية مناسب لتطبيقك وحالات الاستخدام.

يمكنك العثور على معلومات تفصيلية حول App Check في مستنداته، بما في ذلك أوصاف مقدّمي خدمات المصادقة وأي حصص وحدود سارية.

إعداد "App Check"

تم تحسين التعليمات التالية لإعداد إجراءات التنفيذ في Firebase App Check لـ Firebase AI Logic.

الخطوة 1: فرض App Check

اعتبارًا من أوائل يوليو 2026، وخلال سير عمل الإعداد الموجَّه في وحدة تحكّم Firebase، ستفرض Firebase تلقائيًا Firebase App Check لـ Firebase AI Logic للمساعدة في حماية Gemini API.

ومع ذلك، إذا سبق لك إعداد Firebase AI Logic في مشروعك على Firebase قبل أوائل يوليو 2026 (أو لم يتم فرض App Check لسبب آخر)، يمكنك فرض App Check بنفسك باتّباع التعليمات التالية.

  1. تحقَّق مما إذا كان قد تم فرض App Check على Firebase AI Logic.

    1. في وحدة تحكّم Firebase، انتقِل إلى الأمان > فحص التطبيقات > علامة التبويب واجهات برمجة التطبيقات.

    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).

الخطوة 2: إعداد مقدّم خدمة تصحيح الأخطاء للتطوير على الجهاز

بالنسبة إلى التطوير المحلي، يمكنك إعداد مقدّم خدمة تصحيح الأخطاء في App Check مع إبقاء App Check مفروضًا على Firebase AI Logic.

Swift

في ما يلي كيفية استخدام مقدّم خدمة تصحيح الأخطاء أثناء تشغيل تطبيقك في محاكي بشكل تفاعلي (على سبيل المثال، أثناء التطوير على الجهاز):

  1. في مشروع Xcode، استورِد FirebaseAppCheck وابدأ App Check باستخدام فئة إنشاء مقدّم خدمة تصحيح الأخطاء قبل ضبط Firebase.

    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، انتقِل إلى الأمان > فحص التطبيقات > علامة التبويب التطبيقات.

    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، انتقِل إلى الأمان > فحص التطبيقات > علامة التبويب التطبيقات.

    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، انتقِل إلى الأمان > فحص التطبيقات > علامة التبويب التطبيقات.

    2. ابحث عن تطبيقك، وانقر على قائمة الكاملة ()، ثم اختَر إدارة الرموز المميّزة لتصحيح الأخطاء.

    3. اتّبِع التعليمات الظاهرة على الشاشة لتسجيل الرمز المميّز لتصحيح الأخطاء.

لمعرفة التفاصيل حول مقدّم خدمة تصحيح الأخطاء (بما في ذلك كيفية الحصول على رمز مميّز جديد لتصحيح الأخطاء)، يُرجى الاطّلاع على مستندات App Check الرسمية.

Web

إليك كيفية استخدام مقدّم خدمة تصحيح الأخطاء أثناء تشغيل تطبيقك من localhost بشكل تفاعلي (على سبيل المثال، أثناء التطوير على الجهاز):

  1. في الإصدار المخصّص لتصحيح الأخطاء، فعِّل وضع تصحيح الأخطاء من خلال ضبط self.FIREBASE_APPCHECK_DEBUG_TOKEN على true قبل إعداد App Check. على سبيل المثال:

    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، انتقِل إلى الأمان > فحص التطبيقات > علامة التبويب التطبيقات.

    2. ابحث عن تطبيقك، وانقر على قائمة الكاملة ()، ثم اختَر إدارة الرموز المميّزة لتصحيح الأخطاء.

    3. اتّبِع التعليمات الظاهرة على الشاشة لتسجيل الرمز المميّز لتصحيح الأخطاء.

لمعرفة التفاصيل حول مقدّم خدمة تصحيح الأخطاء (بما في ذلك كيفية الحصول على رمز مميّز جديد لتصحيح الأخطاء)، يُرجى الاطّلاع على مستندات App Check الرسمية.

Dart

iOS+‎

في ما يلي كيفية استخدام مقدّم خدمة تصحيح الأخطاء أثناء تشغيل تطبيقك في محاكي بشكل تفاعلي (على سبيل المثال، أثناء التطوير على الجهاز):

  1. فعِّل App Check باستخدام مقدّم خدمة تصحيح الأخطاء بعد إعداد تطبيق Firebase مباشرةً:

    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. افتح ios/Runner.xcworkspace باستخدام Xcode وشغِّل تطبيقك في المحاكي أو على جهاز الاختبار.

    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، انتقِل إلى الأمان > فحص التطبيقات > علامة التبويب التطبيقات.

    2. ابحث عن تطبيقك، وانقر على قائمة الكاملة ()، ثم اختَر إدارة الرموز المميّزة لتصحيح الأخطاء.

    3. اتّبِع التعليمات الظاهرة على الشاشة لتسجيل الرمز المميّز لتصحيح الأخطاء.

Android

في ما يلي كيفية استخدام مقدّم خدمة تصحيح الأخطاء أثناء تشغيل تطبيقك في محاكي بشكل تفاعلي (على سبيل المثال، أثناء التطوير على الجهاز):

  1. فعِّل App Check باستخدام مقدّم خدمة تصحيح الأخطاء بعد إعداد تطبيق Firebase مباشرةً:

    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، انتقِل إلى الأمان > فحص التطبيقات > علامة التبويب التطبيقات.

    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، انتقِل إلى الأمان > فحص التطبيقات > علامة التبويب التطبيقات.

    2. ابحث عن تطبيقك، وانقر على قائمة الكاملة ()، ثم اختَر إدارة الرموز المميّزة لتصحيح الأخطاء.

    3. اتّبِع التعليمات الظاهرة على الشاشة لتسجيل الرمز المميّز لتصحيح الأخطاء.

لمعرفة التفاصيل حول مقدّم خدمة تصحيح الأخطاء (بما في ذلك كيفية الحصول على رمز مميّز جديد لتصحيح الأخطاء)، يُرجى الاطّلاع على مستندات App Check الرسمية.

Unity

في ما يلي كيفية استخدام مقدّم خدمة تصحيح الأخطاء أثناء تشغيل تطبيقك في محاكي بشكل تفاعلي (على سبيل المثال، أثناء التطوير على الجهاز):

  1. في وحدة تحكّم Firebase، أنشِئ رمز تصحيح أخطاء مميّزًا:

    1. في وحدة تحكّم Firebase، انتقِل إلى الأمان > فحص التطبيقات > علامة تبويب التطبيقات.

    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 الرسمية.

الخطوة 3: إعداد App Check للمستخدمين النهائيين والإنتاج

عندما تكون مستعدًا لإصدار تطبيقك للمستخدمين النهائيين، عليك تسجيل تطبيقاتك وإعداد مقدّم خدمة مصادقة لإصدار الإنتاج (مثل App Attest أو Play Integrity أو reCAPTCHA Enterprise).

  1. اختَر مقدّم خدمة مصادقة إنتاج، واتّبِع تعليمات التنفيذ الواردة في الروابط التالية:

    يُرجى العِلم أنّه إذا لم يكن أيّ من مقدّمي خدمات المصادقة هؤلاء كافيًا لتلبية احتياجاتك، يمكنك تنفيذ مقدّم خدمة مخصّص يستخدم إما مقدّم خدمة مصادقة تابعًا لجهة خارجية أو أساليب المصادقة الخاصة بك.

  2. (إجراء يُنصح به) يمكنك تعزيز الحماية من خلال إضافة الحماية من إعادة التشغيل، ما يعني أنّه لا يمكن استخدام رمز App Check المميّز إلا مرة واحدة.

تعزيز الحماية من خلال إضافة ميزة "الحماية من إعادة التشغيل"

ننصحك باستخدام أحدث إصدارات حزمة تطوير البرامج (SDK)، ولكن يُرجى التأكّد من استخدام أحد هذه الإصدارات على الأقل لاستخدام ميزة "الحماية من إعادة التشغيل":
الإصدار 12.2.0 أو إصدار أحدث من منصات Apple‏ | الإصدار 34.14.0 أو إصدار أحدث من BoM لنظام التشغيل Android (الإصدار 19.1.0 أو إصدار أحدث من App Check) | الإصدار 12.14.0 أو إصدار أحدث من الويب | الإصدار 4.15.0 أو إصدار أحدث من Flutter (الإصدار 4.10.0 أو إصدار أحدث من App Check) | الإصدار 13.12.0 أو إصدار أحدث من Unity

يستخدم App Check تلقائيًا الرموز المميّزة للجلسات التي لها مدة بقاء (TTL) قابلة للضبط تتراوح بين 30 دقيقة و7 أيام. يتم تخزين الرموز المميزة للجلسات مؤقتًا من خلال حزمة تطوير البرامج (SDK) لـ "App Check"، ويتم إرسالها مع الطلبات من تطبيقك، ويمكن إعادة استخدامها إلى أن تنتهي صلاحيتها. يُعدّ استخدام الرموز المميّزة للجلسات إجراءً أساسيًا للحماية.

ومع ذلك، يمكنك تعزيز الحماية بما يتجاوز هذا المستوى الأساسي من خلال فرض الحماية من هجمات إعادة الإرسال التي تستخدم رموزًا مميّزة محدودة الاستخدام بدلاً من ذلك. عند فرض الحماية من إعادة التشغيل، يحدث ما يلي:

  • سيحظر "App Check" الطلبات المُرسَلة إلى "Firebase AI Logic" والتي تستخدم الرموز المميّزة للجلسات. بدلاً من ذلك، لن يسمح App Check بإرسال طلب إلى Firebase AI Logic إلا إذا كان يستخدم رمزًا مميزًا محدود الاستخدام تم إنشاؤه حديثًا.

  • بعد التحقّق من الرمز المميّز المحدود الاستخدام، يتم استهلاكه بحيث يمكن استخدامه مرة واحدة فقط، ما يمنع الهجمات التي تهدف إلى إعادة استخدام الرموز.

  • تُنشئ حزمة تطوير البرامج (SDK) لـ "App Check" رمزًا مميّزًا جديدًا محدود الاستخدام لكل طلب. يُرجى العِلم أنّ هذه العملية يمكن أن تؤثّر في طلباتك من خلال إضافة بعض وقت الاستجابة وأحيانًا التكلفة (حسب مقدّم خدمة المصادقة).

إعداد ميزة "الحماية من إعادة التشغيل" وفرضها

انقر على مزوّد خدمة 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، انتقِل إلى الأمان > فحص التطبيقات.

    3. توسيع عرض المقاييس لـ "Firebase AI Logic"

    4. تأكَّد من أنّ الحماية الأساسية مفعَّلة، ثم انقر على متابعة.

    5. بالنسبة إلى الحماية من إعادة التشغيل، اختَر غير مفروض (للمراقبة فقط) أو مفروض.

      يُرجى مراعاة ما يلي لتحديد الحالات التي يجب فيها فرض الحماية من إعادة التشغيل:

      • ننصحك بمراقبة طلباتك إذا كان من المرجّح أن يستخدم عدد كبير من المستخدمين إصدارات سابقة من تطبيقك بدون تفعيل الرموز المميّزة المحدودة الاستخدام. إذا فرضت الحماية من إعادة التشغيل على الفور، سيتم حظر الطلبات الواردة من هؤلاء المستخدمين.

      • يمكنك مراقبة مقياس غير متحقق منه: رمز مميّز مُعاد استخدامه تحديدًا، وهو عدد الطلبات التي تحتوي على رمز مميّز سبق استخدامه في طلب سابق. يمكنك مراقبة هذا المقياس في وحدة تحكّم Firebase (انتقِل إلى الأمان > فحص التطبيقات > علامة التبويب واجهات برمجة التطبيقات).

        إذا كان جزء كبير من الطلبات الأخيرة يندرج ضمن هذه الفئة، يمكنك تجنُّب إزعاج المستخدمين والانتظار قبل فرض الحماية من هجمات إعادة الإرسال إلى أن يثبّت المزيد من المستخدمين إصدارًا من تطبيقك يستخدم الرموز المميّزة المحدودة الاستخدام.

فهم كيفية تكامل "Firebase AI Logic" مع "App Check"

لاستخدام حِزم تطوير البرامج (SDK) في Firebase AI Logic، يجب تفعيل واجهة برمجة التطبيقات Firebase AI Logic (firebasevertexai.googleapis.com) في مشروع Firebase. ويعود السبب في ذلك إلى أنّ الطلبات التي يتم إجراؤها من خلال حِزم تطوير البرامج (SDK) في Firebase AI Logic يتم إرسالها أولاً إلى خادم Firebase AI Logic الذي يعمل كبوابة وكيل يتم فيها التحقّق من Firebase App Check قبل السماح للطلب بالانتقال إلى Gemini API والوصول إلى نماذج Gemini.

الأسئلة الشائعة وتحديد المشاكل وحلّها

يمكنك الاطّلاع على الأسئلة الشائعة الإضافية وطرق تحديد المشاكل وحلّها أو رموز الخطأ الإضافية المتعلقة بـ "Firebase AI Logic".