Facebook

Configuring an adapter instance

Configure the Facebook IdP Adapter to determine how PingFederate communicates with the Facebook API.

Steps

  1. In the PingFederate administrative console, create a new IdP adapter instance:

    Choose from:

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

  2. 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 Facebook IdP Adapter. Click Next.

  3. Optional: On the IdP Adapter screen, in the Scope Permissions section, add any additional Facebook scopes that you want to request.

    For more information, see Facebook permissions.

    1. Click Add a new row to 'Scope Permissions'.

    2. In the Additional Facebook Scope Permissions field, enter the name of a scope.

    3. In the Action column, click Update.

    4. To add more scopes, repeat steps a-c.

  4. On the IdP Adapter tab, configure the adapter instance by referring to Facebook IdP Adapter settings reference. Click Next.

  5. On the Extended Contract tab, add any attributes that you want to include in the contract. Click Next.

  6. On the Adapter Attributes tab, set pseudonym and masking options as shown in Set pseudonym and masking options in the PingFederate documentation. Click Next.

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

  8. On the Summary tab, check and save your configuration:

    Choose from:

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