توثيق Noxtica

مرحباً بك في توثيق Noxtica. Noxtica منصة للكشف عن البوتات تساعدك على التمييز بين الزوار الحقيقيين وحركة المرور الآلية والاحتيالية — لتتمكن من حماية التسجيل وتسجيل الدخول والدفع وسائر مسارات منتجك.

ما هي Noxtica؟

تنظر Noxtica في الإشارات الصغيرة الكثيرة التي ينتجها متصفح كل زائر وجهازه بشكل طبيعي، ثم تتحقق من اتساقها لكشف البوتات وأدوات الأتمتة والسلوك المشبوه. المستخدمون الحقيقيون يتركون صورة متسقة؛ المزيّفون يتركون تناقضات.

القدرات الرئيسية

• التعرف على الجهاز: بناء صورة مستقرة وتحترم الخصوصية لكل زائر من مجموعة واسعة من إشارات المتصفح والجهاز
• كشف البوتات: التقاط الأتمتة والإعدادات الخفية والزوار الذين ينتحلون هويات أخرى عبر رصد التناقضات التي يتركونها
• تقييم الخطر المُعايَر: الحصول على درجة خطر من 0 إلى 100 ومستوى ثقة ومستوى خطر بلغة واضحة يمكن التصرف بناءً عليها
• API فوري: الاستعلام عن خطر الزائر من خادمك الخلفي في أجزاء من العُشر ثانية
• متعدد المواقع: إدارة عدة مواقع ونطاقات من حساب واحد

مكونات المنصة

بداية سريعة

1. احصل على مفتاح موقعك

بعد التسجيل، سجّل الدخول إلى Backoffice وأضف نطاقك. ستحصل على مفتاح الموقع (pk_prod_...).

2. أضف الجامع

ضمّن الجامع في موقعك:

<script
	src="https://collect.noxtica.com/collector/noxtica.js"
	data-site-key="pk_prod_your_site_key_here"
	data-auto-init
	data-auto-check-once
	async
></script>

سياسة أمان المحتوى

إذا كان موقعك يستخدم سياسة أمان محتوى (content-security-policy)، فستحتاج إلى السماح لـ Noxtica بالتحميل والتشغيل. المقطع أدناه يغطي كل ما يحتاجه الجامع — بما في ذلك بيئة تشغيله المقاومة للعبث، KHAN VM.

Content-Security-Policy:
  default-src 'self';
  script-src 'self' 'wasm-unsafe-eval' https://collect.noxtica.com;
  connect-src 'self' https://collect.noxtica.com;

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

3. استقبل درجات الخطر

يمرّر لك الجامع تقييم الخطر في الوقت الفعلي:

document.addEventListener('noxtica:collected', function (e) {
	console.log('Risk Score:', e.detail.score);
	console.log('Risk Level:', e.detail.risk_level);
	console.log('Flags:', e.detail.flags);
});

4. الاستعلامات من جانب الخادم (اختياري)

للقرارات على الخادم، أنشئ مفتاح API واستعلم عن الأجهزة:

curl -H "Authorization: Bearer sk_prod_your_api_key" \
  "https://collect.noxtica.com/v1/device/DEVICE_ID"

الأدلة

• البدء: دليل إعداد كامل يشمل خيارات SDK والإعدادات
• بيئة تشغيل المتصفح: كيف يعمل SDK داخل المتصفح، والتخزين المؤقت، والأحداث، واستكشاف الأخطاء
• تكامل الخادم الخلفي: تكامل API من جانب الخادم للاستعلام عن خطر الزوار

مستويات الخطر

كل زائر يحصل على مستوى خطر بلغة واضحة بناءً على درجته، حتى يتمكن فريقك من التصرف دون الحاجة لقراءة التفاصيل الدقيقة:

عرض حي

جرّب أخذ بصمة لنفسك: العرض الحي

لوحة التحكم

أدِر حسابك: Backoffice

نظرة عامة

• إصدار SDK: 3.2.0 (Schema: 2026-01-10)
• التوزيع: موزع عالمياً لتأخير منخفض في كل مكان
• التأخير: تقييم الزوار في أجزاء من العُشر ثانية
• المصادقة: تديرها SDK تلقائياً — لا شيء تديره
• فترة الجمع الافتراضية: 7 أيام (قابلة للتعديل)

الدعم

• التواصل: تواصل معنا للاستفسارات الخاصة بالدعم أو المبيعات
• طلب عرض: اطلب عرضاً توضيحياً لترى Noxtica أثناء العمل