---
title: Configuring an adapter instance
description: Configure the Jamf IdP Adapter to determine how PingFederate communicates with Jamf Pro.
component: jamf
page_id: jamf:setup:pf_jamf_ik_configuring_an_adapter_instance
canonical_url: https://docs.pingidentity.com/integrations/jamf/setup/pf_jamf_ik_configuring_an_adapter_instance.html
revdate: November 4, 2025
section_ids:
  steps: Steps
---

# Configuring an adapter instance

Configure the Jamf IdP Adapter to determine how PingFederate communicates with Jamf Pro.

## Steps

1. In the PingFederate admin console, go to **Authentication > Integration > IdP Adapters**. Click **Create New Instance**.

2. On the **Type** tab, set the basic adapter instance attributes.

   1. In the **Instance Name** field, enter a name for the adapter instance.

   2. In the **Instance ID** field, enter a unique identifier for the adapter instance.

   3. In the **Type** list, select **Jamf IdP Adapter**. Click **Next**.

3. (Optional) On the **IdP Adapter** tab, in the **Jamf API Response Mappings** section, map attributes from the Jamf Pro response to the attribute contract.

   These attributes become available in your PingFederate authentication policy.

   |   |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
   | - | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
   |   | * The `isManaged` and `isMDMCapable` attributes are already included in the core contract.

   * If you use [Computer Extension Attributes](https://docs.jamf.com/10.27.0/jamf-pro/administrator-guide/Computer_Extension_Attributes.html) or [Mobile Device Extension Attributes](https://docs.jamf.com/10.27.0/jamf-pro/administrator-guide/Mobile_Device_Extension_Attributes.html) in Jamf Pro, use this table to include your extension attributes in the PingFederate attribute contract. |

   1. Click **Add a new row to 'Jamf API Response Mappings'**.

   2. In the **Local Attribute** field, enter a name for the new attribute.

   3. In the **Jamf API Response Mapping** field, enter the JSON Pointer syntax for the value of the matching Jamf Pro attribute.

      You can find help in [JSON Pointer syntax reference](pf_jamf_ik_json_pointer_syntax_reference.html).

   4. In the **Action** column, click **Update**.

   5. To add more attributes, repeat steps a - d.

4. On the **IdP Adapter** tab, configure the adapter instance by referring to [Jamf IdP Adapter settings reference](pf_jamf_ik_jamf_idp_adapter_settings_reference.html). Click **Next**.

5. On the **Actions** tab, test your connection to Jamf Pro. Resolve any issues that are reported, and then click **Next**.

6. On the **Extended Contract** tab, add any local attributes that mapped in the **Jamf API Attribute Mappings** section. Click **Next**.

7. On the **Adapter Attributes** tab, set pseudonym and masking options as shown in [Set pseudonym and masking options](https://docs.pingidentity.com/pingfederate/latest/administrators_reference_guide/pf_setting_pseudonym_masking_options.html) in the PingFederate documentation. Click **Next**.

8. On the **Adapter Contract Mapping** tab, configure the contract fulfillment details for the adapter as shown in [Define the IdP adapter contract](https://docs.pingidentity.com/pingfederate/latest/administrators_reference_guide/help_authnadapterinstancetasklet_plugincontractstate.html) in the PingFederate documentation. Click **Next**.

9. On the **Summary** tab, check your configuration, then click **Save**.