Дакументацыя Noxtica

Вітаем у дакументацыі Noxtica. Noxtica — гэта платформа выяўлення ботаў, якая дапамагае адрозніць рэальных наведвальнікаў ад аўтаматызаванага і махлярскага трафіку, каб вы маглі абараняць рэгістрацыю, уваход, аплату і ўсё астатняе.

Што такое Noxtica?

Noxtica аналізуе мноства дробных сігналаў, якія натуральным чынам выпускаюць браўзер і прылада кожнага наведвальніка, і правярае іх на паслядоўнасць, каб выявіць ботаў, інструменты аўтаматызацыі і падазроныя паводзіны. Рэальныя карыстальнікі пакідаюць цэласную карціну; падробшчыкі пакідаюць супярэчнасці.

Ключавыя магчымасці

• Распазнаванне прылад: фармуйце стабільны, паважаючы прыватнасць партрэт кожнага наведвальніка на аснове шырокага набору браўзерных і апаратных сігналаў
• Выяўленне ботаў: лоўце аўтаматызацыю, безгаловыя наладкі і наведвальнікаў, якія выдаюць сябе за кагосьці іншага, выяўляючы пакінутыя імі супярэчнасці
• Калібраваная ацэнка рызыкі: атрымлівайце адзнаку рызыкі ад 0 да 100, узровень упэўненасці і зразумелы маўны ўзровень рызыкі, на які можна арыентавацца
• API у рэальным часе: праводзіце запыты рызыкі наведвальніка з вашага бэкэнда менш чым за дзясятую частку секунды
• Мультыарэнда: кіруйце некалькімі сайтамі і даменамі з аднаго ўліковага запісу

Кампаненты платформы

Хуткі старт

1. Атрымайце свой Site Key

Пасля рэгістрацыі ўвайдзіце ў Backoffice і дадайце свой дамен. Вы атрымаеце Site Key (pk_prod_...).

2. Дадайце Collector

Убудуйце collector на ваш сайт:

<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

Калі ваш сайт выкарыстоўвае content-security-policy, вам трэба дазволіць Noxtica загружацца і выконвацца. Фрагмент ніжэй ахоплівае ўсё, што патрэбна collector — уключаючы яго ўстойлівае да ўмяшання асяроддзе выканання, 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;

Калі ў палітыцы адсутнічае адна з гэтых дырэктыў, collector будзе працаваць, але са слабейшай абаронай ад умяшання. Гл. раздзел Пачатак працы → Content Security Policy для поўнага даведніка і ўказанняў па ліквідацыі непаладак.

3. Атрымлівайце адзнакі рызыкі

Collector перадае ацэнку рызыкі ў рэальным часе:

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 у дзеянні