PingOne

Adding device profiling to a browser-based authentication page using Fingerprint JS

About this task

You can adapt these instructions to add device profiling to any page, such as the HTML Form Adapter or your web application. The page must meet the criteria listed in Device profiling methods.

The PingOne Risk (Signals) SDK is the preferred way to get device profiling and is recommended for use in the PingOne Risk Integration Kit 1.3 and later.

Steps

  1. If you are modifying an external web application, copy the following files from the integration .zip archive to a location that your page can access.

    • fingerprint2-<version>.min.js

    • pingone-risk-management-profiling.js

    • pingone-risk-management-embedded.js

  2. Add the following external script references to the sign-on page.

    The scripts must be added in the following order:

    <script type="text/javascript" src="fingerprint2-<version>.min.js"></script>
    <script type="text/javascript" src="{file-prefix}-profiling.js"></script>
    <script type="text/javascript" src="{file-prefix}-embedded.js"></script>
  3. Edit the pingone-risk-management-embedded.js file to use Fingerprint JS according to the comments in the file.

  4. Optional: Customize the device profile cookie name prefix to suit your environment.

    1. Open pingone-risk-management-embedded.js for editing.

    2. On the following line, change the value to a name of your choosing:

      var cookieNamePrefix = "pingone.risk.device.profile";
    3. Save the file.

  5. When you complete the steps in Configuring an adapter instance, follow the instructions to set the Device profiling method to Captured by a previous adapter. Update the Cookie Name Prefix field if you customized it above.