PingOne

Adding device profiling to a browser-based authentication page

About this task

You can adapt these instructions to add device profiling to any web page included in an adapter, such as the Identifier First Adapter or a custom adapter. The page must meet the criteria listed in Device profiling methods.

To use the HTML Form Adapter, follow the instructions in Configuring an adapter instance.

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.

    • signals-sdk-<version>.js

    • signals.js in the captcha directory

    • pingone-protect-device-profiling-implementation.js. (If you are using version 1.0.1 or earlier of the integration kit, the file is called pingone-protect-device-profiling.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="signals-sdk-<version>.js"></script>
<script type="text/javascript" src="pingone-protect-device-profiling-implementation.js"></script>
<script type="text/javascript" src="signals.js"></script>

    If you are using version 1.0.1 or earlier of the integration kit, replace the reference to pingone-protect-device-profiling-implementation.js with a reference to pingone-protect-device-profiling.js

  3. When you complete the steps in Configuring an adapter instance, you can enable risk evaluation for active sessions. Follow the steps in Configuring authentication sessions to set up sessions for the PingOne Protect Adapter, and complete steps 2a, 2b, and 3.