Connectors

Device Policy Connector

The Device Policy connector lets you check the user agent, browser information, and operating system version in your PingOne DaVinci flow.

You can use the Device Policy connector to:

  • Enable mobile device management.

    • Selected devices, browsers, and operating systems included in the allow list grants access to users.

    • Selected devices, browsers, and operating systems included in the deny list will prevent access to users.

  • Implement risk intelligence by creating a device policy.

This connector relies on information provided by the device’s user agent. Because the implementation of user agent varies, the information might

Setup

Resources

For more information and setup help, see the following:

Configuring the Device Policy connector

In DaVinci, add a Device Policy connector. For help, see Adding a connector.

This connector doesn’t have a configuration at the environment level. You configure it in your flow instead.

Using the connector in a flow

Allow requests from specified devices

The connector has several capabilities to select allowed devices:

  • Allow selected OS

  • Allow selected user agent

No special configuration is needed. Add the capability and populate its properties according to the help text.

Deny requests from specified devices

The connector has several capabilities to select denied devices:

  • Deny selected OS

  • Deny selected user agent

No special configuration is needed. Add the capability and populate its properties according to the help text.

Get information about a device

The connector has several capabilities to get information about a user’s device:

  • Get operating system

  • Get browser

  • Get platform

No special configuration is needed. Add the capability and populate its properties according to the help text.

Capabilities

Trusted Device OS

Show details

  • Properties

  • Input Schema

  • Output Schema

deviceOSName dropDownMultiSelect

  • default object

    • userAgent string required

    • properties object

      • deviceOSName array required

  • output object

    • deviceOSName string

Output Example

 { "deviceOSName" : "MacOS" }

Blacklisted Device OS

Show details

  • Properties

  • Input Schema

  • Output Schema

deviceOSName dropDownMultiSelect

  • default object

    • userAgent string required

    • properties object

      • deviceOSName array required

  • output object

    • deviceOSName string

Output Example

 { "deviceOSName" : "MacOS" }

Trusted User Agent

Show details

  • Properties

  • Input Schema

  • Output Schema

browserNames dropDownMultiSelect

  • default object

    • userAgent string required

    • properties object

      • browserNames array required

  • output object

    • browserName string

Output Example

 { "browserName" : "chrome" }

Blacklisted User Agent

Show details

  • Properties

  • Input Schema

  • Output Schema

browserNames dropDownMultiSelect

  • default object

    • userAgent string required

    • properties object

      • browserNames array required

  • output object

    • browserName string

Output Example

 { "browserName" : "chrome" }

Get Device OS

Return the Device OS name

Show details

  • Input Schema

  • Output Schema

  • default object

    • userAgent string required

  • output object

    • deviceOSName string

Output Example

 { "deviceOSName" : "MacOS" }

Get Browser

Returns the Name of the Browser that is used.

Show details

  • Input Schema

  • Output Schema

  • default object

    • userAgent string required

  • output object

    • browserName string

Output Example

 { "browserName" : "Chrome" }

Get Platform

Returns whether the flow is running in mobile or desktop.

Show details

  • Input Schema

  • Output Schema

  • default object

    • userAgent string required

  • output object

    • platform string

Output Example

 { "platform" : "mobile" }