FingerprintJS Connector
The FingerprintJS connector lets you create a unique visitor ID based on browser attributes for use in fraud and analytics in your PingOne DaVinci flow.
This connector enables browser fingerprinting to stop fraud, spam, and account takeovers.
You can use the FingerprintJS connector to:
-
Provide a single sign-on (SSO)-like experience across multiple nodes in a flow.
-
Implement risk intelligence through browser fingerprinting.
Setup
Requirements
To use the connector, you’ll need:
-
A configured FingerprintJS environment
-
Your FingerprintJS API keys
Configuring the FingerprintJS connector
Add the connector in DaVinci as shown in Adding a connector, then configure it as follows.
Connector configuration
Fingerprint Subscription Browser Token
A public API key from FingerprintJS. This key can be found in your FingerprintJS environment under App Settings > API Keys.
Using the connector in a flow
Visitor ID creation
You can use the Get a visitor’s ID capability to create a unique ID for a user. No special flow configuration is needed. Add the capability and populate its properties according to the help text.
Information through visitor’s ID
You can use the Get visitor’s info based on ID capability to get visitor information, such as their ID, IP address, browser, and whether incognito mode is being used. No special flow configuration is needed. Add the capability and populate its properties according to the help text.
Capabilities
Get Visitor’s ID
Show details
-
Input Schema
-
Output Schema
-
default object
-
properties object
-
token string required minLength: 0 maxLength: 100
Fingerprint JS Subscriber Token
-
javascriptCdnUrl string required
-
Fingerprint JS javascript URL
-
Input Example
{ "properties" :
{ } }-
output object
-
requestId string required
-
visitorId string required
-
visitorFound boolean required
-
meta null required
-
Output Example
{ "requestId" : "1619596982579.qsyvOp",
"visitorId" : "oUT1HXUBaQZ9RwdF5xCX",
"visitorFound" : true,
"meta" : null }Get Visitor’s Info based on ID
Get Visitor information such as ID, incognito mode, IP, browser, etc.
Show details
-
Properties
-
Input Schema
-
Output Schema
- Visitor ID textField required
-
default object
-
properties object
-
apiToken string required minLength: 0 maxLength: 100
Fingerprint JS Subscriber API Token
-
visitorId string required minLength: 0 maxLength: 100
-
Fingerprint JS visitor id
-
Input Example
{ "properties" :
{ "visitorId" : "visitor-id" } }-
output object
-
visitorId string required
-
visits array required
-
Array Item Schema object
-
requestId string required
-
incognito boolean required
-
linkedId string required
-
time string required
-
timestamp integer required
-
url string required
-
ip string required
-
ipLocation object required
-
accuracyRadius integer required
-
latitude number required
-
longitude number required
-
postalCode string required
-
timezone string required
-
city object required
-
name string required
-
-
continent object required
-
code string required
-
name string required
-
-
country object required
-
code string required
-
name string required
-
-
subdivisions array required
-
Array Item Schema object
-
isoCode string required
-
name string required
-
-
-
-
browserDetails object required
-
browserName string required
-
browserMajorVersion string required
-
browserFullVersion string required
-
os string required
-
osVersion string required
-
device string required
-
userAgent string required
-
-
-
-
lastTimestamp integer required
-
Output Example
{ "visitorId" : "Ibk1527CUFmcnjLwIs4A9",
"visits" :
[
{ "requestId" : "0KSh65EnVoB85JBmloQK",
"incognito" : true,
"linkedId" : "somelinkedId",
"time" : "2019-05-21T16:40:13Z",
"timestamp" : 1.582299576512E12,
"url" : "https://www.example.com/login",
"ip" : "61.127.217.15",
"ipLocation" :
{ "accuracyRadius" : 10,
"latitude" : 49.982,
"longitude" : 36.2566,
"postalCode" : "61202",
"timezone" : "Europe/Dusseldorf",
"city" :
{ "name" : "Dusseldorf" },
"continent" :
{ "code" : "EU",
"name" : "Europe" },
"country" :
{ "code" : "DE",
"name" : "Germany" },
"subdivisions" :
[
{ "isoCode" : "63",
"name" : "North Rhine-Westphalia" } ] },
"browserDetails" :
{ "browserName" : "Chrome",
"browserMajorVersion" : "74",
"browserFullVersion" : "74.0.3729",
"os" : "Windows",
"osVersion" : "7",
"device" : "Other",
"userAgent" : "Mozilla/5.0 (Windows NT 6.1; Win64; x64) ...." } } ],
"lastTimestamp" : 1.582299576512E12 }