LexisNexis Connector - PingOne - PingOne DaVinci - PingOne Cloud Platform - PingOne Services

Setup

Using the connector in a flow

Get a risk assessment for ThreatMetrix

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.

Note:

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

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

   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

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.

Attention:

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

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.

Details

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.

• Default (https://h.online-metrix.net/fp/tags.js)
• Use Custom Profiling URL

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.

Details

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.

Details

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.

Details

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