Node.js

Device Intelligence для Node.js

Отримуйте та перевіряйте вебхуки ідентифікації у Node.js та Express. Додайте ідентифікацію відвідувачів, виявлення ботів і smart signals до вашого застосунку Node.js за лічені хвилини.

Почати роботу Замовити демо

Швидке встановлення

Додайте SDK до свого проєкту за допомогою улюбленого менеджера пакетів.

npmnpm install express

yarnyarn add express

pnpmpnpm add express

Базове використання

Запустіться з мінімальним налаштуванням.

$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)

Просунуті патерни

Production-ready патерни з обробкою помилок, станами завантаження та розширеним налаштуванням.

Обробник Express із перевіркою підпису — Натисніть, щоб розгорнути

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 ендпоінта для розгортань із проксі-маршрутизацією — явний URL важливіший за region

regionstringРегіон даних: us або eu

timeoutMsnumberЧас очікування всього виклику getResult(), у мілісекундах

linkedIdstringВаш внутрішній ID акаунта авторизованого користувача, щоб пов’язувати відвідування з одного пристрою

tagstringДовільна мітка, що додається до запиту ідентифікації, наприклад checkout або login

debugbooleanПише життєвий цикл скрипта та мережеву активність у консоль браузера

scriptUrlstringПовна заміна URL скрипта агента — для self-hosting або Subresource Integrity

Наступні кроки

Занурюйтесь глибше з повним довідником API, налаштуванням webhook і просунутими посібниками.

Почніть роботу з Node.js

Додайте фінгерпринтинг пристроїв до вашого застосунку Node.js менш ніж за 5 хвилин.

Посібник Quick Start Замовити демо

Device Intelligence для Node.js

Базове використання

Запустіться з мінімальним налаштуванням.

$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)

Просунуті патерни

Production-ready патерни з обробкою помилок, станами завантаження та розширеним налаштуванням.

Обробник Express із перевіркою підпису — Натисніть, щоб розгорнути

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 ендпоінта для розгортань із проксі-маршрутизацією — явний URL важливіший за region

regionstringРегіон даних: us або eu

timeoutMsnumberЧас очікування всього виклику getResult(), у мілісекундах

tagstringДовільна мітка, що додається до запиту ідентифікації, наприклад checkout або login

debugbooleanПише життєвий цикл скрипта та мережеву активність у консоль браузера

scriptUrlstringПовна заміна URL скрипта агента — для self-hosting або Subresource Integrity

Device Intelligence для Node.js

Швидке встановлення

Базове використання

Просунуті патерни

Параметри конфігурації

Наступні кроки

Документація

Webhooks

Webhooks

Почніть роботу з Node.js

Device Intelligence для Node.js

Швидке встановлення

Базове використання

Просунуті патерни

Параметри конфігурації

Наступні кроки

Документація

Webhooks

Webhooks

Почніть роботу з Node.js