Dodaj SDK do swojego projektu za pomocą preferowanego menedżera pakietów.
npm install expressyarn add expresspnpm add expressZacznij pracę z minimalną konfiguracją.
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 timeapp.post('/webhook/tracio', (req, res) => { const event = req.body console.log(event.visitorId, event.bot.result) res.status(200).send('OK')})app.listen(3000)Gotowe do produkcji wzorce z obsługą błędów, stanami ładowania i zaawansowaną konfiguracją.
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)Wszystkie dostępne opcje inicjalizacji i konfiguracji SDK.
publicKeystringTwój klucz publiczny z panelu — bezpieczny do umieszczenia w przeglądarceendpointstringNiestandardowy adres URL punktu końcowego dla wdrożeń kierowanych przez proxy — jawny URL ma pierwszeństwo przed regionemregionstringRegion danych: us lub eutimeoutMsnumberLimit czasu całego wywołania getResult(), w milisekundachlinkedIdstringTwój wewnętrzny identyfikator konta zalogowanego użytkownika, dzięki któremu wizyty z tego samego urządzenia można powiązaćtagstringDowolna etykieta dołączana do żądania identyfikacji, np. checkout lub logindebugbooleanLoguje cykl życia skryptu i aktywność sieciową w konsoli przeglądarkiscriptUrlstringPełne nadpisanie adresu URL skryptu agenta — do self-hostingu lub Subresource IntegrityZagłęb się dzięki pełnej dokumentacji API, konfiguracji webhooków i zaawansowanym przewodnikom.
Pełna dokumentacja API, przewodniki integracji i najlepsze praktyki.
Dostarczanie zdarzeń w czasie rzeczywistym, schemat ładunku i weryfikacja podpisu.
Skonfiguruj powiadomienia o zdarzeniach w czasie rzeczywistym dla każdej identyfikacji urządzenia.
Dodaj fingerprinting urządzeń do swojej aplikacji Node.js w mniej niż 5 minut.