PingOne Platform APIs

Application - Device Requirements (PingID mobile app only)

Use the deviceRequirements endpoint to set device requirements for using the PingID app, for example, the minimum Android or iOS version required.

Device requirements data model

Property Type Required? Mutable? Description

application.id

String

N/A

Read-only

The PingOne ID of the application.

deviceLockEnableRequire.enabled

Boolean

Optional

Mutable

Set to true if you want to require a user’s device to have a device lock enabled in order to use the PingID mobile app.

deviceNotAllowedRootedOrJailBroken.enabled

Boolean

Optional

Mutable

Set to true if you want to prevent users from using the PingID mobile app on a rooted or jailbroken device.

deviceRequireBiometricsCapabilities.enabled

Boolean

Optional

Mutable

Set to true if you want to require a user’s device to have biometric capabilities such as fingerprint reading in order to pair or authenticate with the PingID mobile app.

environment.id

String

N/A

Read-only

The PingOne environment associated with the application.

minimumOSVersionRequire.enabled

Boolean

Optional

Mutable

Set to true if you want to specify a minimum operating system version on the device to allow pairing and authentication with the PingID mobile app. Use minimumOSVersionRequire.android and ` minimumOSVersionRequire.ios` to specify the minimum versions for Android and iOS.

minimumOSVersionRequire.android

String

Optional

Mutable

If minimumOSVersionRequire.enabled is set to true, use android to specify the minimum Android version that you want to require.

minimumOSVersionRequire.ios

String

Optional

Mutable

If minimumOSVersionRequire.enabled is set to true, use ios to specify the minimum iOS version that you want to require.

minimumPingIDAppVersionRequire.enabled

Boolean

Optional

Mutable

Set to true if you want to specify a minimum version of the PingID mobile app on the device to allow pairing and authentication with the app. Use minimumPingIDAppVersionRequire.android and minimumPingIDAppVersionRequire.ios to specify the minimum versions for Android and iOS.

minimumPingIDAppVersionRequire.android

String

Optional

Mutable

If minimumPingIDAppVersionRequire.enabled is set to true, use android to specify the minimum PingID version that you want to require on Android.

minimumPingIDAppVersionRequire.ios

String

Optional

Mutable

If minimumPingIDAppVersionRequire.enabled is set to true, use ios to specify the minimum PingID version that you want to require on iOS.

mobileDeviceManagementRequire.enabled

Boolean

Optional

Mutable

If you require mobile device management for all devices using the PingID mobile app, set to true to generate a token.

mobileDeviceManagementRequire.effectiveDate

Date

Optional

Mutable

Use effectiveDate to specify the date by which you want the MDM requirement to be applied. Required when mobileDeviceManagementRequire.enabled is set to true.

mobileDeviceManagementRequire.tokens

Array

Optional

Mutable

Contains the information for tokens generated for mobile device management. Required when mobileDeviceManagementRequire.enabled is set to true.

mobileDeviceManagementRequire.tokens[].creationTime

String

Optional

Mutable

The date and time the token was generated. Required when mobileDeviceManagementRequire.enabled is set to true.

mobileDeviceManagementRequire.tokens[].token

String

Optional

Mutable

The token generated for mobile device management. Required when mobileDeviceManagementRequire.enabled is set to true.

restrictDevicesByBrand.enabled

Boolean

Optional

Mutable

Set to true if you want to limit use of the PingID mobile app to a group of device brands or device models. You can specify the brands/devices that can be used by defining an allow list or by defining a disallow list.

restrictDevicesByBrand.deviceBrandsAllowed

Array

Optional

Mutable

Array of the device brand names that you are limiting use of the PingID app to.

restrictDevicesByBrand.deviceBrandsDisAllowed

Array

Optional

Mutable

Array of the device brand names for which you are not allowing use of the PingID mobile app.

restrictDevicesByBrand.deviceModelsAllowed

Array

Optional

Mutable

Array of the device model names that you are limiting use of the PingID app to.

restrictDevicesByBrand.deviceModelsDisAllowed

Array

Optional

Mutable

Array of the device model names for which you are not allowing use of the PingID mobile app.

updatedAt

Date

N/A

Read-only

The time the resource was last updated.