---
title: Configuring a Reference ID IdP Adapter instance
description: Configure the Reference ID IdP Adapter to determine how PingFederate communicates with your identity provider application.
component: agentless
page_id: agentless:custom_application_setup:pf_agentless_ik_configuring_reference_id_idp_adapter_instance
canonical_url: https://docs.pingidentity.com/integrations/agentless/custom_application_setup/pf_agentless_ik_configuring_reference_id_idp_adapter_instance.html
llms_txt: https://docs.pingidentity.com/integrations/agentless/llms.txt
docs_for_agents: https://developer.pingidentity.com/build-with-ai/docs-for-agents.md
revdate: August 20, 2026
section_ids:
  steps: Steps
  next-steps: Next steps
---

# Configuring a Reference ID IdP Adapter instance

Configure the adapter to direct authentication requests, authorization consent requests, or both to your application.

## Steps

1. In the PingFederate administrative console, go to **Authentication > Integration > IdP Adapters**.

2. Click **Create New Instance**.

3. 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 **Reference ID IdP Adapter**. Click **Next**.

4. On the **IdP Adapter** tab, configure the adapter instance.

   Learn more in [Reference ID IdP Adapter settings reference](pf_agentless_ik_reference_id_idp_adapter_settings_reference.html).

5. Click **Next**.

6. (Optional) On the **Actions** tab, click **Show Pass Phrase** and copy the pass phrase to your application. Click **Next**.

7. On the **Extended Contract** screen, add any attributes that you expect to retrieve in addition to the SAML subject (user ID). If you have an external consent application, add the attribute that contains the authorization scopes. Click **Next**.

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

9. Click **Next**.

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

11. Click **Next**.

12. On the **Summary** tab, review your configuration and click **Save**.

## Next steps

Create an SP connection using this Reference ID IdP Adapter instance.

Learn more in [Identity provider SSO configuration](https://docs.pingidentity.com/pingfederate/latest/administrators_reference_guide/pf_ident_provid_sso_config.html) in the PingFederate documentation.