The Socure connector lets you verify identity documents and get fraud scores in your PingOne DaVinci flows.
The connector allows you to direct users to a unique verification URL where they submit their driver license or passport along with selfie photos. After Socure verifies the user's identity, it sends the results to DaVinci where you can branch your flow accordingly.
To make sure a camera is available to scan the documents and take photos, the user typically completes the verification process on a mobile device.
Setup
Resources
For information and setup help, see the following documentation:
- DaVinci documentation:
Requirements
To use the connector, you'll need:
- A Socure license
Configuring the Socure connector
Add the connector in DaVinci as shown in Adding a connector, then configure it as follows.
Connector configuration
ID+ Key
Your Socure ID+ key, such as “a1b234cd-75e1-9e01-f234-56abcdef6789”.
Get this key from Setting up Socure.
SDK Key
Your Socure SDK key, such as "d450e856-9e01-75e1-8cec-64efe8eef39b".
Get this key from Setting up Socure.
API URL
The Socure API URL to target. Select the environment that you chose in Getting your Socure ID+ and SDK keys.
Get this URL from Setting up Socure.
Webhook URL
The DaVinci webhook URL for this instance of your connector.
Copy this URL. You'll use it in Setting up Socure.
Setting up Socure
- Allowing the DaVinci webhook URL in your Socure configuration
-
- Sign on to the Socure administrator portal at https://admin.socure.com.
- Go to New Webhook. . Click
- In the Subscription Type list, select Document Verification.
- In the Subscription Channel Name field, enter a name.
- In the Webhook URL field, enter the webhook URL that you copied from your Socure connector configuration.
- Leave the Secret Key field blank.
- Leave the Choose certificate section blank.
- Click Test. Check that the test was successful.
- Click Create.
- Allowing the DaVinci domain in your Socure configuration
-
See IP address and domain reference for a list of domains that DaVinci uses. Follow the steps below to add all of the domains for your region:
- Sign on to the Socure administrator portal at https://admin.socure.com.
- Go to .
- Click New Domain.
- In the IP/DOMAINS field, enter the domain. Click Create.
- Repeat this process for each DaVinci domain in your region.
- Getting your Socure ID+ and SDK keys
-
Important:
Your ID+ Key and SDK Key are different for each environment.
- Sign on to the Socure administrator portal at https://admin.socure.com.
- Select the environment you want to connect to:
- Click your organization.
- Click to select the Production, Certification, or Sandbox environment.
- Go to SDK Key to get your ID+ and SDK keys. and
Using the connector in a flow
Verify identity documents with a link or QR code
This flow uses Socure to get a unique verification URL and show it as a link and QR code in the user's web browser. When the user opens the link with their mobile device, they are guided through the process of submitting photos of their identification card (either a driver license or passport) and taking a selfie photo. After the documents and photos are accepted, the flow continues where it started in the web browser.
This flow creates a "challenge" to pause the main flow on the QR code while a secondary flow continues the verification process. When the verification process is complete, a Challenge connector resolves the challenge and triggers the main flow to continue. To learn more about this technique, see the Challenge connector.
- Download the Socure - Identity verification with link or QR code flow template. For help, see Using DaVinci flow templates.
- On the flow canvas, select the Get a Document Verification URL and QR Code node.
- (Optional) In the Customer User ID field, change the value to a test user ID that exists in your Socure records. In a real-world flow, click {} and populate this with a variable from earlier in your flow.
- (Optional) Customize the document verification prompt:
- Select the Verification Prompt node.
- In the Message Title field, customize the title of the prompt.
- In the Message field, customize the user-facing text.
- Click Apply.
- Test the flow:
- Click Save, Deploy, and Try Flow.
- With your mobile device, scan the QR code and open the link.
- Complete the document verification process on your mobile device.
- See the result in your web browser on the original device.
Verify identity documents with an SMS prompt
In this flow, Socure prompts the user to enter their phone number in their web browser. Socure sends an SMS message to the number, which guides the user through the process of submitting photos of their identification card (either a driver license or passport) and taking a selfie photo. After the documents and photos are accepted, the flow continues where it started in the web browser.
This flow creates a "challenge" to pause the main flow on the QR code while a secondary flow continues the verification process. When the verification process is complete, a Challenge connector resolves the challenge and triggers the main flow to continue. To learn more about this technique, see the Challenge connector.
- Download the Socure - Identity verification with SMS prompt flow template. For help, see Using DaVinci flow templates.
- (Optional) Customize the "Check Your Device" message:
- Select the Check Your Device node.
- In the Message Title field, customize the title of the prompt.
- In the Message field, customize the user-facing text.
- Click Apply.
- Test the flow:
- Click Save, Deploy, and Try Flow.
- Register a new user or sign in with an existing user.
- Enter your mobile device SMS number.
- Complete the document verification process on your mobile device.
- See the result in your web browser on the original device.
Getting ID+ scores
You can use the connector to get a variety of risk scores, fraud scores, and other information based on information you provide about a person or device.
This flow sends information about a person to Socure then shows the resulting score. You can customize the information you send to and get from Socure.
- Download the Socure - ID+ score check flow template. For help, see Using DaVinci flow templates.
- Select the Socure ID+ modules that you want to use:
- On the flow canvas, select the Get an ID+ Score node.
- In the Modules list, select one or more modules.Note:
Socure ID+ modules represent a variety of data sources that verify identities. For more information, see ID+ Modules in the Socure documentation.
When you use the Get an ID+ Score capability, you can select as many modules as you want, with the following limitations:
- Only select modules that you have a license to use in Socure.
- Only select one Global Watchlist module.
- If you select the Decision module, you have to select at least one other module. For more information, see Decision in the Socure documentation.
- The Device Risk capability requires a device session ID. To get a session ID, include the device profiling script in your web app. The script sends a device profile to Socure and provides a session ID that DaVinci uses to get the device risk score. For help, see Sigma Device Client-Side Javascript in the Socure documentation.
- Populate the personal attributes by clicking {} and
selecting variables from your flow.Note:
For demonstration purposes, the flow template includes an HTML form with pre-filled information. When you build your own flow, you can collect information about the person from a form, database, or another source in your flow.
- Populate the Document UUID field with the unique ID for an identity document that the person submitted.
- Click Apply.
- Test the flow:
- Click Save, Deploy, and Try Flow.
- Submit the HTML form.
Capabilities
- Verify a Document
-
Verify the authenticity of an identity document. This uses the Socure Predictive Document Verification Web SDK.
Details - Wait for the Documentation Verification Result
-
Wait for Socure to send the result of a document verification check to the DaVinci webhook URL.
Details - Get an ID+ Score
-
Get a Socure ID+ score for a user based on the ID+ modules that you select. The result is a number between 0 and 1, with a higher value indicating higher probability of fraud.
Details - Make Custom API Call
-
Define and invoke custom call to the Socure REST API.
Details - Get a Document Verification URL and QR Code
-
Get a unique document verification URL and QR code based on a user identifier.
Details