Connectors

LexisNexis Connector

The LexisNexis connector lets you create a PingOne DaVinci flow that performs risk assessments with ThreatMetrix and other Dynamic Decision Platform services, sends a one-time passcode (OTP), and prompts users with security questions.

You can use the LexisNexis connector to:

  • Get risk assessments from ThreatMetrix with the LexisNexis Dynamic Decision Platform

  • Use the LexisNexis Dynamic Decision Platform to access services defined by your LexisNexis policy

  • Get insights into identity data associated with phone numbers and email addresses

  • Authenticate users with OTPs

  • Authenticate users with security questions

Setup

Resources

For information and setup help, see the following:

Requirements

To use the connector, you’ll need:

  • A LexisNexis account

  • Credentials and access details for the LexisNexis services that you want to use

Configuring LexisNexis

To configure the LexisNexis connector in DaVinci, you will need to create an API Key in DaVinci.

To create an API Key:

  1. From the Applications tab, click Add Application.

  2. Enter a name for the application in the Name field, then click Create.

  3. Find the application you created and click Edit.

  4. From the General tab, copy the API Key.

Configuring the LexisNexis connector

Add the connector in DaVinci as shown in Adding a connector, then configure it as follows.

Connector configuration

API URL

The API URL to target. For a custom value, select Use Custom API URL and enter a value in the Custom API URL field.

Custom API URL

The API URL to target, such as https://h.online-metrix.net.

Organization ID

Your LexisNexis organization ID, such as 4en6ll2s.

API Key

Your LexisNexis API key, such as 3x9ywfs26rm1zvl.

Using the connector in a flow

Get a risk assessment for ThreatMetrix

Screen capture of the spinner page created by the Get Device Profile capability.

Use the Get Device Profile capability followed by the Dynamic Decision Platform (DDP)capability to point to a ThreatMetrix policy name. Use the review_status and risk_rating results from the output to branch your flow.

The Get Device Profile capability presents an interim spinner page while gathering the device profile.

On the UI tab, you can customize the appearance of the spinner page with the HTML, CSS, and Script fields.

Dynamic Decision Platform (DDP)

You can use the Dynamic Decision Platform (DDP) to access services defined by your LexisNexis policy.

  1. From the General tab, select a Query Type.

    Session Query requires a session ID obtained through the Get Device Profile capability and is used for the device-centric operations.

    Attribute Query requires personally identifiable information (PII) to provide a risk rating and is used to trigger the DDP Rules Engine with a policy.

  2. Select a Service Type.

  3. (Optional) Select an Event Type.

  4. In the Policy field, type the name of the Dynamic Decision Platform policy to use for this capability.

    The policy name entered in the Policy field must match exactly with the policy name defined in LexisNexis. To modify a policy, reach out to LexisNexis support.

  5. Define any additional parameters to send to LexisNexis, such as user attributes.

  6. Click Apply.

Prompt a user for a one-time passcode

Screen capture of the OTP user-facing page created by the OTP Prompt capability.

You can use the OTP Prompt capability to prompt users for a one-time passcode. On the UI tab, you can customize the appearance of the prompt with the HTML, CSS, and Script fields.

The $[ExpirePeriod] variable in the Email Body and SMS Body uses the policy default instead of the value from the OTP Timeout field.

Prompt a user with security questions

Screen capture of the user-facing page created by the InstantID Q&A capability.

You can use the InstantID Q&A capability to prompt a user with security questions. On the UI tab, you can customize the appearance of the prompt with the HTML, CSS, and Script fields.

Capabilities

Get Device Profile

Show an interim page to collect the user’s device profile and get a session ID. Required for ThreatMetrix and other Session Query-based DDP services.

Show details
Properties
DDP Profiling URL dropDown

The source of the device profiling script. For a custom value, select Use Custom Profiling URL and enter a value in the Custom Profiling URL field.

Custom Profiling URL textField required

The URL for the device profiling script, such as “https://h.online-metrix.net/fp/tags.js”.

Default:

https://h.online-metrix.net/fp/tags.js
Device Profiling Message textField

The message to show when collecting the device profile.

Default:

Profiling your device
Input Schema
default object
ddpProfilingUrl string required
orgId string required
Output Schema
output object
sessionId string

Dynamic Decision Platform (DDP)

Use the LexisNexis Dynamic Decision Platform (DDP) to perform risk assessments with ThreatMetrix or access Emailage, Phone Finder, and other services as defined by your LexisNexis policy.

Show details
Properties
Query Type dropDown

Select the Query type to use.

  • Session

  • Attribute

Session Id textField required

The unique ID associated with the device profile, provided by the Get Device Profile capability.

Service Type dropDown

Select the LexisNexis service to use.

  • 3DS

  • All

  • Basic

  • Device

  • IP

  • Session Policy

  • Session

  • Device Identifier

Event Types dropDown

Select the LexisNexis event type to use.

  • Login

  • Pre-Login

  • Failed Login

  • Account Creation

  • Account Details Change

  • Password Reset

  • Device Registration

  • Device Authentication

Policy textField required

The name of the Dynamic Decision Platform policy to use. You can find the policy names in your LexisNexis portal.

Account Login textField

The unique identifier for the user, such as “jsmith”.

Other Params keyValueList

Define additional parameters to send to LexisNexis.

Input Schema
default object
apiKey string required
orgId string required
policy string required
service_type string required
account_login string
queryType string required
session_id string
Output Schema
output object
rawResponse object
properties object
account_address_city string
account_address_state string
account_address_street1 string
account_address_zip string
account_date_of_birth string
account_first_name string
account_last_name string
account_telephone string
account_telephone_is_possible string
account_telephone_is_valid string
account_telephone_type string
api_call_datetime string
api_type string
api_version string
champion_request_duration string
custom_count_10 string
custom_count_12 string
custom_count_15 string
custom_count_8 string
custom_count_9 string
custom_output_11 array
items array
type string
custom_output_12 array
items array
type string
custom_output_13 array
items array
type string
custom_output_14 array
items array
type string
custom_output_15 array
items array
type string
custom_output_16 array
items array
type string
custom_output_7 array
items array
type string
custom_output_9 array
items array
type string
event_datetime string
events_type string
integration_hub_results object
properties object
3c8qvza7:DIIG Identity Verification object
properties object
Execute DIIG object
properties object
rule_id string
tps_datetime string
tps_duration string
tps_result string
tps_type string
tps_vendor string
tps_vendor_raw_response string
tps_was_timeout string
national_id_number string
national_id_type string
org_id string
policy string
policy_details_api object
properties object
policy_detail_api array
items array
type object
properties {"type":"string"}
policy_engine_version string
policy_score string
reason_code array
items array
type string
request_id string
request_result string
review_status string
risk_rating string
service_type string
tps_was_timeout string
transactionStatus string

OTP Prompt

Prompt the user for a one-time passcode sent via voice, SMS, or email.

Show details
Properties
Policy textField required

The name of the Dynamic Decision Platform policy to use. You can find the policy names in your LexisNexis portal.

Delivery Method dropDown

The method to use to deliver the OTP. To change the method dynamically, select Use Dynamic Delivery Method and provide a variable in the Dynamic Delivery Method field.

  • SMS

  • Email

  • Voice

  • Use Dynamic Delivery Method

Email Title textField

The title of the email message containing the OTP.

Default:

Please, check out this email! It's your one-time passcode!
Email Body textArea

The body of the email message containing the OTP.

Default:

Your One Time Password is ${OTP}.${LineBreak}We will never call you for this code.${LineBreak}Your passcode will expire in ${ExpirePeriod} minutes
SMS Message textArea

The body of the SMS message containing the OTP. LexisNexis does not support special characters for messages.

Default:

This passcode be used once and expires in ${ExpirePeriod} minutes. Do not give this code to anyone.${LineBreak}Your one-time passcode is:${LineBreak}${OTP}
Email textField

The user’s email address, such as “jsmith@example.com”.

Phone Number textField

The user’s phone number, including country code, such as “1-604-697-7040”.

OTP Length dropDown

The number of digits in the OTP.

  • 6

  • 7

  • 8

  • 9

OTP Timeout textField

The amount of time in minutes that the OTP is valid.

Other Params keyValueList

Define additional parameters to send to LexisNexis.

Form validation rules validationRules

Rules to check to validate form inputs

Default:

[
	{
		"propertyName": "otp_code",
		"rules": [
			{
				"ruleName": "presence",
				"message": "Please enter the one-time passcode"
			}
		]
	}
]
Input Schema
default object
apiKey string
orgId string
policy string
service_type string
deliveryMethod string
emailTitle string
emailBody string
smsMessage string
otpLength string
otpTimeout string
email string
phoneNumber string
Output Schema
output object
rawResponse object
message string

InstantID Q&A Prompt

Challenge users with knowledge-based questions.

Show details
Properties
Policy textField required

The name of the Dynamic Decision Platform policy to use. You can find the policy names in your LexisNexis portal.

Other Params keyValueList

Define additional parameters to send to LexisNexis.

Input Schema
default object
apiUrl string required
orgId string required
apiKey string required
policy string
Output Schema
output object
rawResponse object
properties object
account_address_city string
account_address_country string
account_address_state string
account_address_street1 string
account_email string
account_first_name string
account_last_name string
auth_method string
auth_status string
event_datetime string
events_type string
answers object
properties object
QuestionSetId string
Questions array
items array
type object
properties
input_request_id string
original_event_created string
original_event_updated string
policy string
policy_engine_version string
policy_site_id string
request_duration string
request_id string
request_result string
review_status string