Connectors

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

Resources

For information and setup help, see the following:

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.

Fingerprint Subscription API Token

TA secret API key from FingerprintJS. This key can be found in your FingerprintJS environment under App Settings > API Keys.

JavaScript CDN URL

A CDN URL for the FingerprintJS element.

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 obtain 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
Details
Input Schema
default object
token string required minLength: 0 maxLength: 100

Fingerprint JS Subscriber Token

javascriptCdnUrl string required

Fingerprint JS javascript URL

Output Schema
output object
requestId string
visitorId string
visitorFound boolean
meta null

Get Visitor’s Info based on ID

Get Visitor information such as ID, incognito mode, IP, browser, etc.

Show details
Details
Properties
Visitor ID textField required
Input Schema
default object
apiToken string required minLength: 0 maxLength: 100

Fingerprint JS Subscriber API Token

visitorId string required minLength: 0 maxLength: 100

Fingerprint JS visitor id

Output Schema
output object
visitorId string
visits array
items array
0 object requestId/incognito/linkedId/time/timestamp/url/ip/ipLocation/browserDetails
properties object
requestId string
incognito boolean
linkedId string
time string
timestamp integer
url string
ip string
ipLocation object accuracyRadius/latitude/longitude/postalCode/timezone/city/continent/country/subdivisions
properties object
accuracyRadius integer
latitude number
longitude number
postalCode string
timezone string
city object name
properties object
name string
continent object code/name
properties object
code string
name string
country object code/name
properties object
code string
name string
subdivisions array
items array
0 object isoCode/name
properties object
isoCode string
name string
browserDetails object browserName/browserMajorVersion/browserFullVersion/os/osVersion/device/userAgent
properties object
browserName string
browserMajorVersion string
browserFullVersion string
os string
osVersion string
device string
userAgent string
lastTimestamp integer