Details array when it fires, with the points it added. ShieldLabs surfaces these signals. Your own code owns the decision: allow, challenge, review, or block. See Risk Scoring.
The signals, by outcome
Each signal answers one question about the visit. The groups below describe what each one tells you, not how it is found.Network and anonymity
These signals tell you the connection is relayed, tunneled, or coming from infrastructure rather than an ordinary network.- Tor - the connection exits through the Tor network.
- VPN - the connection runs through a VPN.
- Privacy Relay - the connection uses iCloud Private Relay or a similar relay.
- Proxy - the connection is routed through a proxy.
- Browser VPN/Proxy - an in-browser VPN or proxy extension is in use.
- Datacenter IP - the IP belongs to a datacenter or hosting network.
- Abuser Flag - the IP or device appears on an abuse reputation list.
Consistency and mismatch
These signals tell you the browser’s story and the network’s story disagree, which is what spoofed or relayed visits leave behind.- OS Mismatch - the operating system the browser reports does not match other evidence.
- IP Mismatch - the visitor’s reported and observed IP addresses disagree.
- Timezone Mismatch - the device timezone does not match the IP location.
Environment
These signals tell you the runtime is spoofed, stripped, or could not be fully verified.- Anti-detect Browser - the browser shows anti-detect or fingerprint-spoofing indicators.
- JavaScript Disabled - the page ran without the script environment a real browser provides.
- OS not Detected - the operating system could not be determined.
- Network check incomplete - a network verification step could not be completed.
Signal weights
Each signal carries a fixed weight. A higher weight is stronger evidence that the visit is masked, spoofed, or abusive.| Signal | Weight | What it means |
|---|---|---|
| Tor | 99 | Connection exits through the Tor network |
| JavaScript Disabled | 90 | The page ran without the script environment a real browser provides |
| OS Mismatch | 60 | The operating system the browser reports does not match other evidence |
| Anti-detect Browser | 60 | The browser shows anti-detect or fingerprint-spoofing indicators |
| Browser VPN/Proxy | 30 | An in-browser VPN or proxy extension is in use |
| OS not Detected | 30 | The operating system could not be determined |
| Network check incomplete | 30 | A network verification step could not be completed |
| IP Mismatch | 30 | The visitor’s reported and observed IP addresses disagree |
| VPN | 15 | The connection runs through a VPN |
| Privacy Relay | 15 | The connection uses iCloud Private Relay or a similar relay |
| Proxy | 10 | The connection is routed through a proxy |
| Datacenter IP | 10 | The IP belongs to a datacenter or hosting network |
| Abuser Flag | 10 | The IP or device appears on an abuse reputation list |
| Timezone Mismatch | 10 | The device timezone does not match the IP location |
Why the VPN signal catches more
ShieldLabs corroborates VPN across multiple signals, so it catches masking that a simple IP blocklist misses. A blocklist is always behind: commercial VPNs rotate through large IP pools daily, and residential proxies hide on ordinary consumer ISPs. Because the VPN signal does not depend on a list alone, a fresh exit node that no blocklist has yet seen can still surface.Connection type
Every visit also resolves to a single connection type, the headline label for how the visit reaches you. It is stored on the snapshot and shown in the dashboard.| Connection type | What it means |
|---|---|
| Direct | An ordinary connection with no masking signal |
| Mobile | A mobile carrier network |
| VPN | The connection runs through a VPN |
| Proxy | The connection is routed through a proxy |
| Tor | The connection exits through the Tor network |
| Privacy Relay | iCloud Private Relay or a similar relay |
| Unknown | The connection type could not be determined |
The connection type is a summary. The
Details array on the Risk Score is the full breakdown: one visit can carry a proxy connection type along with a datacenter and abuser flag underneath it.A masked visit is not always abuse
A legitimate visitor can carry these signals. A corporate VPN, iCloud Private Relay, or a privacy-focused browser all raise the score without any wrongdoing. Because every signal is explainable, your code can treat Privacy Relay differently from a datacenter VPN. Both are masking, but they carry different intent, and you decide which action each one warrants.Example
A visit on a proxy with a timezone mismatch returns both reasons inDetails:
Next steps
Risk Scoring
How signal weights roll up into the 0-100 score and the Clean, Low, Medium, and High bands.
Patterns
The dashboard patterns that grade an identity over time, distinct from these per-request signals.