Field Description
API Username

The username that you created in Creating API credentials in Jamf Pro.

API Password

The password that you created in Creating API credentials in Jamf Pro.

API Hostname

The hostname for the Jamf Pro server.

For example:

  • company-name.jamfcloud.com
  • jamf-pro.companyname.com:8443
Device Identifier

The attribute used to uniquely identify the user's authentication device.

The adapter gets this attribute from the device's X.509 certificate and uses it to query the Jamf Pro for the device's security posture.

This attribute must be available in the core or extended of your X.509 Certificate IdP Adapter instance.

The default selection is Serial Number.

Device Type Attribute

The attribute that identifies whether the device is a computer or mobile device.

The adapter gets this attribute from the device's X.509 certificate and uses it to determine which Jamf Pro API to query.

The value of the attribute must be computers or mobiledevices.

If the device type is provided in this attribute, the value overrides the Possible Device Types setting.

The default value is deviceType.

Possible Device Types

Determines which Jamf Pro API the adapter queries for a device's security posture.

Jamf Pro provides two separate APIs, one for computers and the other for mobile devices. This setting allows you to eliminate unecessary calls to one API if your users all use the same device type (either computers or mobile devices).

If a valid Device Type Attribute is available, that value overrides this setting.

The default selection is Computers.

Failure Mode

Determines whether the adapter blocks the user's sign-on attempt when it cannot find the device or the connection to Jamf Pro fails.

The default selection is Bypass authentication.

API Request Timeout

The amount of time in milliseconds that PingFederate allows when establishing a connection with Jamf Pro or waiting for a response to a request. A value of 0 disables the timeout.

The default value is 5000.

Proxy Settings

Defines proxy settings for outbound HTTP requests.

The default value is System Defaults.

Custom Proxy Host

The proxy server hostname to use when Proxy Settings is set to Custom.

This field is blank by default.

Custom Proxy Port

The proxy server port to use when Proxy Settings is set to Custom.

This field is blank by default.