Questa traduzione è generata automaticamente ed è in attesa di revisione. Passa all'inglese
Dashboard

Documentazione di Noxtica

Benvenuto nella documentazione di Noxtica. Noxtica è una piattaforma di rilevamento bot che ti aiuta a distinguere i visitatori reali dal traffico automatizzato e fraudolento — così puoi proteggere le registrazioni, i login, il checkout e il resto del tuo prodotto.

Cos’è Noxtica?

Noxtica analizza i tanti piccoli segnali che il browser e il dispositivo di ogni visitatore producono naturalmente, poi li verifica per coerenza per individuare bot, strumenti di automazione e comportamenti sospetti. Gli utenti reali lasciano un quadro coerente; i falsificatori lasciano contraddizioni.

Funzionalità Principali

  • Riconoscimento del dispositivo: costruisce un quadro stabile e rispettoso della privacy di ogni visitatore a partire da un’ampia gamma di segnali del browser e del dispositivo
  • Rilevamento bot: individua automazione, configurazioni headless e visitatori che fingono di essere qualcosa che non sono rilevando le contraddizioni che lasciano
  • Punteggio di rischio calibrato: ottieni un punteggio di rischio da 0 a 100, un livello di confidenza e un livello di rischio in linguaggio chiaro su cui puoi agire
  • API in tempo reale: consulta il rischio di un visitatore dal tuo backend in ben meno di un decimo di secondo
  • Multi-tenant: gestisci più siti e domini da un unico account

Componenti della Piattaforma

ComponenteDescrizione
Collector SDKUn piccolo snippet JavaScript che aggiungi al tuo sito
Collector APIUn servizio distribuito globalmente che valuta i visitatori istantaneamente
BackofficeDashboard di amministrazione per analytics, API key e configurazione
Server APIUna semplice API per consultare il rischio dei visitatori dal tuo backend

Avvio Rapido

1. Ottieni la tua Site Key

Dopo la registrazione, accedi al Backoffice e aggiungi il tuo dominio. Riceverai una Site Key (pk_prod_...).

2. Aggiungi il Collector

Incorpora il collector nel tuo sito:

<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

Se il tuo sito usa una content-security-policy, dovrai consentire a Noxtica di caricarsi ed eseguirsi. Lo snippet qui sotto copre tutto ciò di cui il collector ha bisogno — incluso il suo runtime a prova di manomissione, il 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;

Se alla policy manca uno di questi elementi, il collector continua a funzionare ma con una protezione anti-manomissione più debole. Consulta la sezione Getting Started → Content Security Policy per il riferimento completo e la risoluzione dei problemi.

3. Ricevi i Punteggi di Rischio

Il collector ti fornisce una valutazione del rischio in tempo reale:

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. Consultazioni Lato Server (Opzionale)

Per le decisioni lato server, crea una API key e interroga i dispositivi:

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

Guide

  • Getting Started: guida completa di configurazione, incluse le opzioni SDK e la configurazione
  • Browser Runtime: come l’SDK funziona nel browser, caching, eventi e risoluzione dei problemi
  • Backend Integration: integrazione API lato server per le consultazioni dei visitatori

Livelli di Rischio

Ogni visitatore riceve un livello di rischio in linguaggio chiaro basato sul suo punteggio, così il tuo team può agire senza leggere le note a piè di pagina:

PunteggioLivelloSignificato
0-19minimalComportamento normale, nessun segnale di allarme
20-39lowRilevate anomalie minori
40-59mediumAlcuni segnali sospetti
60-79highProbabile automazione o spoofing
80-100criticalForti indicatori di bot

Demo Live

Prova il fingerprinting su te stesso: Live Demo

Dashboard

Gestisci il tuo account: Backoffice

In Sintesi

  • Versione SDK: 3.2.0 (Schema: 2026-01-10)
  • Distribuzione: globalmente distribuita per bassa latenza ovunque
  • Latenza: visitatori valutati in ben meno di un decimo di secondo
  • Autenticazione: gestita automaticamente dall’SDK — nulla da gestire
  • Intervallo di raccolta predefinito: 7 giorni (configurabile)

Supporto