تمكين التحقق من التطبيق مع reCAPTCHA Enterprise في تطبيقات الويب

توضح لك هذه الصفحة كيفية تمكين التحقق من التطبيق في تطبيق ويب ، باستخدام موفر reCAPTCHA Enterprise. عند تمكين التحقق من التطبيق ، فإنك تساعد في التأكد من أن تطبيقك هو الوحيد الذي يمكنه الوصول إلى موارد Firebase لمشروعك. انظر نظرة عامة على هذه الميزة.

reCAPTCHA Enterprise هي خدمة مدفوعة مع حصة بدون تكلفة. يدعم App Check أيضًا reCAPTCHA v3 ، وهي خدمة مجانية. لمعرفة الاختلافات بين reCAPTCHA v3 و reCAPTCHA Enterprise ، راجع مقارنة الميزات .

لاحظ أن التحقق من التطبيق يستخدم مفاتيح موقع reCAPTCHA Enterprise القائمة على النقاط ، مما يجعلها غير مرئية للمستخدمين. لن يطلب موفر reCAPTCHA Enterprise من المستخدمين حل التحدي في أي وقت.

إذا كنت تريد استخدام التحقق من التطبيق مع الموفر المخصص الخاص بك ، فراجع تنفيذ موفر فحص التطبيق المخصص .

1. قم بإعداد مشروع Firebase

  1. أضف Firebase إلى مشروع JavaScript الخاص بك إذا لم تكن قد قمت بذلك بالفعل.

  2. افتح قسم reCAPTCHA Enterprise في وحدة التحكم السحابية وقم بما يلي:

    1. إذا طُلب منك تمكين reCAPTCHA Enterprise API ، فقم بذلك.
    2. قم بإنشاء مفتاح من نوع موقع الويب . ستحتاج إلى تحديد المجالات التي تستضيف عليها تطبيق الويب الخاص بك. اترك خيار "استخدام تحدي مربع الاختيار" غير محدد .
  3. سجّل تطبيقاتك لاستخدام App Check مع موفر reCAPTCHA Enterprise في قسم App Check في وحدة تحكم Firebase. ستحتاج إلى توفير مفتاح الموقع الذي حصلت عليه في الخطوة السابقة.

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

  4. اختياري : في إعدادات تسجيل التطبيق ، قم بتعيين مدة مخصصة للعيش (TTL) لرموز التحقق من التطبيق الصادرة عن الموفر. يمكنك ضبط TTL على أي قيمة تتراوح بين 30 دقيقة و 7 أيام. عند تغيير هذه القيمة ، انتبه للمفاضلات التالية:

    • الأمان: توفر TTLs الأقصر أمانًا أقوى ، لأنها تقلل الفترة التي يمكن فيها للمهاجم إساءة استخدام رمز تم تسريبه أو اعتراضه.
    • الأداء: تعني مدة البقاء (TTL) الأقصر أن تطبيقك سيجري المصادقة بشكل متكرر أكثر. نظرًا لأن عملية التصديق على التطبيق تضيف وقت استجابة لطلبات الشبكة في كل مرة يتم إجراؤها ، يمكن أن تؤثر مدة البقاء القصيرة على أداء تطبيقك.
    • الحصة والتكلفة: تستنفد مدة البقاء القصيرة وإعادة التصديق المتكررة حصتك بشكل أسرع ، وبالنسبة للخدمات المدفوعة ، من المحتمل أن تكلف أكثر. انظر الحصص والحدود .

    مدة البقاء الافتراضية لمدة ساعة واحدة مناسبة لمعظم التطبيقات. لاحظ أن مكتبة App Check تقوم بتحديث الرموز المميزة في نصف مدة TTL تقريبًا.

2. قم بإضافة مكتبة App Check إلى تطبيقك

أضف Firebase إلى تطبيق الويب الخاص بك إذا لم تكن قد قمت بذلك بالفعل. تأكد من استيراد مكتبة App Check.

3. تهيئة فحص التطبيق

أضف رمز التهيئة التالي إلى تطبيقك ، قبل الوصول إلى أي من خدمات Firebase. ستحتاج إلى تمرير مفتاح موقع reCAPTCHA Enterprise ، الذي قمت بإنشائه في وحدة التحكم السحابية ، activate() .

Web version 9

const { initializeApp } = require("firebase/app");
const { initializeAppCheck, ReCaptchaEnterpriseProvider } = require("firebase/app-check");

const app = initializeApp({
  // Your Firebase configuration object.
});

// Create a ReCaptchaEnterpriseProvider instance using your reCAPTCHA Enterprise
// site key and pass it to initializeAppCheck().
const appCheck = initializeAppCheck(app, {
  provider: new ReCaptchaEnterpriseProvider(/* reCAPTCHA Enterprise site key */),
  isTokenAutoRefreshEnabled: true // Set to true to allow auto-refresh.
});

Web version 8

firebase.initializeApp({
  // Your Firebase configuration object.
});

// Create a ReCaptchaEnterpriseProvider instance using your reCAPTCHA Enterprise
// site key and pass it to activate().
const appCheck = firebase.appCheck();
appCheck.activate(
  new firebase.appCheck.ReCaptchaEnterpriseProvider(
    /* reCAPTCHA Enterprise site key */
  ),
  true // Set to true to allow auto-refresh.
);

بمجرد تثبيت مكتبة App Check في تطبيقك ، انشرها.

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

4. مقاييس مراقبة الطلب

الآن بعد أن أصبح تطبيقك المحدث في أيدي المستخدمين ، يمكنك تمكين فرض التحقق من التطبيق لمنتجات Firebase التي تستخدمها. ومع ذلك ، قبل القيام بذلك ، يجب أن تتأكد من أن القيام بذلك لن يؤدي إلى تعطيل المستخدمين الشرعيين الحاليين لديك.

قاعدة بيانات Realtime و Cloud Firestore والتخزين السحابي

أداة مهمة يمكنك استخدامها لاتخاذ هذا القرار لقاعدة بيانات Realtime و Cloud Firestore و Cloud Storage هي شاشة مقاييس طلب التحقق من التطبيق.

لعرض مقاييس طلب فحص التطبيق لمنتج ما ، افتح قسم فحص التطبيق في وحدة تحكم Firebase. فمثلا:

لقطة شاشة لصفحة مقاييس التحقق من التطبيق

مقاييس الطلب لكل منتج مقسمة إلى أربع فئات:

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

  • طلبات العملاء القديمة هي تلك التي تفتقد إلى رمز التحقق من التطبيق. قد تكون هذه الطلبات من إصدار أقدم من Firebase SDK قبل تضمين App Check في التطبيق.

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

  • الطلبات غير الصالحة هي الطلبات التي تحتوي على رمز مميز غير صالح لفحص التطبيق ، والذي قد يكون من عميل غير أصلي يحاول انتحال شخصية تطبيقك ، أو من بيئات تمت محاكاتها.

يجب أن يبلغ توزيع هذه الفئات لتطبيقك عندما تقرر تمكين الإنفاذ. فيما يلي بعض الإرشادات:

  • إذا كانت جميع الطلبات الأخيرة تقريبًا من عملاء تم التحقق منهم ، ففكر في تمكين التنفيذ لبدء حماية موارد الواجهة الخلفية.

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

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

وظائف السحابة

بالنسبة إلى وظائف السحابة ، يمكنك الحصول على مقاييس التحقق من التطبيق عن طريق فحص سجلات وظائفك. يصدر كل استدعاء لوظيفة قابلة للاستدعاء إدخال سجل منظم مثل المثال التالي:

{
  "severity": "INFO",    // INFO, WARNING, or ERROR
  "logging.googleapis.com/labels": {"firebase-log-type": "callable-request-verification"},
  "jsonPayload": {
    "message": "Callable header verifications passed.",
    "verifications": {
      // ...
      "app": "MISSING",  // VALID, INVALID, or MISSING
    }
  }
}

يمكنك تحليل هذه المقاييس في Google Cloud Console عن طريق إنشاء مقياس عداد قائم على السجلات باستخدام مرشح المقاييس التالي:

resource.type="cloud_function"
resource.labels.function_name="YOUR_CLOUD_FUNCTION"
resource.labels.region="us-central1"
labels.firebase-log-type="callable-request-verification"

قم بتسمية المقياس باستخدام الحقل jsonPayload.verifications.appCheck .

5. تمكين الإنفاذ

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

قاعدة بيانات Realtime و Cloud Firestore والتخزين السحابي

لتمكين فرض تطبيق Realtime Database و Cloud Firestore (iOS و Android) والتخزين السحابي:

  1. افتح قسم فحص التطبيق في وحدة تحكم Firebase.

  2. قم بتوسيع عرض المقاييس للمنتج الذي تريد تمكين فرضه.

  3. انقر فوق فرض وقم بتأكيد اختيارك.

لاحظ أن الأمر قد يستغرق ما يصل إلى 15 دقيقة بعد تمكين التنفيذ حتى يتم تفعيله.

وظائف السحابة

راجع تمكين فرض التحقق من التطبيق لوظائف السحابة .

ملاحظة حول التكلفة

يُنشئ App Check تقييمًا نيابةً عنك للتحقق من صحة رمز استجابة المستخدم في كل مرة يقوم فيها متصفح يقوم بتشغيل تطبيق الويب الخاص بك بتحديث رمز التحقق من التطبيق الخاص به. سيتم تحميل مشروعك مقابل كل تقييم تم إنشاؤه فوق الحصة الخالية من التكلفة. راجع تسعير reCAPTCHA Enterprise للحصول على التفاصيل.

بشكل افتراضي ، سيعمل تطبيق الويب الخاص بك على تحديث هذا الرمز المميز مرتين كل ساعة . للتحكم في مدى تكرار تحديث تطبيقك لرموز التحقق من التطبيق (وبالتالي عدد المرات التي يتم فيها إنشاء التقييمات الجديدة) ، قم بتهيئة مدة البقاء (TTL ) الخاصة بهم.

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

إذا كنت ترغب ، بعد تسجيل تطبيقك في App Check ، في تشغيل التطبيق في بيئة لا يصنفها App Check عادةً على أنها صالحة ، مثل محليًا أثناء التطوير ، أو من بيئة تكامل مستمر (CI) ، يمكنك إنشاء بناء تصحيح أخطاء تطبيقك الذي يستخدم موفر تصحيح أخطاء App Check بدلاً من موفر تصديق حقيقي.

راجع استخدام التحقق من التطبيق مع موفر تصحيح الأخطاء في تطبيقات الويب .