Adding device profiling to a browser-based authentication page - PingOne - PingOne Services - PingOne Cloud Platform

PingOne Protect Integration Kit

bundle
pingfederate-pingone-protect-ik
ft:publication_title
PingOne Protect Integration Kit
Product_Version_ce
PingOne
PingOne Services
PingOne Cloud Platform
category
Administrator
Audience
ContentType
English
Integration
Language
OtherDocs
Product
Productdocumentation
integrationdoc
p1
p1cloudplatform
p1protect
p1services
ContentType_ce
Integration
Product documentation

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.

Note:

To use the HTML Form Adapter, follow the instructions in Configuring a provider instance.

  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:
    Important:

    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>
    
    Note: 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.