قائمة التحقّق من الأمان لاستخدام Firebase AI Logic

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

التحقّق من التطبيق والجهاز والمستخدم

تأكَّد من أنّ الطلبات الواردة تأتي من نُسخ شرعية وغير معدَّلة من تطبيقك تعمل على أجهزة أصلية، ومن مستخدمين حقيقيين.

فرض Firebase App Check

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

يتيح App Check استخدام موفّري خدمات المصادقة لأنظمة Apple الأساسية (DeviceCheck أو App Attest أو reCAPTCHA Enterprise) وAndroid (Play Integrity أو reCAPTCHA Enterprise) والويب (reCAPTCHA Enterprise). ويتيح أيضًا استخدام جميع موفّري الخدمات هؤلاء لتطبيقات Flutter وUnity.

اعتبارًا من أوائل يوليو 2026، ستفرض منصة Firebase تلقائيًا App Check لـ Firebase AI Logic أثناء عملية الإعداد الموجَّه في وحدة تحكّم Firebase. إذا سبق لك إعداد Firebase AI Logic، تأكَّد من فرض App Check بشكل صريح. للتطوير على الجهاز، يمكنك إعداد App Check مقدّم خدمة تصحيح الأخطاء، ثم تسجيل تطبيقك لدى مقدّم خدمة مصادقة الإصدار العلني قبل طرحه للمستخدمين النهائيين.

تفعيل ميزة "الحماية من إعادة التشغيل" باستخدام الرموز المميّزة المحدودة الاستخدام

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

إعداد قيود لمفاتيح واجهة برمجة التطبيقات في Firebase

تحدّد مفاتيح واجهة برمجة التطبيقات في Firebase مشروع Firebase وتطبيقك عند إرسال الطلبات. لمنع الاستخدام غير المصرَّح به لمفاتيح واجهة برمجة التطبيقات، اتّبِع الخطوات التالية:

  • اضبط "قيود التطبيق" في وحدة تحكّم Google Cloud لحصر استخدام المفتاح بالطلبات الواردة من معرّف الحزمة المحدّد لتطبيقك (Apple) أو اسم الحزمة وبصمة إصبع SHA-1 (Android) أو مُحيل HTTP (الويب).

  • راجِع القائمة المسموح بها لكل مفتاح في "قيود واجهة برمجة التطبيقات":

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

حصر الطلبات على المستخدمين الذين تمت مصادقتهم فقط

ننصحك بفرض وضع المستخدمين الذين تمت مصادقتهم لكي تتضمّن جميع الطلبات عبر Firebase AI Logic بيانات اعتماد صالحة من Firebase Authentication. إذا ورد طلب من مستخدم نهائي لم تتم مصادقته، يتم رفض الطلب مع ظهور الخطأ 401: unauthenticated.

حماية الطلبات وتعزيز أمانها

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

استخدام نماذج الطلبات من الخادم

استخدِم نماذج الطلبات من الخادم للاحتفاظ بالطلبات وتعليمات النظام وإعدادات النماذج بشكل آمن في السحابة الإلكترونية، بدلاً من ترميزها بشكل ثابت في رمز تطبيق العميل حيث يمكن استخراجها باستخدام فك التشفير الثنائي.

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

التحقّق من صحة متغيّرات النماذج التي يقدّمها العميل وتنقيحها

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

  • يجب التحقّق من صحة جميع البيانات التي يُدخلها المستخدمون على العميل وتنظيفها قبل تمرير المتغيّرات إلى نموذج (مثل فرض عدد الأحرف المسموح به والتنسيقات المتوقّعة).
  • أدرِج تعليمات واضحة للنظام في نماذجك تحدّد الإجراءات الوقائية لكيفية معالجة إدخالات المستخدمين.

فرض وضع "النماذج فقط"

ننصحك بتفعيل وضع النماذج فقط بعد أن تصبح جميع ميزات تطبيقك تستخدم نماذج الطلبات من الخادم. عند تفعيل هذه السياسة، يحظر Firebase AI Logic جميع الطلبات المباشرة التي لا تستخدم نماذج إلى Gemini API (403: unauthorized)، ما يمنع الجهات المسيئة من إرسال طلبات عشوائية أو إساءة استخدام حصتك.

المراقبة والحدود والفوترة

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

إعداد ميزة "تتبّع استخدام الذكاء الاصطناعي" في وحدة تحكّم Firebase

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

ضبط حدود المعدّل وإدارة الحصص

يمكنك حماية مشروعك من الارتفاعات غير المتوقّعة في الاستخدام وهجمات حجب المحفظة:

تجنُّب الفواتير غير المتوقّعة من خلال التنبيهات وحدود الإنفاق

إذا كان مشروعك على Firebase يستخدم خطة أسعار Blaze المَرِنة:

الخطوات التالية