Configuring an adapter instance

Page created: 24 Jul 2019 |

Page updated: 8 Feb 2022

| 3 min read

LinkedIn Other Documents Integrations Language English Integration Content Type Product documentation Audience Administrator

Configure the LinkedIn IdP Adapter to determine how PingFederate communicates with LinkedIn.

In the PingFederate administrative console, create a new IdP adapter instance:
- For PingFederate 10.1 or later: go to Authentication > Integration > IdP Adapters. Click Create New Instance.
- For PingFederate 10.0 or earlier: go to Identity Provider > Adapters. Click Create New Instance.
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 LinkedIn IdP Adapter. Click Next.
Optional: On the IdP Adapter screen, in the Optional LinkedIn Attributes section, define mappings between local attributes and the attributes from the core or extended contract.

For a list of available attributes, see Core contract attributes.
1. Click Add a new row to 'Attribute Selector'.
2. In the Local Attribute field, enter the name of a local attribute.
3. In the LinkedIn Attribute field, enter the JSON Pointer syntax for the value of the matching LinkedIn attribute. For help, see JSON Pointer syntax reference.
  
  Note: The Permissions field on the IdP Adapter screen determines the available attributes.
4. In the Action column, click Update.
5. To add more attributes, repeat steps a-d.
On the IdP Adapter screen, configure the adapter instance by referring to LinkedIn IdP Adapter settings. Click Next.
On the Actions screen, click Test Connection. Resolve any issues that are reported, and then click Next.
On the Extended Contract screen, add attributes that you want to include in the contract.
1. If you selected Retrieve email in the adapter configuration, add the email attribute.
2. Add the list of local attributes that you mapped on the IdP Adapter screen.
3. Add any other LinkedIn attributes that you want to include in the contract.
  
  Note: The values for unmapped LinkedIn attributes will be populated with raw JSON and could include arrays. See Object Types in the LinkedIn API documentation.
4. Click Next
On the Adapter Attributes tab, set pseudonym and masking options as shown in Set pseudonym and masking options in the PingFederate documentation. Click Next.
On the Adapter Contract Mapping tab, configure the contract fulfillment details for the adapter as shown in Define the IdP adapter contract in the PingFederate documentation. Click Next.
On the Summary tab, check and save your configuration:
- For PingFederate 10.1 or later: click Save.
- For PingFederate 10.0 or earlier: click Done. On the Manage IdP Adapter Instances tab, click Save.
If you created this adapter instance to replace an previous one, update the adapter mappings in any related service provider connections.