أضِف إشارات VPN و Tor إلى تحديد الموقع الجغرافي للزائر

تعرَّف على متى يتطابق اتصال الزائر مع شبكة VPN معروفة، أو عقدة خروج Tor، أو شبكة مركز بيانات/استضافة، أو أي فئة شبكة أخرى مدعومة. تضيف Watch-IP هذه المؤشرات إلى استجابات GET /v1/geo المؤهَّلة حتى يتمكن تطبيقك من وزنها إلى جانب سياقات أخرى.

اطّلع على الخطط التي تتضمن حقل security اطّلع على مرجع geo →

الخطط المؤهَّلة

يُدرَج الحقل security ضمن خطط Starter و Growth و Scale و Enterprise. أما في خطة Free فيُحذَف كليًا من الاستجابة — ولا يُرسَل ككائن مُضلِّل تكون كل قيمه false — لذا تحقق من وجوده قبل قراءة أي حقل منه.

تختلف تغطية IPv4 عن IPv6

تُفحَص اتصالات IPv4 مقابل قوائم Tor و VPN ومراكز البيانات والتهديدات والشبكات الخاضعة للعقوبات. أما اتصالات IPv6 فتُفحَص مقابل كل ما سبق باستثناء Tor — إذ لا يتوفر حاليًا مصدر مجاني لقائمة عقد خروج Tor عبر IPv6، لذا تكون قيمة isTor دائمًا false لاتصال IPv6 بصرف النظر عمّا إذا كان فعليًا عقدة خروج Tor. لا تصف تغطية IPv6 على أنها معادلة لتغطية IPv4.

الحذف و false و true حالات مختلفة

يعني حذف كائن security أن خطتك لا تتضمن هذه البيانات، لا أن الاتصال فُحص وتبيَّن أنه نظيف. تعني القيمة false في حقل مُدرَج عدم وجود تطابق في القوائم المحمَّلة حاليًا لدى Watch-IP — وليست حكمًا مؤكَّدًا بالأمان، لأن الاكتشاف القائم على القوائم لا يمكنه رؤية كل شيء. لا تعرض أبدًا نتيجة غير مُقيَّمة أو false بوصفها "نظيف" أو "آمن" أو "موثَّق".

المصادر والتحديثات

تُجمَّع القوائم وراء هذه الحقول وتُخزَّن في مساحة التخزين الخاصة بنا، وتُحدَّث وفق جدول زمني. يحدث تأخير قصير عند بدء التشغيل البارد لعملية البحث الأولى؛ وبمجرد تحميلها، تُقدَّم الطلبات من ذاكرة تخزين مؤقت داخلية بينما يجري التحديث في الخلفية، لذا يؤدي تحديث بطيء أو فاشل إلى بيانات قديمة أو فارغة بدلًا من استجابة معطوبة.

مثال على تدفق عمل للمراجعة

عامل isVpn أو isDatacenter كأحد مدخلات قائمة انتظار المراجعة اليدوية إلى جانب سجل الحساب وإشارات أخرى، لا كأساس وحيد لحظر الزائر مباشرةً. على سبيل المثال، يُعد اقتران ذلك بفحص بريد إلكتروني مؤقت في حدث التسجيل نفسه طريقة معقولة لإحالة عدد صغير من التسجيلات إلى المراجعة بدلًا من رفض كل مستخدم VPN.

ما لا تفعله هذه الميزة

لا تُحدِّد هذه الحقول الوكلاء السكنيين (residential proxies)، ولا تتحقق من الهوية، وليست منتجًا شاملًا لاكتشاف التهديدات أو إخفاء الهوية — بل هي مجموعة صغيرة من المؤشرات القائمة على القوائم.

حقول استجابة الأمان

isTor: عقدة خروج Tor معروفة، من قائمة عقد خروج IPv4 المحمَّلة حاليًا. تكون دائمًا false لعناوين IPv6.
isVpn: شبكة مزوِّد VPN تجاري معروفة، لعناوين IPv4 و IPv6.
isDatacenter: شبكة مركز بيانات/استضافة — وهي مجموعة أشمل من VPN، لأن كثيرًا من عقد خروج VPN تعمل على بنية تحتية للاستضافة.
isThreat: ضمن نطاق عناوين IP ضارة معروف أو رقم نظام مستقل (ASN) معروف كتهديد، لعناوين IPv4 و IPv6.
isSanctionedNetwork: ضمن قائمة تحتفظ بها Watch-IP لمشغِّلي شبكات اتصالات/استضافة خاضعين لعقوبات حكومية، تُراجَع فصليًا — وهي إشارة أضعف وأقل ثقة من الحقول الأخرى، وليست فحص امتثال للعقوبات.

اقرأ حقول الأمان بأمان

جافاسكريبت المتصفح

const response = await fetch('https://api.watch-ip.com/v1/geo', {
  headers: { 'X-Api-Key': 'YOUR_PUBLISHABLE_KEY' },
});
const geo = await response.json();

if (!geo.security) {
  // خطتك لا تتضمن بيانات الأمان — لا تفترض أي شيء عن هذا الاتصال.
} else if (geo.security.isVpn || geo.security.isDatacenter) {
  // تطابق في القائمة — أحد مدخلات منطق المراجعة الخاص بك، لا حظرًا بذاته.
} else {
  // لا تطابق في القوائم المحمَّلة حاليًا — وهذا لا يضمن أن الاتصال آمن.
}

تفرَّع دائمًا بناءً على وجود `security` قبل قراءة أي حقل منه — فالكائن الغائب والحقل الموجود بقيمة false يحملان معنيين مختلفين.

الأسئلة الشائعة

هل تكتشف هذه الميزة الوكلاء السكنيين؟

لا. تغطي القوائم الحالية شبكات VPN التجارية المعروفة، و Tor، ومراكز البيانات، والشبكات الخاضعة للتهديد/العقوبات — وليس الفئة الأوسع من خدمات الوكلاء السكنيين، التي تمر عبر عناوين IP حقيقية لمستهلكين، وهي أصعب كثيرًا في المطابقة مع القوائم.

ماذا تعني القيمة false؟

تعني عدم وجود تطابق في القوائم المحمَّلة حاليًا لدى Watch-IP. وهي ليست تأكيدًا إيجابيًا بأن الاتصال آمن، لأن أي قائمة لا يمكنها تغطية كل شبكة VPN أو عقدة خروج أو شبكة ضارة موجودة.

هل تُغطى Tor عبر IPv6؟

لا. تكون قيمة isTor دائمًا false لاتصال IPv6 حاليًا — إذ لا يتوفر مصدر مجاني لقائمة عقد خروج Tor عبر IPv6 في التطبيق الحالي. أما بقية الحقول فتُغطي IPv6.

هل تتوفر هذه الفحوصات لأي عنوان IP؟

ليس حاليًا. هذه البيانات جزء من استجابة GET /v1/geo الخاصة بالمتصفح المتصل فقط؛ ولا تُعيد نقاط نهاية البحث عن عنوان IP المنفصلة (/v1/lookup) كائن security.

هل يمكنني الحظر بالاعتماد على إشارة واحدة فقط؟

يمكنك ذلك، لكن إشارة واحدة قائمة على قائمة تُعد أساسًا ضعيفًا للحظر التلقائي بمفردها — فالنتائج الإيجابية الكاذبة تحدث، ويستخدم مستخدمون شرعيون شبكات VPN والشبكات المشتركة لأسباب عادية. تستخدم معظم عمليات الدمج هذه الحقول كأحد مدخلات قرار المراجعة.