Page created: 29 Jun 2020
|
Page updated: 8 Feb 2022
| 2 min read
LexisNexis ThreatMetrix Other Documents Integrations Language English Integration Content Type Product documentation Audience Administrator
Configure the ThreatMetrix IdP Adapter to determine how PingFederate communicates with ThreatMetrix.
-
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:
- In the Instance Name field, enter a name for the adapter instance.
- In the Instance ID field, enter a unique identifier for the adapter instance.
- From the Type list, select ThreatMetrix IdP Adapter. Click Next.
- Optional:
On the IdP Adapter tab, in the Additional
User Attributes section, configure user attributes
to send to ThreatMetrix.
Note: For the complete list of user attributes that ThreatMetrix can collect, see Session Query API in the ThreatMetrix documentation.
- Click Add a new row to 'Additional User Attributes'.
- In the Incoming Attribute Name field, enter the name of an attribute from any authentication source that appears earlier in your PingFederate authentication policy than the ThreatMetrix IdP Adapter.
- From the ThreatMetrix Attribute list, select the ThreatMetrix attribute that you want to populate.
- In the Action column, click Update.
- To add more attributes, repeat steps a-d.
- Optional:
On the IdP Adapter tab, in the ThreatMetrix API Response Mappings section, map
attributes and sign-on event data from the ThreatMetrix
response to the attribute contract. These attributes become available in your
PingFederate authentication policy.
- Click Add a new row to 'ThreatMetrix API Response Mappings'.
- In the Local Attribute field, enter a name of your choosing for an attribute.
- In the ThreatMetrix API Attribute Mapping field, enter the JSON Pointer syntax for the value of the matching ThreatMetrix attributes as shown in . Alternately, leave the field blank to include the entire response as the value.
- In the Action column, click Update.
- To add more attributes, repeat steps a-d.
- On the IdP Adapter tab, configure the adapter instance by referring to ThreatMetrix IdP Adapter settings reference. Click Next.
- On the Extended Contract tab, add any attributes that you included in the ThreatMetrix API Response Mappings section of the IdP Adapter tab. 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.