---
title: Extending an IdP adapter contract
description: You can use the Extended Contract tab to extend the contract of existing identity provider (IdP) adapters, especially those using the Composite Adapter.
component: pingfederate
version: 12.3
page_id: pingfederate:administrators_reference_guide:pf_extending_idp_adapter_contract
canonical_url: https://docs.pingidentity.com/pingfederate/13.1/administrators_reference_guide/pf_extending_idp_adapter_contract.html
llms_txt: https://docs.pingidentity.com/pingfederate/llms.txt
docs_for_agents: https://developer.pingidentity.com/build-with-ai/docs-for-agents.md
revdate: September 30, 2026
superseded_by: https://docs.pingidentity.com/pingfederate/13.1/administrators_reference_guide/pf_extending_idp_adapter_contract.html
section_ids:
  about-this-task: About this task
  steps: Steps
---

# Extending an IdP adapter contract

You can use the **Extended Contract** tab to extend the contract of existing identity provider (IdP) *(tooltip: \<div class="paragraph">
\<p>A service that manages identity information and provides authentication services to relying clients or SPs within a federated or distributed network.\</p>
\</div>)* adapters, especially those using the Composite Adapter.

## About this task

If you are using the Composite Adapter, you must add attributes from the IdP adapter instances that comprise the composite configuration in this tab. Learn more in [Composite Adapter](pf_composite_adapt.html).

If the adapter doesn't return values for the extended attributes, or if you prefer to fulfill them differently using datastore queries, dynamic text values, or results from OGNL expressions, you can define their fulfillment on the **Adapter Contract Mapping** tab. Learn more in [Defining the IdP adapter contract](help_authnadapterinstancetasklet_plugincontractstate.html).

|   |                                                                                            |
| - | ------------------------------------------------------------------------------------------ |
|   | If this is a child instance, select the **Override** checkbox to modify the configuration. |

## Steps

1. Go to **Authentication > Integration > IdP Adapters**.

2. Click the name of the IdP adapter instance you want to modify.

3. On the **Create Adapter Instance** window, select the **Extended Contract** tab.

4. For each attribute that you want to add, enter the name of the attribute under **Extend the Contract** and click **Add**.

   |   |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
   | - | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
   |   | For adapters that can be configured with a risk adapter, you can add risk provider attributes to the extended contract. The following risk provider attributes are available:Risk Provider	Attributes&#xA;&#xA;Google reCAPTCHA v2&#xA;&#xA;&#x9;&#xA;&#xA;captchaChallengeTime&#xA;&#xA;&#xA;&#xA;&#xA;Google reCAPTCHA v3&#xA;&#xA;&#x9;&#xA;&#xA;captchaChallengeTime&#xA;&#xA;captchaScore&#xA;&#xA;&#xA;&#xA;&#xA;Google reCAPTCHA Enterprise&#xA;&#xA;&#x9;&#xA;&#xA;captchaChallengeTime&#xA;&#xA;captchaReasons&#xA;&#xA;captchaScore&#xA;&#xA;&#xA;&#xA;&#xA;PingOne Protect&#xA;&#xA;&#x9;&#xA;&#xA;riskLevel&#xA;&#xA;riskValue&#xA;&#xA;riskScore&#xA;&#xA;recommendedActionLearn more in [Managing CAPTCHA and risk providers](pf_managing_captcha_risk_providers.html) or [Configuring a provider instance](https://docs.pingidentity.com/integrations/pingone/pingone_protect_integration_kit/pf_p1_protect_ik_configuring_a_provider_instance.html). |

5. Click **Save**.
