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

يمكنك فرض وضع المستخدمين المصادَق عليهم في مشروع 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 وAgent Platform Gemini API (formerly Vertex AI).
  • ينطبق هذا الإعداد على جميع الطلبات التي تستخدم نماذج الطلبات من الخادم.
  • لا يمكن تطبيق هذا الإعداد لكل مستخدم أو لكل واجهة برمجة تطبيقات أو لكل نموذج.

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

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

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

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

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

• إذا كنت تستخدم واجهة برمجة التطبيقات REST API في Firebase AI Logic:

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

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

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

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

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

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

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

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

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

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

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

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

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

// ...

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

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

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

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

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

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

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

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

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

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

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

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

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

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

• سيتم السماح بالطلبات الواردة من خلال Firebase AI Logic والتي لا ترسل بيانات اعتماد Firebase Authentication.
• هذا الإعداد على مستوى المشروع لـ Firebase AI Logic.

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

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

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

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