---
title: Configuring an adapter instance
description: Configure the ForgeRock Intelligent Access IdP Adapter to determine how PingFederate communicates with ForgeRock Intelligent Access.
component: forgerock-intelligent-access
page_id: forgerock-intelligent-access:setup:pf_forgerock_intelligent_access_ik_configuring_an_adapter_instance
canonical_url: https://docs.pingidentity.com/integrations/forgerock-intelligent-access/setup/pf_forgerock_intelligent_access_ik_configuring_an_adapter_instance.html
revdate: June 10, 2024
section_ids:
  about-this-task: About this task
  steps: Steps
  result: Result:
  next-steps: Next steps
---

# Configuring an adapter instance

Configure the ForgeRock Intelligent Access IdP Adapter to determine how PingFederate communicates with ForgeRock Intelligent Access.

## About this task

To begin the integration, deploy the ForgeRock Intelligent Access Integration Kit files to your PingFederate directory.

## Steps

1. In the PingFederate administrative console, go to **Authentication > Integration > IdP Adapters** and 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. From the Type list, select ForgeRock Intelligent Access IdP Adapter. Click Next.

3. **Optional:** On the **IdP Adapter** tab, in the **Response Mappings** section, map attributes from the ForgeRock Intelligent Access response to the attribute contract:

   1. In the **Local Attribute** field, enter a name of your choosing for an attribute.

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

   3. To add more attributes, repeat steps a-b.

      ### Result:

      These attributes become available in your PingFederate authentication policy.

4. On the IdP Adapter tab, configure the adapter instance by referring to [ForgeRock Intelligent Access IdP Adapter settings reference](pf_forgerock_intelligent_access_ik_forgerock_intelligent_access_idp_adapter_settings_reference.html). Click Next.

5. On the Extended Contract tab, add any attributes that you included in the ForgeRock Intelligent Access Response Mappings section of the IdP Adapter tab. Click Next.

6. 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.

7. 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.

8. On the **Summary** tab, review your configuration. Click **Save**.

## Next steps

Review [Using ForgeRock Intelligent Access Journey](pf_forgerock_intelligent_access_ik_using_forgerock_intelligent_access_journey.html).