FingerprintX is an open source, client side, fingerprinting library for IPRiskify. It uses browser fingerprinting to build a persistent browser fingerprint on the visitor.

Demo

We have a demo which allows you to see the library in action, visit https://demo.ipriskify.com to see your browser fingerprint and stats.

Usage

Basic Usage

Include the FingerprintX library in your HTML and initialize it:

<script src="https://cdn.jsdelivr.net/npm/@ipriskify/fingerprintx/dist/ipriskify.min.js"></script>
<script>
    IPRiskify.then(IPRiskify => IPRiskify.load())

  ipRiskify
    .then(fp => fp.get())
    .then(result => {
      const analysis = result.analysis;
      console.log('Fingerprint result:', result)

    })
</script>

import('https://cdn.jsdelivr.net/npm/@ipriskify/fingerprintx/dist/ipriskify.umd.js')
  .then(async () => {
    const fpx = await IPRiskify.load()
    const result = await fpx.get()
    console.log(result)
  })
  .catch(err => {
    console.error('Failed to load IPRiskify:', err)
  })

Fingerprint Analysis

FingerprintX provides a simple analysis of the fingerprint to make it easy to understand the browser. This includes bot detection, incognito mode detection, browser details and a unique visitor ID. This is stored in the analysis property of the result.

{
	"fingerprint":"6e0ae...c55", // Unique Fingerprint, persistent across sessions
	"browser": {
		"name": "Brave",
		"major_version": "138",
		"full_version": "138.0.0",
		"os": "Mac OS X",
		"os_version": "10.15.7",
		"device": "Other",
		"user_agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/138.0.0.0 Safari/537.36"
	},
	"incognito": true,
	"bot_detected": true,
}

Fingerprint Raw

Some users may want to see the full raw fingerprint data collected by FingerprintX. Below is an example of the full raw data collected. The raw fingerprint is stored in the fingerprint property of the result.

[!NOTE] This is an example fingerprint, your fingerprint will be different based on your browser and device.

{
    "storedWebsiteData": [],
    "indexedDbKeys": [],
    "endiannessByte": 127,
    "incognitoDetected": false,
    "userAgent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/138.0.0.0 Safari/537.36",
    "language": "en-US",
    "platform": "MacIntel",
    "timezoneOffsetMinutes": 240,
    "browserCapabilityInfo": {
        "hasSessionStorage": 1,
        "hasLocalStorage": 1,
        "hasIndexedDB": 1,
        "cookiesEnabled": true,
        "javaEnabled": false,
        "hasWebkitRequestFileSystem": true,
        "hasOpenDatabase": false,
        "hasPromiseAllSettled": true,
        "hasMsSaveBlob": false
    },
    "screenInfo": {
        "dimensionsObj": {
            "width": 1440,
            "height": 900
        },
        "availDimensionsObj": {
            "width": 1440,
            "height": 900
        },
        "colorDepth": 30,
        "devicePixelRatio": 2,
        "screenDpi": 96
    },
    "webglInfo": {
        "maxViewportDimsObj": {
            "width": 16384,
            "height": 16384
        },
        "maxTextureSize": 16384,
        "maxTextureImageUnits": 16,
        "maxFragmentUniformVectors": 1024,
        "maxVaryingVectors": 30,
        "aliasedPointSizeRangeArr": {
            "values": [
                1,
                511
            ]
        },
        "aliasedLineWidthRangeArr": {
            "values": [
                1,
                1
            ]
        },
        "unmaskedRenderer": "ANGLE (Apple, ANGLE Metal Renderer: Apple M3 Max, Unspecified Version)",
        "fingerprint": "9bd6ce42d844968e4a5a89d4b2e9e9d9cfce263b6b23ada80ccd4c0df84d14b8",
        "webgl2Supported": true
    },
    "automationInfo": {
        "automationToolDetected": false,
        "webdriverChecks": [
            false,
        ]
    },
    "jsErrorSignature": "c",
    "browserEngineSignature": "brave",
    "audioFingerprint": "a94b988df773e851a8a0835f3c4dcbc56541a8f0e61b4330cc3e217fd4be0f03",
    "mediaDevicesInfo": {
        "devices": [
            {
                "id": "",
                "kind": "audioinput",
                "hasLabel": false
            },
            {
                "id": "",
                "kind": "videoinput",
                "hasLabel": false
            },
            {
                "id": "",
                "kind": "audiooutput",
                "hasLabel": false
            }
        ],
        "microphoneAccess": "unlabeled",
        "webcamAccess": "unlabeled",
        "speakerAccess": "present"
    },
    "documentCookie": "",
    "speechApiFingerprint": 2,
    "speechVoices": [
        {
            "name": "Samantha",
            "lang": "en-US",
            "default": true,
            "localService": true,
            "voiceURI": "Samantha"
        },
        ...
    ],
    "batteryStatusIssue": false,
    "canvasImageDataBenchmark": 16.9,
    "fingerprint": "6e0ae...c55"
}

IPRiskify Pro

The open source library is limited with the production library using over 200+ signals to build an incredibly accurate and detailed browser profile. If you plan to use Fingerprint in your application we highly recommend using the Pro version, with it supporting more features and providing additional security.

We also have a free tier which allows for 10,000 lookups per month.

| Provider | Data Points Collected | Bot Detection | Accuracy | VPN / Residential Proxy Detection | Dashboard | Obfuscation | Integrity Verification | Pricing | | ----------------- | --------------------- | ------------- | -------- | --------------------------------- | --------- | ----------- | ---------------------- | ----------------- | | IPRIskify Pro | ~250 | ✅ | ~99% | ✅ | ✅ | ✅ | ✅ | $.001 Per Request | | IPRiskify Free | ~75 | ✅ | ~83% | ❌ | ❌ | ❌ | ❌ | Free | | FingerprintJS Pro | ~200 | ✅ | ~99% | ✅ | ✅ | ❌ | ❌ | $.01 Per Request | | FingerprintJS | ~ | ❌ | ~50% | ❌ | ❌ | ❌ | ❌ | Free | | CreepJS | ~50 | ✅ | ~30% | ❌ | ✅ | ❌ | ❌ | Free | | ThumbarkJS | ~20 | ❌ | ~25% | ❌ | ❌ | ❌ | ❌ | Free |

Telemetry

FingerprintX collects telemetry by default to improve performance and accuracy. If you do not want to send telemetry you can disable it by passing telemetry=false when loading the library. Please note that this will disable telemetry but may also reduce accuracy.

<script src="https://cdn.jsdelivr.net/npm/@ipriskify/[email protected]/dist/ipriskify.min.js"></script>
<script>
  // Load IPRiskify with telemetry disabled
  const fpPromise = IPRiskify.load({ telemetry: false });
  
  fpPromise
    .then(fp => fp.get())
    .then(result => {
      console.log('Fingerprint result:', result);
    })
    .catch(error => {
      console.error('Error:', error);
    });
</script>

Support

If you need help, please visit our Discord server or open an issue on GitHub.

Contributing

If you would like to contribute to the project please read our contributing guidelines first.