Human Detector on N7 Docs

Human-Detector (HD): Core Security Module Overview

Mon, 01 Jan 0001 00:00:00 +0000

What is Human-Detector (HD)?#

The Human-Detector (HD) is a core security module within Nitrogen (N7) designed to distinguish between legitimate human users and automated scripts (bots) interacting with your website or application.

Beyond basic detection, HD analyzes the “request journey” to assess behavioral patterns, enabling it to identify requests with malicious intent and mitigate threats in real-time.

HD is particularly useful for securing high-value and sensitive pages/APIs, such as account login, cart, and checkout flows, where security risks are higher.

Human-Detector (HD): Integration steps

Mon, 01 Jan 0001 00:00:00 +0000

Integration on Website:#

Place the following script at the end of the <head> tag on all pages:
1. <script src="/n7/n7HD.js" type="text/javascript" async defer></script>

Integration on API/sub-domains#

If backend APIs are served from a different subdomain than the frontend application (for example: frontend on www.domain.com and APIs on api.domain.com), additional configuration is required for HD to function correctly.

Note: Please ensure that HD script is present on the primary domain.

Human-Detector (HD): Configuration Guide

Mon, 01 Jan 0001 00:00:00 +0000

Typical Use-Cases#

Account Pages
Cart Pages
Checkout Pages
Other sensitive Pages/APIs

Prerequisites#

A domain must be configured on Nitrogen.
Website or mobile app must integrate the HD script or token-fetching step.
URL pattern must be set for the desired pages (e.g., ^/cart(?.)$).

Configuration Steps#

Go to the Security menu and select the Human Detector tab.
Choose the domain from the dropdown list.