Incode Deepsight is the AI-powered fraud prevention suite that protects every step of identity verification experiences from deepfakes and identity spoofing injections. This guide will help you enable Deepsight in your integration.

Prerequisites

Deepsight requires additional licensing. After you have purchased Deepsight, contact your Incode Admin to enable the Deepsight feature flag for the requested organization.

Before using Deepsight, you should be familiar with concepts such as multimodal, spoof, evasion, stream frames, jailbroken phones, and deepfakes.

If you have any questions, contact your Incode Admin for assistance.

API Changes With Deepsight

When Deepsight is enabled, the response structure of the GET /omni/get/score API changes.

With Deepsight OFF, the response includes these sections:

• liveness
• deviceRisk
• behavioralRisk sections.

With Deepsight ON, the response includes a deepsight section containing new and enhanced fields that build on the original fields:

• liveness → multimodalIntelligence + new fields.
• deviceRisk → deviceTrust
• behavioralRisk → behavioralTrust
• cameraTrust (new field)

Multi-modal Intelligence

Multi-modal intelligence includes attack detection checks for face domain and attack vectors for document domain.

Face domain:

• Physical Spoof Detection: Catches 2D masks, 3D masks, paper replays, and screen replays. Depth Feed Analysis: Confirms 3D structures.
• Digital Spoof Detection: Catches deepfakes, digitally generated or manipulated images or videos.
• Evasion: Catches extreme expressions, extreme makeup, and paraphernalia.

Document domain:

• AI Generated Document: Catches digitally-generated or manipulated document images.

Implementation

This section contains instructions for implementing Deepsight based on the platform you are using. Use the tabs to switch to the instructions for your platform.

Web SDK

1. Update Web SDK to version 1.80.0 or higher.
2. Contact your Incode representative to request Deepsight for your organization.
3. Enable Deepsight in Workflow or Flow settings:
   1. In the Dashboard left navigation, click Workflows or Flows, depending on your configuration.
   2. Locate the Workflow or Flow you want to enable Deepsight for.
      1. For Workflows, click to open it, then click Edit.
      2. For Flows, click Edit.
   3. Click to switch to the Settings tab.
   4. At the top of the settings page, click to toggle Deepsight ON. If you don’t see Deepsight here, contact your Incode representative to ensure your organization is configured to use Deepsight.
   5. Click Save Changes.
4. Call renderCaptureFace or renderCaptureId SDK methods. Example of renderCaptureFace usage below:

// When rendering the camera for selfie capture
const container = document.getElementById("face-capture-container");
IncodeSDK.renderCaptureFace(container, {
  session={session}
  onSuccess: async (response) => {
    const processFaceResponse = await IncodeSDK.processFace({ token: session.token });
    // go to next step
  },
  onError: (error) => {
    // handle error
  },
});

// When rendering the camera for ID capture
const container = document.getElementById("id-capture-container");
IncodeSDK.renderCaptureId(container, {
  session: session,
  onSuccess: (response) => {
    // ID capture completed successfully
  },
  onError: (error) => {
    // handle error
  },
});

iOS SDK

Standard Mode

1. Update SDK to version 5.35.0 or higher.
2. Contact your Incode representative to request Deepsight for your organization.
3. Enable Deepsight in Workflow or Flow settings:
   1. In the Dashboard left navigation, click Workflows or Flows, depending on your configuration.
   2. Locate the Workflow or Flow you want to enable Deepsight for.
      1. For Workflows, click to open it, then click Edit.
      2. For Flows, click Edit.
   3. Click to switch to the Settings tab.
   4. At the top of the settings page, click to toggle Deepsight ON. If you don’t see Deepsight here, contact your Incode representative to ensure your organization is configured to use Deepsight.
   5. Click Save Changes.
4. Copy the ID for the Workflow or Flow you added Deepsight to. Provide this ID as a configurationId to the methods in the next step.
5. Use startFlow(), startWorkflow(), startOnboarding() or startOnboardingSection() APIs to access the feature.

Important Considerations

• In Standard mode, Video Liveness recording is only available with startFlow() or startWorkflow() APIs.

Capture-Only Mode

To enable Deepsight within the Selfie module, specify the videoLivenessRecording param:

let flowConfig = IncdOnboardingFlowConfiguration()
flowConfig.addSelfieScan(videoLivenessRecording: true)

Important Considerations

• In Capture-Only mode, the video file path is returned in SelfieScanResult.videoFileURL
• In Capture-Only mode, to get the results from Deepsight, you’ll need to call into Incode’s backend with the metadata string received in the IdScanResult or SelfieScanResult objects.

Android SDK

Standard Mode

1. Update SDK version 5.38.0 or later.
2. Contact your Incode representative to request Deepsight for your organization.
3. Enable Deepsight in Workflow or Flow settings:
   1. In the Dashboard left navigation, click Workflows or Flows, depending on your configuration.
   2. Locate the Workflow or Flow you want to enable Deepsight for.
      1. For Workflows, click to open it, then click Edit.
      2. For Flows, click Edit.
   3. Click to switch to the Settings tab.
   4. At the top of the settings page, click to toggle Deepsight ON. If you don’t see Deepsight here, contact your Incode representative to ensure your organization is configured to use Deepsight.
   5. Click Save Changes.
4. Copy the ID for the Workflow or Flow you added Deepsight to. Provide this ID as a configurationId to the methods in next step.
5. Use startFlow(), startWorkflow(), startOnboarding() or startOnboardingSection() APIs to access the feature.

Capture-Only Mode

To enable Deepsight within the Selfie module, call the setVideoLivenessRecordingEnabled method when adding the SelfieScan module:

FlowConfig flowConfig = new FlowConfig.Builder()
    .addSelfieScan(new SelfieScan.Builder()
        .setVideoLivenessRecordingEnabled(true)
        .build()
    )
    .build();

Important Considerations

• In Capture-Only mode, the video file path is returned in SelfieScanResult.videoFilePath
• In Capture-Only mode, to get the results from Deepsight, you’ll need to call into Incode’s backend with the metadata string received in the IdScanResult or SelfieScanResult objects.

React Native SDK

Standard Mode

1. Update SDK version to 9.4.0 or later.
2. Contact your Incode representative to request Deepsight for your organization.
3. Enable Deepsight in Workflow or Flow settings:
   1. In the Dashboard left navigation, click Workflows or Flows, depending on your configuration.
   2. Locate the Workflow or Flow you want to enable Deepsight for.
      1. For Workflows, click to open it, then click Edit.
      2. For Flows, click Edit.
   3. Click to switch to the Settings tab.
   4. At the top of the settings page, click to toggle Deepsight ON. If you don’t see Deepsight here, contact your Incode representative to ensure your organization is configured to use Deepsight.
   5. Click Save Changes.
4. Copy the ID for the Workflow or Flow you added Deepsight to. Provide this ID as a configurationId to the methods in next step.
5. Use startFlow(), startWorkflow(), startOnboarding() or startOnboardingSection() APIs to access the feature.

Flutter SDK

Standard Mode

1. Simply update to SDK version 4.8.0 or later.
2. Contact your Incode representative to request Deepsight for your organization.
3. Enable Deepsight in Workflow or Flow settings:
   1. In the Dashboard left navigation, click Workflows or Flows, depending on your configuration.
   2. Locate the Workflow or Flow you want to enable Deepsight for.
      1. For Workflows, click to open it, then click Edit.
      2. For Flows, click Edit.
   3. Click to switch to the Settings tab.
   4. At the top of the settings page, click to toggle Deepsight ON. If you don’t see Deepsight here, contact your Incode representative to ensure your organization is configured to use Deepsight.
   5. Click Save Changes.
4. Copy the ID for the Workflow or Flow you added Deepsight to. Provide this ID as a configurationId to the methods in next step.
5. Use startFlow(), startWorkflow(), startOnboarding() or startOnboardingSection() APIs to access the feature.

Cordova SDK

Standard Mode

1. Simply update to SDK version 2.8.0 or later.

2. Contact your Incode representative to request Deepsight for your organization.

3. Enable Deepsight in Workflow or Flow settings:

   1. In the Dashboard left navigation, click Workflows or Flows, depending on your configuration.
   2. Locate the Workflow or Flow you want to enable Deepsight for.
      1. For Workflows, click to open it, then click Edit.
      2. For Flows, click Edit.
   3. Click to switch to the Settings tab.
   4. At the top of the settings page, click to toggle Deepsight ON. If you don’t see Deepsight here, contact your Incode representative to ensure your organization is configured to use Deepsight.
   5. Click Save Changes.

4. Copy the ID for the Workflow or Flow you added Deepsight to. Provide this ID as a configurationId to the methods in next step.

5. Use startOnboardingSection method:

cordova.exec(function(winParam) {
     console.log("Section completed successfully: " + winParam);
}, function(err) {
     console.log("Error: " + err);
}, "Cplugin", "startOnboardingSection", ["addId", "addSelfieScan"]);