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
| Componente | Descrizione |
|---|---|
| Collector SDK | Un piccolo snippet JavaScript che aggiungi al tuo sito |
| Collector API | Un servizio distribuito globalmente che valuta i visitatori istantaneamente |
| Backoffice | Dashboard di amministrazione per analytics, API key e configurazione |
| Server API | Una 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:
| Punteggio | Livello | Significato |
|---|---|---|
| 0-19 | minimal | Comportamento normale, nessun segnale di allarme |
| 20-39 | low | Rilevate anomalie minori |
| 40-59 | medium | Alcuni segnali sospetti |
| 60-79 | high | Probabile automazione o spoofing |
| 80-100 | critical | Forti 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
- Contatto: contattaci per supporto o richieste commerciali
- Richiesta demo: richiedi una demo per vedere Noxtica in azione