Loading...
https://backstage.forgerock.com/cloud-storage-ws/api/v1/cloudstorage/getfile/cR9os7eLRMWuGQ09Ns229w?imageSizeFallback=allowVectors&size=medium

Fingerprint nodes


The Fingerprint Profiler and Fingerprint Response nodes let you integrate your Advanced Identity Cloud environment with the Fingerprint platform to help reduce fraud and improve customer experience. The integration with Fingerprint provides browser fingerprinting directly from an authentication journey with high confidence, at an average score of 99.5%. When you identify browsers or devices with Fingerprint, you get back the visitorId value. You can use this value in your business logic to find suspicious activity or for marketing analytics. In some cases you do not want the client devices receive visitorID value from Fingerprint. Instead, you can receive a random requestID that can be used in business logic. This mode of not sending back visitorID is called Zero Trust Mode (ZTM).

Fingerprint Nodes

The Fingerprint Profiler and Fingerprint Response nodes let you integrate your Advanced Identity Cloud environment with the Fingerprint platform to help reduce fraud and improve customer experience. The integration with Fingerprint provides browser fingerprinting directly from an authentication journey with high confidence, at an average score of 99.5%.

When you identify browsers or devices with Fingerprint, you get back the visitorId value. You can use this value in your business logic to find suspicious activity or for marketing analytics. In some cases you do not want the client devices receive visitorID value from Fingerprint. Instead, you can receive a random requestID that can be used in business logic. This mode of not sending back visitorID is called Zero Trust Mode (ZTM).

You must Setup the prerequisites on the Fingerprint site before you can use Fingerprint nodes.

Advanced Identity Cloud provides two authentication nodes for Fingerprint authentication journeys:

Fingerprint Profiler node

Fingerprint Response node

Usage

To deploy these nodes, download the jar from the releases tab on github here. Next, copy the jar into the ../web-container/webapps/openam/WEB-INF/lib directory where AM is deployed. Restart the web container to pick up the new node. The node will then appear in the authentication trees components palette.

Fingerprint Profiler node

The Fingerprint Profiler node injects the client-side Javascript code required for the fingerprinting process.

Configuration Property Usage Public API Key

Public API key for the Fingerprint application.

Script URL Pattern

URL path to a hosted JavaScript when using a custom domain. The default URL pattern is https://fpjscdn.net/v3.

Endpoint (optional)

URL path to the endpoint address when using a custom domain. This is an optional property.

Fingerprint Region

The Fingerprint region in which the Fingerprint application is set up. To use the US or the default region, specify GLOBAL.

Shared State VisitorID

Name of the shared state variable to store the device fingerprint. When ZTM is enabled, set the same value in the Fingerprint Response node.

Zero Trust Mode

You can enable ZTM if your application is set up in ZTM, and the Fingerprint Response node is configured to deliver the fingerprint.

Fingerprint Response node

The Fingerprint Response node is used in the zero-trust model to fetch the fingerprint and server-side confidence score.

Configuration The configurable properties for this node are:

Property Usage Secret API Key

Secret API key configured on the Fingerprint site.

Events API URL

Path to an events API. The default is https://eu.api.fpjs.io/events/. Other options include:

https://api.fpjs.io/events/

https://ap.api.fpjs.io/events/

Shared State VisitorID

Name of the shared state variable to store the fingerprint. This should be the same as in the Fingerprint Profile node.

Get full response payload

Disabled by default. Enable if you want to store the full fingerprint API response in shared state.

Shared State Response

Name of the variable to store the fingerprint API response. Used only when Get full response payload is enabled.

Details
Categories
No categories selected
Supported By
Unsupported
Repository
https://github.com/ForgeRock/tntp-fingerprint
Verifications
Verified By
Unverified
Product VersionVerified On
access-managementPingAMJul 12, 2024
Releases
Fingerprint release
Latest release
Published Aug 2, 2024
Report inappropriate content