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

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

عند حظر طلب، سيكون الردّ هو الخطأ 401: unauthenticated.

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

اعتبارات مهمّة

يُرجى العِلم بالاعتبارات المهمّة التالية لوضع المستخدمين الذين تمّت مصادقتهم.

ملاحظة: إنّ فرض وضع المستخدمين الذين تمّت مصادقتهم هو إحدى الطرق التي تساعد في تأمين استخدام Gemini API، ولكن من المهم جدًا أيضًا فرض Firebase App Check.

عند فرض وضع المستخدمين الذين تمّت مصادقتهم

عند فرض وضع المستخدمين الذين تمّت مصادقتهم، يُرجى العِلم بما يلي:

• هذا الإعداد ينطبق على المشروع بأكمله في Firebase AI Logic.

  • ينطبق على جميع التطبيقات المسجّلة في المشروع.
  • ينطبق فقط على المشروع الذي تم فيه فرض هذا الوضع.

• يؤدي هذا الإعداد إلى حظر جميع الطلبات من خلال Firebase AI Logic التي لا تُرسِل بيانات اعتماد Firebase Authentication.

  • يجب مصادقة المستخدم من خلال Firebase Authentication قبل إرسال الطلب إلى Firebase AI Logic.
  • ينطبق هذا الإعداد على جميع الطلبات من خلال Firebase AI Logic إلى كلّ من Gemini Developer API وVertex AI Gemini API.
  • ينطبق هذا الإعداد على جميع الطلبات التي تستخدم نماذج طلبات الخادم.
  • لا يمكن تطبيق هذا الإعداد على أساس كل مستخدم أو كل واجهة برمجة تطبيقات أو كل نموذج.

• لا يحظر هذا الإعداد طلبات Gemini API في مشروعك التي لا تتم من خلال Firebase AI Logic.

• إذا كنت تستخدم وضعًا مختلطًا أو وضعًا على الجهاز فقط:

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

• إذا كنت تستخدم Gemini Live API:

  • يحظرهذا الإعداد استخدام Gemini Live API لـ تطبيقات الويب عند استخدام Firebase AI Logic، حتى بالنسبة إلى المستخدمين الذين تمّت مصادقتهم. ويشمل ذلك تطبيقات الويب التي تستخدم Firebase JS SDK أو تطبيقات Flutter للويب.

• إذا كنت تستخدم Firebase AI Logic REST API:

  • يحظرهذا الإعداد طلبات الاستنتاج التي لا تُرسِل Firebase Authentication بيانات الاعتماد. ويشمل ذلك طلبات نماذج طلبات الخادم، مثل templateGenerateContent أو templateStreamGenerateContent.
  • لا يحظر هذا الإعداد طلبات لوحة التحكّم (مثل طلبات إدارة النماذج والإعدادات) لأنّها محمية من خلال إدارة الهوية وإمكانية الوصول.

• لا يحظر هذا الإعداد الطلبات الموجّهة إلى countTokens (واجهة برمجة التطبيقات Count Tokens API).

قبل فرض وضع المستخدمين الذين تمّت مصادقتهم

يُرجى العِلم بما يلي قبل فرض وضع المستخدمين الذين تمّت مصادقتهم:

• إذا كانت لديك إصدارات حالية من تطبيقك لا تستخدم Firebase Authentication:

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

• تتطلّب الإصدارات الأقدم من مكوّن Flutter الإضافي إنشاء مثيل خاص لإرسال Firebase Authentication بيانات الاعتماد مع الطلبات.

  • إذا كان تطبيقك يستخدم مكوّن Flutter الإضافي firebase_ai الإصدار 3.11.0 أو إصدارًا أقدم (قائمة المواد في الإصدار 4.12.0 أو إصدارًا أقدم) ولا يمرِّر بيانات اعتماد Authentication أثناء إنشاء المثيل، سيؤدي هذا الإعداد إلى حظر الطلبات من خلال Firebase AI Logic، حتى بالنسبة إلى المستخدمين الذين تمّت مصادقتهم.
  • يُرجى التأكّد من تعديل جميع العملاء النشطين لتطبيق Flutter إلى إصدار أحدث من المكوّن الإضافي قبل فرض وضع المستخدمين الذين تمّت مصادقتهم.

إنشاء مثيل خاص مطلوب لتطبيق Flutter في حال استخدام إصدارات أقدم من المكوّن الإضافي

انقر على موفِّر Gemini API لعرض المحتوى الخاص بالموفِّر والرمز البرمجي على هذه الصفحة. Gemini Developer API Vertex AI Gemini API

لا يكون إنشاء هذا المثيل الخاص مطلوبًا إلا إذا كان تطبيقك يستخدم مكوّن Flutter الإضافي firebase_ai الإصدار 3.11.0 أو إصدارًا أقدم (قائمة المواد في الإصدار 4.12.0 أو إصدارًا أقدم). إذا كان تطبيقك يستخدم إصدارًا أحدث من المكوّن الإضافي، لن يكون إنشاء هذا المثيل الخاص مطلوبًا.

ملاحظة: تنصح Firebase باستخدام أحدث إصدارات حِزم تطوير البرامج (SDK) والمكوّنات الإضافية والأدوات حتى تتمكّن من الوصول إلى أحدث الميزات وإصلاحات الأخطاء وما إلى ذلك.

في حال فرض وضع المستخدمين الذين تمّت مصادقتهم، عليك في تطبيقات Flutter التي تستخدم إصدارات أقدم من المكوّن الإضافي أن تمرِّر بيانات اعتماد Firebase Authentication بشكلٍ صريح أثناء إنشاء المثيل، على النحو التالي:Authentication

// ...

final ai = await FirebaseAI.googleAI(
  auth: FirebaseAuth.instance, // for Flutter, pass in Authentication explicitly
);

// ...

إعداد Firebase Authentication

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

تقدّم مستندات Firebase Authentication أوصافًا وتعليمات التنفيذ لموفِّري المصادقة المتوافق معهم، بما في ذلك استخدام كلمات المرور وأرقام الهواتف وموفِّري الهوية الموحّدة الشائعين (مثل Google وFacebook وGitHub) وغير ذلك.

بعد تنفيذ Firebase Authentication في تطبيقك، سيُرسِل تطبيقك تلقائيًا بيانات اعتماد Firebase Authentication للمستخدم الذي تمّت مصادقته في كل طلب إلى Firebase AI Logic.

يُرجى العِلم بما يلي بشأن بعض موفِّري المصادقة:

• المصادقة المخصّصة: عليك جلب رمز مصادقة موقَّع لإرساله مع الطلب إلى Firebase AI Logic. لمعرفة التفاصيل، يُرجى الاطّلاع على المصادقة المخصّصة.

• طرق المصادقة المجهولة أو البريد الإلكتروني/كلمة المرور: يُعدّ هؤلاء المستخدمون مستخدمين تمّت مصادقتهم ، لذا طلباتهم إلى Firebase AI Logic لا يتم حظرها.

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

إدارة إعداد وضع المستخدمين الذين تمّت مصادقتهم

يمكنك إدارة إعداد وضع المستخدمين الذين تمّت مصادقتهم في Firebase console.

ملاحظة: إنّ فرض وضع المستخدمين الذين تمّت مصادقتهم هو إحدى الطرق التي تساعد في تأمين استخدام Gemini API، ولكن من المهم جدًا أيضًا فرض Firebase App Check.

أذونات وأدوار إدارة الهوية وإمكانية الوصول المطلوبة

تتطلّب إدارة إعداد وضع المستخدمين الذين تمّت مصادقتهم الإذن firebasevertexai.configs.update، الذي يتم تضمينه تلقائيًا في أدوار إدارة الهوية وإمكانية الوصول التالية: المالك والمحرِّر ومشرف Firebase ومشرف Firebase AI Logic.

فرض وضع المستخدمين الذين تمّت مصادقتهم

في ما يلي كيفية فرض وضع المستخدمين الذين تمّت مصادقتهم لمشروعك على Firebase:

1. إذا لم يسبق لك ذلك، يُرجى مراجعة الـ اعتبارات المهمّة لوضع الـ مستخدمين الذين تمّت مصادقتهم في وقت سابق من هذا الدليل.

2. إذا لم يسبق لك ذلك، يُرجى إعداد Firebase Authentication في تطبيقك (كما هو موضّح سابقًا في هذا الدليل).

3. فرض وضع المستخدمين الذين تمّت مصادقتهم:

   1. في Firebase console، انتقِل إلى خدمات الذكاء الاصطناعي > Firebase AI Logic > علامة التبويب الإعدادات.

   2. ضمن وضع المستخدمين الذين تمّت مصادقتهم ، حرِّك الزرّ بجانب فرض وضع المستخدمين الذين تمّت مصادقتهم إلى مفروض.

   3. راجِع مربّع حوار التأكيد، ثم انقر على تأكيد.

إيقاف فرض وضع المستخدمين الذين تمّت مصادقتهم

إذا أوقفت فرض وضع المستخدمين الذين تمّت مصادقتهم، يُرجى العِلم بما يلي:

• سيتم السماح بالطلبات من خلال Firebase AI Logic التي لا تُرسِل Firebase Authentication بيانات اعتماد.
• هذا الإعداد ينطبق على المشروع بأكمله في Firebase AI Logic.

في ما يلي كيفية إيقاف فرض وضع المستخدمين الذين تمّت مصادقتهم لمشروعك على Firebase:

1. في Firebase console، انتقِل إلى خدمات الذكاء الاصطناعي > Firebase AI Logic > علامة التبويب الإعدادات.

2. ضمن وضع المستخدمين الذين تمّت مصادقتهم ، أوقِف فرض وضع المستخدمين الذين تمّت مصادقتهم.

3. راجِع مربّع حوار التأكيد، ثم انقر على تأكيد.