iovation Integration Kit

Configuring an adapter instance

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

Steps

  1. Sign on to the PingFederate administrative console.

  2. On the Identity Provider → Manage IdP Adapter Instances screen, click Create New Instance.

  3. On the Type screen, 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 iovation IdP Adapter. Click Next.

  4. Optional: On the IdP Adapter screen, in the Transaction Insight Parameters section, configure additional transaction data to send to iovation with the device profile. For an overview, see Transaction insight parameters.

    1. In the iovation IdP Adapter instance configuration, on the IdP Adapter screen, under Transaction Insight Parameters, click Add a new row to 'Transaction Insight Parameters'.

    2. In the Attribute Name field, enter the name of an attribute from any authentication source that appears earlier in your PingFederate authentication policy than the iovation IdP Adapter.

    3. In the iovation API Attribute Name field, enter the transaction insight parameter, such as billingCountry or eventId.

    4. In the Action column, click Update.

    5. To map another transaction insight parameter, repeat steps 1-4.

  5. Optional: On the IdP Adapter screen, in the Optional iovation Attributes section, configure additional attributes to include in the attribute contract from the iovation payload.

    The transactionRiskResult(/result) attribute is already included in the core contract.

    1. Click Add a new row to 'Optional iovation Attributes'.

    2. In the Local Attribute field, type a name of your choosing for an attribute.

    3. In the iovation API Attribute Mapping field, enter the JSON Pointer syntax for the value of the matching iovation attributes as shown in JSON Pointer syntax reference.

    4. In the Action column, click Update.

    5. To add more attributes, repeat steps a-d.

  6. On the IdP Adapter screen, configure the adapter instance by referring to iovation IdP Adapter settings reference. Click Next.

  7. On the Actions screen, test your connection to the iovation API. Resolve any issues that are reported, and then click Next.

  8. On the Extended Contract screen, add any attributes that you included in the Optional iovation Attributes section of the IdP Adapter screen.

  9. Complete the adapter configuration.

  10. On the Summary screen, check that the configuration is correct. Click Done.

  11. On the Manage IdP Adapter Instances screen, click Save.