Приём и проверка webhook-ов идентификации в Node.js и Express. Добавьте идентификацию посетителей, детекцию ботов и smart signals в своё приложение Node.js за минуты.
Добавьте SDK в свой проект с помощью предпочитаемого менеджера пакетов.
npm install expressyarn add expresspnpm add expressЗапуститесь с минимальной настройкой.
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)Готовые к продакшену паттерны с обработкой ошибок, состояниями загрузки и расширенной конфигурацией.
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)Все доступные опции для инициализации и настройки SDK.
publicKeystringВаш публичный ключ из дашборда — его безопасно отдавать в браузерendpointstringКастомный URL endpoint для развёртываний с проксированием — явный URL важнее regionregionstringРегион данных: us или eutimeoutMsnumberТаймаут всего вызова getResult(), в миллисекундахlinkedIdstringВаш внутренний ID аккаунта вошедшего пользователя, чтобы связывать визиты с одного устройстваtagstringПроизвольная метка для запроса идентификации, например checkout или logindebugbooleanПишет жизненный цикл скрипта и сетевую активность в консоль браузераscriptUrlstringПолная замена URL скрипта агента — для self-hosting или Subresource IntegrityУглубитесь с полным справочником API, настройкой webhook и продвинутыми руководствами.
Полный справочник API, руководства по интеграции и лучшие практики.
Доставка событий в реальном времени, схема payload и проверка подписи.
Настройте уведомления о событиях в реальном времени для каждой идентификации устройства.
Добавьте фингерпринтинг устройств в своё приложение Node.js менее чем за 5 минут.