Catch the automation, not just the IP.
Trace looks at the browser itself: automation frameworks, input no person produces, and browsers that contradict themselves.
SignalsbotautomatedInputantiDetect
Step 4 of 4bot + automatedInputBlock
Chrome 131Typed, mouse pathAllow
Normal visitorFirefox 133Pasted, touchAllow
Normal visitorChrome, odd worker UATypedChallenge
antiDetect: browser contradicts itselfHeadlessChromeSynthetic clicksBlock
bot + automatedInputHow it plays out
The attack, what the verified event shows, and what your code does about it.
01 · The attack
How it usually goes
- Headless browsersPuppeteer, Playwright and Selenium at scale.
- Anti-detect profilesBrowsers that fake a new device each time.
- Residential proxiesClean IPs that make blocklists useless.
02 · What Trace sees
Fields on the verified event
- botwebdriver, headless user agents, automation globals.
"bot": { "detected": true } - automatedInputClicks and keys created by scripts.
"automatedInput": { "detected": true } - antiDetectA worker or iframe reports a different device.
"antiDetect": { "detected": true, "details": { "reasons": ["workerMismatch"] }}
03 · What you do
Decide, with your own thresholds
- AllowNormal visitor
- ChallengeantiDetect: browser contradicts itself
- Blockbot + automatedInput
Decision lab
Switch signals on and off. The score is a plain sum of weights.
Signals
Weights are the defaults in scoring.default.json. The cut-offs at 25 and 60 are examples; your app sets its own.
60suspectScore / 100
BlockStop the action.
60/ 100
reasons
bot+60
Implementation
One browser call, one server check.
01IdentifyCall the SDK on the action and send the eventId with it.
02VerifyYour server reads the event with a secret key.
03DecideAllow, challenge or block, with your own thresholds.
identify.ts
const trace = createClient({ apiKey: 'pk_...', endpoint: 'https://id.example.com' });
// On the action (signup, login, checkout), then send eventId with the form.
const { eventId } = await trace.get();Example response, illustrative
{ "eventId": "evt_example"}Start in shadow mode. Block later.
Log the decision for a week, check who it would have stopped, then turn it on.