Local List Mode

عندما يختار العملاء استخدام الإصدار 5 من "التصفّح الآمن من Google" في هذا الوضع، يكون سلوك العميل مشابهًا لواجهة برمجة التطبيقات Update API في الإصدار 4، باستثناء استخدام مساحة واجهة برمجة التطبيقات المحسّنة في الإصدار 5. سيحتفظ العملاء في قاعدة البيانات المحلية بمجموعة من قوائم التهديدات المنسَّقة كبادئات تجزئة SHA256 لتعبيرات عناوين URL الخاصة باللاحقة المضيفة/بادئة المسار. عندما يريد العميل التحقّق من عنوان URL معيّن، يتم إجراء عملية تحقّق باستخدام قائمة التهديدات المحلية. في حال العثور على تطابق فقط، يتصل العميل بالخادم لمواصلة عملية التحقّق.

كما هو الحال أعلاه، سيحتفظ العميل أيضًا بذاكرة تخزين مؤقت محلية لا يلزم أن تكون في مساحة تخزين دائمة.

إجراء التحقّق من عنوان URL في "قائمة التهديدات المحلية"

يتم تنفيذ هذا الإجراء أيضًا عندما يستخدم العميل إجراء وضع الوقت الفعلي ويعرض القيمة UNSURE.

يأخذ هذا الإجراء عنوان URL واحدًا u ويعرض SAFE أو UNSAFE.

1. لنفترض أنّ expressions هي قائمة بتعبيرات اللاحقة/البادئة التي تم إنشاؤها بواسطة عنوان URL u.
2. لنفترض أنّ expressionHashes هي قائمة، حيث تكون العناصر عبارة عن تجزئات SHA256 لكل تعبير في expressions.
3. لنفترض أنّ expressionHashPrefixes هي قائمة، حيث تكون العناصر هي أول 4 بايتات من كل قيمة تجزئة في expressionHashes.
4. لكل expressionHashPrefix من expressionHashPrefixes:
   1. ابحث عن expressionHashPrefix في ذاكرة التخزين المؤقت المحلية.
   2. في حال العثور على الإدخال المخزّن مؤقتًا:
      1. تحديد ما إذا كان الوقت الحالي أكبر من وقت انتهاء الصلاحية
      2. إذا كانت القيمة أكبر:
         1. أزِل الإدخال الذي تم العثور عليه في ذاكرة التخزين المؤقت من ذاكرة التخزين المؤقت المحلية.
         2. مواصلة التكرار الحلقي
      3. إذا لم يكن أكبر:
         1. إزالة expressionHashPrefix المحدّدة من expressionHashPrefixes
         2. تحقَّق ممّا إذا كان التجزئة الكاملة المقابلة ضمن expressionHashes متوفّرة في الإدخال المخزّن مؤقتًا.
         3. في حال العثور على نتيجة، أرجِع القيمة UNSAFE.
         4. إذا لم يتم العثور على السمة، استمر في التكرار.
   3. إذا لم يتم العثور على الإدخال المخزّن مؤقتًا، استمر في التكرار.
5. لكل expressionHashPrefix من expressionHashPrefixes:
   1. ابحث عن expressionHashPrefix في قاعدة بيانات قائمة التهديدات المحلية.
   2. إذا لم يتم العثور على expressionHashPrefix في قاعدة بيانات قائمة التهديدات المحلية، أزِلها من expressionHashPrefixes.
6. أرسِل expressionHashPrefixes إلى خادم الإصدار 5 من "التصفّح الآمن من Google" باستخدام RPC SearchHashes أو طريقة REST hashes.search. في حال حدوث خطأ (بما في ذلك أخطاء الشبكة وأخطاء HTTP وما إلى ذلك)، يجب عرض SAFE. بخلاف ذلك، يجب أن تكون الاستجابة هي response التي تم تلقّيها من خادم "التصفّح الآمن"، وهي عبارة عن قائمة بتجزئات كاملة بالإضافة إلى بعض المعلومات المساعدة التي تحدّد طبيعة التهديد (الهندسة الاجتماعية أو البرامج الضارة أو غير ذلك)، فضلاً عن وقت انتهاء صلاحية ذاكرة التخزين المؤقت expiration.
7. لكل fullHash من response:
   1. أدرِج fullHash في ذاكرة التخزين المؤقت المحلية، بالإضافة إلى expiration.
8. لكل fullHash من response:
   1. لنفترض أنّ isFound هي نتيجة العثور على fullHash في expressionHashes.
   2. إذا كانت قيمة isFound هي False، استمر في التكرار.
   3. إذا كانت isFound صحيحة، يتم عرض UNSAFE.
9. Return SAFE