How It Works

TRACIO este un sistem de identificare client-server. Clientul colectează semnale din browser și le trimite către server, care calculează un identificator de vizitator stabil, execută algoritmi de detecție și returnează rezultate îmbogățite. Această secțiune explică fiecare etapă a pipeline-ului.

Prezentare generală a arhitecturii

Browser                              TRACIO Cloud
  |                                      |
  |-- Tracio.init({ publicKey }) ---------> |  (init, no network)
  |                                      |
  |-- tracio.getResult() ----------------> |
  |   1. Collect 130+ browser signals    |
  |   2. Encrypt (XOR + deflate + B64)   |
  |   3. POST to ingress endpoint        |
  |                                      |
  |                                      |-- Decrypt & extract signals
  |                                      |-- Compute visitor ID (MurmurHash3-128)
  |                                      |-- Run bot detection (weighted scoring)
  |                                      |-- Run smart signals (server-side enrichment)
  |                                      |-- Run IP intelligence (VPN/proxy/Tor)
  |                                      |-- Store visit event
  |                                      |
  |<-- JSON response ------------------- |
  |    visitorId, confidence,            |
  |    bot detection, smart signals      |
  |                                      |
  |-- Store visitor cookie (_vid_t) -----> |  (365-day persistence)

Etapa 1: Colectarea semnalelor

Când este apelat tracio.getResult(), clientul colectează peste 130 de semnale distincte din browser, organizate pe niveluri (tiers). Colectarea folosește un pipeline multifazic cu Web Workers și iframe-uri partajate pentru performanță.

Categorii de semnale

Pipeline-ul de colectare

Pipeline-ul de colectare rulează în patru etape pentru a minimiza blocarea firului principal (main thread):

1. Etapa 1 (Immediate): Semnale cu prioritate ridicată, rapid de colectat (proprietăți navigator, screen, fus orar). Sonda TURN pornește tot aici, deoarece rulează concomitent.

2. Etapa 2 (Idle Callback): Semnale sincrone care beneficiază de o perioadă de inactivitate (CSS media queries, sonde de storage, teste de cookie-uri).

3. Etapa 3 (Async): Semnale care necesită API-uri asincrone sau rendering (canvas, WebGL, audio fingerprint, detecția fonturilor, randare emoji).

4. Web Worker: Colectarea izolată a semnalelor într-un fir dedicat (detecția caracteristicilor WASM, doNotTrack).

Un iframe ascuns partajat este creat o singură dată și reutilizat de mai mulți colectori (emoji, MathML, culori de sistem, fonturi, screen frame) pentru a evita costul creării de iframe-uri separate pentru fiecare semnal.

Formatul semnalului

Fiecare semnal urmează o structură consistentă:

interface Signal<T> {
  s: number // Status code
  v: T // Value (when successful)
}

Coduri de stare:

Etapa 2: Transport criptat

Semnalele colectate sunt serializate în JSON, apoi criptate și comprimate înainte de transmitere:

1. Serializare JSON: Toate valorile semnalelor sunt împachetate într-un obiect JSON cu chei pe semnal, plus câmpuri de metadate (c pentru cheia API, t pentru tag, lid pentru linked ID).

2. Compresie: Dacă payload-ul depășește 1024 de octeți, este comprimat cu CompressionStream("deflate-raw").

3. Criptare XOR: Payload-ul este împachetat într-un plic de criptare:

   • Un octet de cheie XOR aleatoriu
   • Octeți de antet (markeri de validare)
   • Padding aleatoriu (0-3 octeți)
   • O mască XOR de 9 octeți
   • Payload-ul aplicat XOR cu masca repetitivă

4. Codare Base64: Payload-ul criptat este codat Base64url și trimis ca body al cererii POST.

Cererea este trimisă către endpoint-ul de ingress cu parametri de query pentru versiunea clientului și cheia API. Credențialele CORS sunt incluse pentru a trimite cookie-uri first-party.

Etapa 3: Procesare pe partea de server

Serverul primește payload-ul criptat și îl procesează prin mai multe subsisteme:

Extracția semnalelor

Serverul decodează plicul XOR, decomprimă dacă este necesar și parsează datele JSON ale semnalelor. Codul de stare și valoarea fiecărui semnal sunt extrase și validate.

Calculul ID-ului de vizitator

ID-ul de vizitator este calculat folosind o abordare de hashing pe niveluri (tiered hashing) (V3):

Tier 1 (Frozen): 20 base62 characters
  - Stable hardware signals that rarely change
  - Canvas, WebGL renderer, audio fingerprint, fonts
  - Provides long-term visitor identity

Tier 2 (Semi-stable): 10 base62 characters
  - Signals that change with browser updates
  - User-Agent data, Client Hints, plugins
  - Extensible without breaking Tier 1

Tier 3 (Volatile): 10 base62 characters
  - Signals that change frequently
  - Screen resolution, timezone, language
  - Used for confidence scoring, not identity

Fiecare nivel extrage semnalele care îi sunt atribuite, construiește un șir canonic și îl aplică hash cu MurmurHash3-x64-128. Cele trei hash-uri de nivel sunt concatenate și codate în base62 pentru a produce ID-ul final de vizitator.

Scorul de încredere (confidence)

Scorul de încredere (de la 0.0 la 1.0) indică cât de sigur este sistemul că acest vizitator a fost identificat corect:

• Potrivire cookie (1.0): Dacă cookie-ul criptat _vid_t se potrivește, încrederea este maximă.
• Prima vizită (0.90): Vizitatorii noi, fără înregistrare anterioară, pornesc de la 0.90.
• Vizitator recurent: Încrederea este calculată din ponderarea frecvenței semnalelor (bazată pe IDF) și potrivirea fuzzy față de fingerprint-urile stocate, folosind distanța Hamming la nivel de bit.

Bot Detection

Motorul de detecție a boților rulează mai mulți detectori ale căror rezultate ponderate sunt combinate într-un bot score (praguri: bot ≥ 0.70, suspicious ≥ 0.30; un semnal de tip hard-fail forțează un verdict de bot). Printre detectorii care contribuie se numără:

1. Verificarea flag-ului webdriver (prioritate maximă)
2. Analiza compozită a semnalelor de automatizare
3. Potrivirea UA a boților buni + verificarea IP (reverse DNS)
4. Detecția browserelor headless (11 markeri, prag 2+)
5. Detecția anomaliilor de eval length
6. Potrivirea tiparelor UA ale boților răi
7. Clasificarea framework-urilor de automatizare (Puppeteer, Playwright, Cypress, Selenium)
8. Detecția VM (VMware, VirtualBox, Parallels, QEMU, Hyper-V)
9. Detecția emulatoarelor (scoring pentru emulatoare mobile)
10. Detecția Frida/instrumentare
11. Detecția DevTools
12. Clasificarea browserelor de confidențialitate (Tor, Brave, Firefox ETP, Safari ITP)
13. Detecția aplicațiilor clonate
14. Analiza comportamentală (rată/entropie/interacțiune)

Îmbogățirea cu smart signals

Semnalele de îmbogățire pe partea de server sunt calculate din datele brute ale semnalelor și din IP intelligence. Acestea includ detecția VPN/proxy/Tor, geolocalizarea IP, analiza tampering-ului browserului și suspect scoring.

IP Intelligence

Subsistemul IP intelligence oferă:

• VPN / Proxy / Tor / Datacenter: clasificate pe baza IP-ului conectat, folosind baze de date comerciale de IP intelligence (IP2Location)
• Geolocalizare: acuratețe la nivel de oraș și ASN prin MaxMind GeoIP2

Etapa 4: Răspuns

Serverul returnează un răspuns JSON care conține:

{
  "visitorId": "X7fh2Hg9LkMn3pQr",
  "bot": {
    "detected": false,
    "confidence": 2,
    "reasons": []
  }
}

Acesta este rezultatul la care se rezolvă tracio.getResult() în browser. Evenimentul complet și îmbogățit — inclusiv bot_result-ul canonic (human / bot / uncertain), geolocalizarea și smart signals — este livrat pe partea de server prin webhooks și afișat în dashboard.

Clientul stochează un token de vizitator atât într-un cookie first-party (expirare la 365 de zile, SameSite=Lax), cât și în localStorage pentru persistență între sesiuni.

Rezumatul fluxului de date

Round-trip total: De obicei 80-300ms, în funcție de condițiile de rețea și de capacitățile browserului.