أمان Watch-IP والتعامل مع مفاتيح الواجهة البرمجية
تصف هذه الصفحة ضوابط الوصول المطبَّقة فعليًا في واجهة Watch-IP البرمجية اليوم: كيفية عمل نوعي المفاتيح، وكيفية تطبيق قيود نطاق المصدر، وكيفية تدوير المفاتيح أو إلغائها، وكيفية الإبلاغ عن مشكلة أمنية. لا تدّعي هذه الصفحة الحصول على شهادة امتثال أو تدقيق أمني مستقل — لم يتم إجراء أي منهما حتى وقت كتابة هذا النص.
نوعان من المفاتيح، وضابطان مختلفان
صُممت المفاتيح القابلة للنشر (المستخدَمة في GET /v1/geo و POST /v1/email/validate) لتعمل داخل كود المتصفح وهي ليست سرية — والضابط الفعلي هو قائمة نطاقات المصدر المسموح بها المُهيَّأة للمفتاح، والتي تُفحص مقابل ترويسة Origin/Referer الخاصة بالطلب. أما المفاتيح السرية (المستخدَمة في GET/POST /v1/lookup و POST /v1/risk/check) فهي بيانات اعتماد من خادم إلى خادم دون أي فحص لنطاق المصدر إطلاقًا، لعدم وجود ترويسة Origin من متصفح في استدعاء الخلفية؛ عامل المفتاح السري معاملة كلمة مرور قاعدة بيانات، لا كمعرِّف علني. راجع صفحة المصادقة لمعرفة صيغة الطلب التي يتوقعها كل نوع من المفاتيح.
كيف يُطبَّق التقييد بنطاق المصدر
أي طلب بمفتاح قابل للنشر من نطاق مصدر غير مدرَج في قائمة المفتاح المسموح بها يتلقى استجابة 403 دون تعيين ترويسة Access-Control-Allow-Origin. إن قيام المتصفح بحجب تلك الاستجابة قبل أن تتمكن جافاسكريبت صفحتك من قراءتها هو التطبيق الفعلي للضابط — أما نص الخطأ بصيغة JSON فهو ثانوي. التقييد بنطاق المصدر لا يجعل المفتاح نفسه سريًا، ولا يمنع عميلًا غير متصفح من إرسال ترويسة Origin مزوَّرة؛ فهو يحمي تحديدًا سطح الاستدعاءات من المتصفح.
النقل والتخزين
تُشفَّر حركة البيانات إلى الواجهة البرمجية ولوحة التحكم أثناء النقل (TLS/HTTPS)؛ ولا تقبل الواجهة البرمجية طلبات HTTP غير مشفَّرة للطلبات المصادَق عليها بمفتاح. تُخزَّن مفاتيح الواجهة البرمجية بصيغة تجزئة (SHA-256)، لا كنص صريح، بحيث لا يؤدي اختراق قاعدة البيانات وحده إلى كشف قيم مفاتيح قابلة للاستخدام.
التدوير والإلغاء
يمكنك إلغاء مفتاح أو تدويره من لوحة التحكم. الإلغاء ليس فوريًا في كل مكان: تُخزَّن صلاحية المفتاح مؤقتًا لمدة تصل إلى 5 دقائق بعد عملية بحث، لذا قد يظل المفتاح الملغى مقبولًا لمدة تصل إلى 5 دقائق بعد إلغائه — ضع ذلك في الاعتبار عند تقدير سرعة قطع الوصول بعد اشتباه في اختراق، وبادِر بتدوير المفتاح بدلًا من الاعتماد على الإلغاء وحده في حادثة حساسة زمنيًا.
حد المعدل
يخضع كل مفتاح لحد معدل لكل حساب عميل ضمن نافذة ثابتة مدتها دقيقة واحدة، تُشارَك بين أي نقاط نهاية تستدعيها — وليست ميزانية مخصصة لكل مسار. يحد هذا من الضرر الذي يمكن أن يُحدثه مفتاح واحد مسرَّب أو يُساء استخدامه خلال نافذة قصيرة، رغم أنه ليس بديلًا عن تدوير مفتاح تم اختراقه.
الإبلاغ عن مشكلة أمنية
راسلنا على security@watch-ip.com إذا كنت تعتقد أن أحد المفاتيح قد تم اختراقه أو عثرت على مشكلة أمنية في الواجهة البرمجية أو لوحة التحكم. لا نُشغِّل حاليًا برنامج مكافآت اكتشاف الثغرات العلني ولا نحمل شهادة أمنية من جهة خارجية — وإذا تغيّر ذلك، فستذكر هذه الصفحة الأمر بتاريخ محدد، لا بشارة رمزية.