---
title: Configuring an adapter instance
description: Configure the Island Enterprise Browser Device Trust IdP Adapter to determine how PingFederate communicates with Island Enterprise.
component: island-enterprise-browser
page_id: island-enterprise-browser:setup:pf_island_browser_configuring_an_adapter_instance
canonical_url: https://docs.pingidentity.com/integrations/island-enterprise-browser/setup/pf_island_browser_configuring_an_adapter_instance.html
revdate: August 6, 2025
section_ids:
  about-this-task: About this task
  steps: Steps
  example: Example:
  next-steps: Next steps
---

# Configuring an adapter instance

Configure the Island Enterprise Browser Device Trust IdP Adapter to determine how PingFederate communicates with Island Enterprise.

## About this task

You must have permission to configure integrations in the Island management console (`fulladmin`, `system admin`). Learn more in [Configure Verified Device Access Integration in Island](https://documentation.island.io/v2/docs/configure-and-manage-verified-device-access-integration-for-ping-identity-1#configure-verified-device-access-integration-in-island) (requires sign-on).

While enabling permissions, identify the advanced settings criteria that align with your organization's requirements. Keep these criteria in mind when configuring a Island Enterprise Browser Device Trust IdP Adapter adapter instance.

## 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 descriptive 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 **Island Enterprise Browser Device Trust IdP Adapter**. Click **Next**.

3. (Optional) On the **IdP Adapter** tab, in the **Island Device Trust API Response Mappings** section, map attributes from the response issued by the Island Verify Challenge Response API endpoint to the attribute contract:

   1. Click **Add a new row to 'Island Device Trust API Response Mappings'**.

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

   3. In the **Verify Challenge Response Attribute Mapping** field, enter the JSON Pointer syntax for the source Island Device Trust API attributes as described in [JSON Pointer syntax](pf_island_browser_json_pointer_syntax_ref.html).

      ### Example:

      The JSON pointer `/deviceSignals/displayName` returns the machine display name.

   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 [Island Enterprise Browser Device Trust IdP Adapter settings reference](pf_island_browser_idp_adapter_settings_ref.html). Click **Next**.

5. On the **Actions** tab, test your connection to the Island Generate Challenge API endpoint. Resolve any reported issues, then click **Next**.

6. On the **Extended Contract** tab, add any attributes you included in the **Island Device Trust API Response Mappings** section of the **IdP Adapter** tab. 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 and save your configuration. Click **Save**.

## Next steps

[Use Island Device Signals](pf_island_browser_using_island_device_signals.html).