مستندات Noxtica
به مستندات Noxtica خوش آمدید. Noxtica یک پلتفرم تشخیص ربات است که به شما کمک میکند بازدیدکنندگان واقعی را از ترافیک خودکار و تقلبی تشخیص دهید — تا بتوانید ثبتنام، ورود، پرداخت، و بقیه محصولتان را محافظت کنید.
Noxtica چیست؟
Noxtica به سیگنالهای کوچک زیادی که مرورگر و دستگاه هر بازدیدکننده بهطور طبیعی تولید میکند نگاه میکند، سپس آنها را برای سازگاری بررسی میکند تا رباتها، ابزارهای اتوماسیون، و رفتار مشکوک را شناسایی کند. کاربران واقعی یک تصویر منسجم به جا میگذارند؛ جعلکاران تناقض به جا میگذارند.
قابلیتهای کلیدی
- شناخت دستگاه: یک تصویر پایدار و حریمخصوصیدوستانه از هر بازدیدکننده از طیف گستردهای از سیگنالهای مرورگر و دستگاه بسازید
- تشخیص ربات: اتوماسیون، راهاندازیهای بدون رابط کاربری، و بازدیدکنندگانی که وانمود میکنند چیزی هستند که نیستند را با شناسایی تناقضهایی که به جا میگذارند بگیرید
- امتیازدهی ریسک کالیبرهشده: یک امتیاز ریسک ۰ تا ۱۰۰، یک سطح اطمینان، و یک درجه ریسک به زبان ساده که میتوانید روی آن عمل کنید دریافت کنید
- API بلادرنگ: ریسک بازدیدکننده را از بکاندتان در کمتر از یکدهم ثانیه جستوجو کنید
- چند-tenant: چند سایت و دامنه را از یک حساب واحد مدیریت کنید
اجزای پلتفرم
| جزء | توضیح |
|---|---|
| Collector SDK | یک قطعه کد JavaScript کوچک که به وبسایتتان اضافه میکنید |
| Collector API | یک سرویس توزیعشده جهانی که بازدیدکنندگان را فوری امتیازدهی میکند |
| Backoffice | داشبورد مدیریت برای آنالیتیکس، کلیدهای API، و پیکربندی |
| Server API | یک API ساده برای جستوجوی ریسک بازدیدکننده از بکاندتان |
شروع سریع
۱. Site Key خود را دریافت کنید
بعد از ثبتنام، وارد بکآفیس شوید و دامنهتان را اضافه کنید. یک Site Key دریافت خواهید کرد (pk_prod_...).
۲. کالکتور را اضافه کنید
کالکتور را در وبسایتتان جاسازی کنید:
<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>سیاست امنیت محتوا
اگر سایتتان از سیاست امنیت محتوا استفاده میکند، باید به 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;اگر سیاست یکی از اینها را نداشته باشد، کالکتور به کار ادامه میدهد اما با حفاظت ضعیفتر در برابر دستکاری. برای مرجع کامل و رفع اشکال به بخش شروع سریع ← سیاست امنیت محتوا مراجعه کنید.
۳. امتیازهای ریسک دریافت کنید
کالکتور یک ارزیابی ریسک را بهصورت بلادرنگ تحویل میدهد:
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);
});۴. جستوجوهای سمت سرور (اختیاری)
برای تصمیمات سمت سرور، یک کلید API ایجاد کنید و دستگاهها را جستوجو کنید:
curl -H "Authorization: Bearer sk_prod_your_api_key" \
"https://collect.noxtica.com/v1/device/DEVICE_ID"راهنماها
- شروع سریع: راهنمای کامل راهاندازی شامل گزینههای SDK و پیکربندی
- محیط اجرایی مرورگر: نحوه کار SDK در مرورگر، ذخیره موقت، رویدادها، و رفع اشکال
- یکپارچهسازی بکاند: یکپارچهسازی API سمت سرور برای جستوجوهای بازدیدکننده
سطوح ریسک
هر بازدیدکننده یک سطح ریسک به زبان ساده بر اساس امتیازش دریافت میکند، تا تیمتان بدون خواندن ریز چاپ بتواند عمل کند:
| امتیاز | سطح | معنی |
|---|---|---|
| ۰-۱۹ | minimal | رفتار عادی، بدون پرچم قرمز |
| ۲۰-۳۹ | low | ناهنجاریهای جزئی شناسایی شد |
| ۴۰-۵۹ | medium | برخی سیگنالهای مشکوک |
| ۶۰-۷۹ | high | احتمالاً اتوماسیون یا جعل |
| ۸۰-۱۰۰ | critical | نشانههای قوی ربات |
دمو زنده
روی خودتان اثرانگشت را امتحان کنید: دمو زنده
داشبورد
حساب خود را مدیریت کنید: بکآفیس
در یک نگاه
- نسخه SDK: 3.2.0 (Schema: 2026-01-10)
- استقرار: توزیعشده جهانی برای تأخیر پایین در همه جا
- تأخیر: بازدیدکنندگان در کمتر از یکدهم ثانیه امتیازدهی میشوند
- احراز هویت: بهطور خودکار توسط SDK مدیریت میشود — چیزی برای مدیریت نیست
- فاصله پیشفرض جمعآوری: ۷ روز (قابل پیکربندی)
پشتیبانی
- تماس: با ما تماس بگیرید برای پشتیبانی یا استعلام فروش
- درخواست دمو: درخواست دمو دهید تا Noxtica را در عمل ببینید