Документация Noxtica

Добро пожаловать в документацию Noxtica. Noxtica — это платформа обнаружения ботов, которая помогает отличать реальных посетителей от автоматизированного и мошеннического трафика, чтобы вы могли защитить регистрацию, вход, оформление заказа и остальные части вашего продукта.

Что такое Noxtica?

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

Ключевые возможности

• Идентификация устройств: создавайте стабильный, уважающий конфиденциальность портрет каждого посетителя на основе широкого набора браузерных и устройственных сигналов
• Обнаружение ботов: выявляйте автоматизацию, headless-установки и посетителей, притворяющихся тем, чем они не являются, обнаруживая противоречия, которые они оставляют
• Откалиброванная оценка риска: получайте оценку риска 0–100, показатель уверенности и понятный уровень риска, на который можно реагировать
• API в реальном времени: получайте оценку риска посетителя с бэкенда за долю секунды
• Мультитенантность: управляйте несколькими сайтами и доменами из единого аккаунта

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

Быстрый старт

1. Получите Site Key

После регистрации войдите в Backoffice и добавьте свой домен. Вы получите Site Key (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;

Если в политике не хватает одной из этих строк, коллектор продолжит работу, но с более слабой защитой от вмешательства. Полную справку и решение проблем см. в разделе Начало работы → Content Security Policy.

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 в действии