Node.js

Intelligence dei dispositivi per Node.js

Riceve e verifica i webhook di identificazione in Node.js ed Express. Aggiunga identificazione dei visitatori, bot detection e smart signals alla sua applicazione Node.js in pochi minuti.

Inizi Prenoti una demo

Installazione rapida

Aggiunga l'SDK al suo progetto con il gestore di pacchetti che preferisce.

npmnpm install express

yarnyarn add express

pnpmpnpm add express

Utilizzo di base

Diventi operativo con la configurazione minima.

$typescript

import express from 'express'
const app = express()
// Capture the raw body so the signature can be verified byte-for-byte.
app.use(express.json({ verify: (req, _res, buf) => ((req as any).rawBody = buf) }))
// Identification events are pushed here in real time
app.post('/webhook/tracio', (req, res) => {
  const event = req.body
  console.log(event.visitorId, event.bot.result)
  res.status(200).send('OK')
})
app.listen(3000)

Pattern avanzati

Pattern pronti per la produzione con gestione degli errori, stati di caricamento e configurazione avanzata.

Gestore Express con verifica della firma — Clicchi per espandere

import express from 'express'
import crypto from 'crypto'
const app = express()
app.use(express.json({ verify: (req, _res, buf) => ((req as any).rawBody = buf) }))
// Recompute the HMAC-SHA256 over "<t>.<rawBody>" and compare it.
function verify(rawBody: Buffer, header: string, secret: string): boolean {
  const p = Object.fromEntries(header.split(',').map((kv) => kv.split('=') as [string, string]))
  const signed = Buffer.concat([Buffer.from(`${p.t}.`), rawBody])
  const expected = crypto.createHmac('sha256', secret).update(signed).digest('hex')
  const a = Buffer.from(p.v1, 'hex')
  const b = Buffer.from(expected, 'hex')
  return a.length === b.length && crypto.timingSafeEqual(a, b)
}
app.post('/webhook/tracio', (req, res) => {
  const sig = req.headers['x-tracio-signature'] as string
  if (!verify((req as any).rawBody, sig, process.env.TRACIO_WEBHOOK_SECRET!)) {
    return res.status(401).json({ error: 'Invalid signature' })
  }
  const event = req.body
  if (event.bot.result === 'bot') {
    return res.status(200).json({ action: 'blocked', visitorId: event.visitorId })
  }
  if (event.decision.riskScore > 50) {
    return res.status(200).json({ action: 'review', visitorId: event.visitorId })
  }
  res.status(200).json({ action: 'allow', visitorId: event.visitorId })
})
app.listen(3000)

Opzioni di configurazione

Tutte le opzioni disponibili per inizializzare e configurare l'SDK.

publicKeystringLa sua chiave pubblica dalla dashboard — può essere distribuita nel browser in sicurezza

endpointstringURL endpoint personalizzato per i deployment instradati tramite proxy — un URL esplicito prevale su region

regionstringRegione dati: us o eu

timeoutMsnumberTimeout dell'intera chiamata getResult(), in millisecondi

linkedIdstringIl suo ID account interno per l'utente autenticato, così le visite che condividono un dispositivo possono essere collegate

tagstringEtichetta libera associata alla richiesta di identificazione, es. checkout o login

debugbooleanRegistra il ciclo di vita dello script e l'attività di rete nella console del browser

scriptUrlstringOverride completo dell'URL dello script agent — per self-hosting o Subresource Integrity

Prossimi passi

Approfondisca con il riferimento API completo, la configurazione dei webhook e le guide avanzate.

Documentazione

Riferimento API completo, guide all'integrazione e best practice.

Legga la documentazione

Webhook

Recapito degli eventi in tempo reale, schema del payload e verifica della firma.

Veda i webhook