---
title: Configuring an OpenToken Adapter instance
description: Configure the OpenToken Adapter to determine how PingFederate communicates with your application.
component: php
page_id: php:setup:pf_php_ik_configuring_an_opentoken_adapter_instance
canonical_url: https://docs.pingidentity.com/integrations/php/setup/pf_php_ik_configuring_an_opentoken_adapter_instance.html
revdate: July 5, 2024
section_ids:
  about-this-task: About this task
  steps: Steps
---

# Configuring an OpenToken Adapter instance

Configure the OpenToken Adapter to determine how PingFederate communicates with your application.

## About this task

These steps are for creating a service provider (SP) adapter instance. You can complete the equivalent steps to create an identity provider (IdP) adapter instance.

## Steps

1. Sign on to the PingFederate administrative console.

2. On the **Service Provider > Adapters** screen, click Create New Instance.

3. On the Type screen, set the basic adapter instance attributes.

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

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

   3. On the Type list, select OpenToken Adapter, and then click Next.

4. On the Instance Configuration screen, configure the adapter instance by referring to [Configuring an OpenToken SP Adapter instance](https://docs.pingidentity.com/pingfederate/latest/administrators_reference_guide/pf_config_opentoken_sp_adapt_instance.html) in the PingFederate documentation. Click Next.

   * In your adapter instance configuration, in the Advanced Fields section, clear the Obfuscate Password check box. The PHP agent does not support encrypted passwords. The password is Base64 encoded.

5. Export the configuration file.

   1. On the Actions screen, click Download, and then click Export.

   2. Save `agent-config.txt`. Click Next.

6. On the Extended Contract screen, add any attributes that you expect to retrieve in addition to core contract attributes. Click Next.

7. On the Summary screen, check that the configuration is correct, and then click Done.

8. On the Manage SP Adapter Instances screen, click Save.

9. Create or update an identity provider (IdP) connection to use the OpenToken Adapter instance. See [Service provider SSO configuration](https://docs.pingidentity.com/pingfederate/latest/administrators_reference_guide/pf_servic_provid_sso_config.html) in the PingFederate documentation.