- 17 Nov 2023
- Print
- DarkLight
Advanced Client Integration
- Updated on 17 Nov 2023
- Print
- DarkLight
Advanced Client Integration helps you to get the Hash Score and Risk Response (HUMAN Cookie), in real time, by a subscription to a special event on the Javascript Client.
Advanced Client Integration requires special configuration. Contact HUMAN Customer Support to enable it.
The Risk Cookie must be enabled on the relevant policy to get access to Risk Response or Hashed Score on the client side.
Risk Response (HUMAN Cookie)
To access the Risk Response on the client side, integrate with the HUMAN Client Side SDK with the following initialization code:
window.<app_id>_asyncInit = function (px) {
px.Events.on('risk', function (risk, name) {
// name - reported cookie name (ex: _px)
console.log('DATA', risk);
});
};
The value of the Risk Response is also reported on the Risk Cookie (_human)
The initialization code should be located before the HUMAN JS Snippet on your site pages. The event is triggered for each Risk Cookie update. For 'score', an event based on your custom configuration hashed score or binary score is be reported.
Hashed Score / Block Decision
In order to gain access to the Hashed Score or Block Decision on the client side, integrate with the HUMAN client side SDK with the following initialization code. Block decision is based on the policy defined score.
window.<app_id>_asyncInit = function (px) {
px.Events.on('score', function (score, kind) {
// kind - "hashed" for “Hashed Score” or "binary" for “Block Decision”
console.log('SCORE', score);
});
};
Contact HUMAN Support to access your Hashed Score mapping
Custom Cookie Header
In some cases the client network library may strip the Cookie header in the event of cross-domain calls (For example React).
In these cases we add a custom header to every outgoing network call, containing the HUMAN cookie.
Server Integration
When setting the Custom Cookie header, the Custom header name that contains the HUMAN Cookie must be specified. The cookie is extracted from the Custom Cookie header rather than the default HUMAN Cookie header.
Fastly - https://console.humansecurity.com/docs/fastly_enforcer.html#enable-cookie-from-header
Cloudflare - https://portal.document360.io/v1/docs/cloudflare-config#custom-cookie-header
NGINX - https://github.com/PerimeterX/perimeterx-nginx-plugin#custom-cookie-header
Client Integration
Whenever you do this on the server, the client needs to send the cookies on the specified header name. To send the cookies on the specified header:
- Save the cookie content every time it refreshes (for example, in local storage or as a global variable).
To get the cookie, add the following event listener (make sure you replace <app_id> with your app ID):
window.<app_id>_asyncInit = function (px) {
px.Events.on('risk', function (risk, name) {
// save the cookie name and content. for example - localStorage
localStorage.setItem("pxcookie",`${name}=${risk}`)
});
- Intercept the outgoing requests and append the new header containing the Cookie value from step 1. This example assumes you are using axios for all outgoing requests, for any other library your front-end implementation is using - make sure requests include the information saved in local storage as mentioned above.
axios.interceptors.request.use(async (config) => {
const cookie = localStorage.getItem("pxcookie");
if (cookie) {
config.headers["x-px-cookie"] = cookie;
}
return config
}, function (error) {
throw error;
});
The name of the header ("x-human-cookie") should be the same as the name of the header set in the Server Integration section.