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
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:
-
From the Applications tab, click Add Application.
-
Enter a name for the application in the Name field, then click Create.
-
Find the application you created and click Edit.
-
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
.
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.
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.
-
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.
-
Select a Service Type.
-
(Optional) Select an Event Type.
-
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.
-
Define any additional parameters to send to LexisNexis, such as user attributes.
-
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.
The $[ExpirePeriod] variable in the Email Body and SMS Body uses the policy default instead of the value from the OTP Timeout field. |
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.
-
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.
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
- type
- custom_output_12
array
- items
array
-
- type
string
- type
- custom_output_13
array
- items
array
-
- type
string
- type
- custom_output_14
array
- items
array
-
- type
string
- type
- custom_output_15
array
- items
array
-
- type
string
- type
- custom_output_16
array
- items
array
-
- type
string
- type
- custom_output_7
array
- items
array
-
- type
string
- type
- custom_output_9
array
- items
array
-
- type
string
- type
- event_datetime
string
- events_type
string
- integration_hub_results
object
- properties
object
-
- 3c8qvza7:DIIG Identity Verification
object
- properties
object
- 3c8qvza7:DIIG Identity Verification
- 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
- policy_detail_api
- type
object
- properties
{"type":"string"}
- policy_engine_version
string
- policy_score
string
- reason_code
array
- items
array
-
- type
string
- type
- 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
- QuestionSetId
- 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