Device Recognition is included, out-of-the-box with SecureAuth® Identity Platform. This heuristic-based authentication enables end users to securely access resources without requiring additional one-time passwords (OTPs) for multi-factor authentication (MFA).

While Device Recognition does not require anything to be stored, it can store a credential in the device, which increases the security as there is now something client-side and something server-side that must match for a successful authentication.

End users enroll for device / browser profiles by successfully authenticating through the Identity Platform realm, and the profiles can be instantly revoked at any time by the administrator or the end user.

Device Recognition works on any mobile or desktop device and can be configured to ensure that only the actual end user is obtaining access into the target resource.

Device Recognition works with Internet Explorer 10+, but will not function properly in Compatibility View. If the If the Compatibility View setting is required, then do not use Device Recognition in the realm.

Definitions

The Identity Platform can collect client-unique information (profiles) from the end user's device or browser.

For desktop browsers, there are two options:

No Cookie	Information sent from the browser is collected in the Identity Platform, without delivering or registering any information at the client side, such as HTTP headers and cookies.
Cookie	Information sent from the browser is collected in the Identity Platform, in addition to registering a cookie at the client-side to increase security.

For mobile devices (iOS and Android), the Identity Platform has the following method to collect information:

Cookie

Information sent from the browser is collected in the Identity Platform, in addition to registering a cookie at the client-side to increase security.

After a successful multi-factor authentication, the profile is created, and then accepted and stored in the user account in the directory.

When the end user logs in again to the Identity Platform using the same device (or browser), the current client-unique information (a new profile) is collected and compared with the previously registered profiles for authentication.

When an existing profile matches the current profile with an acceptable Authentication Threshold score, the end user is not prompted for multi-factor authentication.

When the device recognition cookie is used as part of the device recognition workflow, it restricts the user to have one device profile per browser in which the cookie lives.

Prerequisites

Have iOS or Android mobile devices, or desktop devices with a browser
Create a New Realm or access existing realm(s) on the Identity Platform Web Admin to which Device Recognition is applied (Realm A in the Identity Platform configuration)
Optional. Create a New Realm or access an existing realm in the Identity Platform Web Admin that is configured for the Account Management Page (help desk) to enable administrator device / browser profile revocation ( Realm B in the Identity Platform configuration section)
Optional. Create a New Realm or access an existing realm in the Identity Platform Web Admin that is configured for the Self-service Account Update (end user self-service) to enable end user device / browser profile self-revocation ( Realm C in the Identity Platform configuration section)
Configure the following tabs in the Web Admin before configuring for Device Recognition (and Account Management Page and Self-service Account Update):
- Overview – the description of the realm and SMTP connections must be defined
- Data – an enterprise directory must be integrated with the Identity Platform
- Workflow – the way in which users access the resource must be defined
- Multi-Factor Methods – the Multi-Factor Authentication methods that are used to access the target (if any) must be defined
- Post Authentication – the target resource or post authentication action must be defined (see Realm B and Realm C for specific Post Authentication configurations for Account Management Page and Self-service Account Update)
- Logs – the logs that are enabled or disabled for this realm must be defined

For API configuration information, see Device Recognition Authentication API Guide.

Identity Platform configuration

The following configuration steps are for any and all realms using Device Recognition.

Important! To retain your configurations, be sure to click Save often, before leaving a tab page. Once you leave that tab, any unsaved changes are lost.

Realm A

Steps 1-2 are required for all realms in this guide (Realm A, Realm B, and Realm C)

Go to the Data tab.

The following step is for LDAP data stores only (AD and others). If using a different directory (for example, SQL), then the Property needs to be configured as a stored procedure in the data store.
Note: For SQL, ASP.net, and Oracle data stores, only the Plain Binary Data Format is supported and for ODBC data stores, Device Recognition is not supported

In the Profile Fields section, map a directory field to the following Property:

Fingerprints

In typical AD deployments, set this field to audio and use the Plain Binary data format.

Select the Writable check box.

For the LDAP directory attribute mapped to the Property based on the Data Format selection (Plain Binary or JSON), there are distinct requirements for the directory field that contains the device / browser profile information:

Plain Binary requirements:

Length – 8 kB minimum per Device / Browser Profile; and if the Total FP Max Count is set to -1, then the size must be unlimited
Data Type – Octet string (bytes)
Multi-valued

JSON requirements:

Length – No limit / undefined
Data Type – DirectoryString
Multi-valued

Click Save.
Go to the Workflow tab.
In the Device Recognition Method section, set the following:

Integration Method
Set to Certification Enrollment and Validation.
Client Side Control Set to Device/Browser Fingerprinting.

In the Workflow section, set the following:

Default Workflow	Set the login workflow for the end user login. If you select the "(Valid Persistent Token) only" option... Then, a persistent token (for example, device / browser profile is required to access the target resource. To redirect the end user to enroll for a persistent token to gain access, provide the realm URL to another Identity Platform realm. Go to the Workflow tab, in the Workflow > Redirects section and set the realm URL (for example, /Realm#) in the Invalid Persistent Token Redirect field.
Public/Private Mode	This generates a device / browser profile in this realm and checks for existing profiles. Set to Private and Public Mode or Private Mode Only.
Default Public/Private	On the client-side page shown to the end user, select which option is to be selected by default. To ensure that profiles are generated and checked in the realm, it is recommended to set to Default Private.
Remember User Selection	On the client-side page shown to the end user, to automatically select the Private or Public option, based on the previous selection by the user, set to True.

In the Browser / Mobile Profiles section, set the following:

*Browser Profile Settings*
FP mode	By default, this is set to Cookie. This Indicates whether to deliver a cookie to the browser after authentication – Cookie or No Cookie.
Cookie name prefix	Keep or change the default cookie name. The cookie name appears as Cookie Name Prefix + company name + hashed value of user ID.
Cookie length	Set the length of time in hours, the cookie is valid. For example, 72 hours.
Match FP ID in cookie	By default, this is set to True. This requires the profile ID to presented and then matched to a profile ID in the directory with an acceptable Authentication Threshold score. Otherwise, if set to False, it does not require ID matching between the cookie and the stored profile.
Authentication threshold (%)	Set the Authentication threshold to a percentage number between 90 and 100.
Update threshold (%)	Set the Update threshold to a percentage number just below the Authentication threshold. This number must be less than the number set in the previous field. For an explanation of thresholds, see the following Profile Comparison Score information. Profile Comparison Score... Identity Platform provides two (2) threshold values: Authentication Threshold (the high one) determines whether additional 2-Factor Authentication is required (OTP) Update Threshold (the low one) determines whether an existing profile is to be updated with new information from the presented profile, or if a new profile is to be created For example, if the Authentication Threshold is set to 90 and the Update Threshold is set to 89, then the following evaluation would be done on subsequent authentications: <Profile-Score> represents the score of the presented profile, If <Profile-Score> is ≥ 90, then no additional Multi-Factor Authentication is required. If <Profile-Score> is < 90, but ≥ 89, then additional Multi-Factor Authentication is required and the existing profile is updated with the presented profile information. If <Profile-Score> is < 89, then additional Multi-Factor Authentication is required, and a new profile is created. NOTE: If the device recognition cookie is in use and the user login is in the same browser, the existing device profile will be updated with the new profile data.
*Mobile Profile Settings*
FP mode	Set to Cookie to deliver a cookie to the mobile device after authentication. The Mobile App setting has been deprecated.
Cookie name prefix	Keep or change the default cookie name. The cookie name appears as Cookie Name Prefix + company name + hashed value of user ID.
Cookie length	Set the length of time in hours, the cookie is valid. For example, 72 hours.
Match FP ID in cookie	By default, this is set to True. This requires the profile ID to presented and then matched to a profile ID in the directory with an acceptable Authentication Threshold score. Otherwise, if set to False, it does not require ID matching between the cookie and the stored profile.
Skip IP Match	If an exact IP address match is not required for profile comparison, set to True. Otherwise, to require an exact match, set to False.
Authentication threshold (%)	Set the Authentication threshold to a percentage number between 90 and 100.
Update threshold (%)	Set the Update threshold to a percentage number just below the Authentication threshold. This number must be less than the number set in the previous field. For an explanation of thresholds, see the Profile Comparison Score information above.
Other Settings
FP expiration length	Set the number of days the profile is valid. For example, when set to 10 days, the user's profile expires in days, no matter how often it is used. Set to 0 for no expiration.
FP expiration since last access	Set the number of days a profile is not used since the last access; to which the profile no longer valid. For example, when set to 10 days, the user's profile expires when it hasn't been used since it was last employed. Set to 0 for no expiration.
Total FP max count	Set the maximum number of profiles that can be stored in a user's account at a given time. A typical configuration would limit a profile storage maximum from five to eight profiles. Set to -1 for no limit on profile storage maximum.
When exceeding max count	If the Total FP max count is set to a number other than -1, set to one of the following: Allow to replace – Enable replacement of an existing profile with a new one. Not Allow to replace – Profiles cannot be automatically replaced. With this option, the user or administrator must manually remove stored profiles from the user profile on the Self-service Account Update page or Account Management (Help Desk) page.
Replace in order by	If a maximum is set in the Total FP max count and Allow to replace is selected when exceeding the maximum count, set to one of the following: Created Time – Enable replacement of the oldest stored profile with the new one. Last Access Time – Enable replacement of the most recently used profile with the new one.
FP's access records max count	Set to the number of access history entries stored in each profile. Recommended setting is 5.

To modify the Profile Component default weight values, select the * Show Custom Component Weights check box.

Set the components based on how profiles should be analyzed against the Thresholds:

Off – Not considered in profile analysis
Low – Profile analysis is low; small changes do not drastically change profile Component is considered in profile analysis with low effect (small changes do not drastically change profile)

High – Profile analysis is high; significant change could drastically change profile, requiring new profile for device / browser

As an administrator, you can view mismatched components in the Audit log. For example:

<Message>Fingerprint Mismatch: Field=PixelRatio, Weight=8.888889%</Message>

Note: The logs show mismatched components only when the device / browser profile score is higher than the Update Threshold score and is less than 100 percent.

For specific component information, expand the following link.

Custom Component Weights...

Component	Definition	Affected by (example)	Default Weight
Color Depth	Number of bits used to indicate the color of single pixel or number of bits used for each color component of single pixel	Settings change	Off
CPU Class	Classification of central processing unit (CPU)	New device	High
Local Storage	Has local storage or not	Settings change (true / false)	Low
Pixel Ratio	Comparison of width and height of pixel	New device	High
Platform	Framework on which applications run	New platform type	Off
Screen Resolution	Clarity of text and images displayed on screen	Laptop dock, settings change	Off
Available Screen Resolution	Available screen space on display	Laptop dock, settings change, menu bar location	High
Touch Event	Touch screen detection and capabilities	Settings change, mobile to desktop device change	Off
Touch Start	Touch screen detection and capabilities	Settings change, mobile to desktop device change	Off
Max Touch Points	Touch screen detection and capabilities	Settings change, mobile to desktop device change	Off
User Agent	Information about browser and operating system	New browser	High
User Agent Platform	Native platform on which browser runs; mobile platform identifier	New platform type	Off
Header Accept	Supported content types	Settings change	Off
Header Accept Char Set	Supported character set	Settings change	Off
Header Accept Encoding	Supported encoding algorithms	Settings change	Off
Header Accept Language	Supported languages	Settings change	Off
Plugins	List of native plugins	Native plugin addition / removal	High
Fonts	List of browser fonts	Font addition / removal	High
Ad Blocker	Installation of AdBlock	Settings change (true / false)	Off
Add Behavior	Installation of IE specific AddBehavior	Settings change (true / false)	Off
Canvas	HTML5 API used to draw graphics and animations on web page via scripting in JavaScript	New browser	High
Cookies Enabled / Disabled	Browser cookies setting	Settings change (true / false)	Low
Do Not Track	Enablement of DoNotTrack	Settings change (true / false)	Low
Host Address / IP	Host / IP address of device	Network connection change	High
Indexed DB	Has indexed DB or not	Settings change (true / false)	Off
Language	Browser language	Language settings change	High
Open Database	Browser storage allowed in open database	Settings change (true / false)	Off
Session Storage	Has session storage or not	Settings change (true / false)	Off
Timezone Offset	Amount of time subtracted from or added to UTC to get current time	Location change	High
Web GL	JavaScript API for rendering interactive 3D graphics within compatible web browser without use of plug-ins	New device	High
User Tamper Browser	Has user tampered with browser	Tampering (true / false)	Off
User Tamper Language	Has user tampered with language settings	Tampering (true / false)	Off
User Tamper Screen Resolution	Has user tampered with screen resolution settings	Tampering (true / false)	Off
User Tamper OS	Has user tampered with OS settings	Tampering (true / false)	Off

Click Save.
Go to the System Info tab.
In the Plugin Info section, set the Java Detection field to False.
Click Save.

Realm B

These are optional configuration steps to enable administrator (help desk) revocation of user device / browser profiles. This realm must be set up for the Account Management Page post authentication action.

For more information, see Account Management (Help Desk) Page Configuration Guide.

Go to the Data tab.
For Realm B, follow configuration step 2 as described in the Realm A section above.

The directory attribute used for device / browser profiles (for example, audio) must be the same across all the Identity Platform realms using Device Recognition to ensure consistency.
Click Save.
Go to the Post Authentication tab.

In the Post Authentication section, set the following:

Authenticated User Redirect	Set to Account Management.
Redirect To	An unalterable URL Authorized/ManageAccounts.aspx,, is auto-populated in this field, which appends to the domain name and realm number in the address bar.

In the Identity Management section, click the link for Help Desk to enable or disable help desk functions.
On the Help Desk configuration page, set Digital Fingerprints to Show Enabled.
This shows the function on the help desk page and to enable changes (revocation).

Example of Help Desk page fingerprint revocation...
Click Save.

Realm C

These are optional configuration steps to enable end user self-service revocation of device / browser profiles. This realm must be set up for the Self-service Account Update post authentication action.

For more information see Self-service Account Update Page Configuration Guide.

Go to the Data tab.
For Realm C, follow configuration step 2 as described in the Realm A section above.

The directory attribute used for device / browser profiles (for example, audio) must be the same across all the Identity Platform realms using Device Recognition to ensure consistency.
Click Save.
Go to the Post Authentication tab.