Mocking services for doc-auth external vendor

This application mocks services like Acuant AssureID or LexisNexis TrueID etc. The default url is http://localhost:8080.

Build requirement

It depends on one wiremock extension library which is hosted on github, customized configuraiton is needed for Maven.

After installation of maven, customize the setting by following Github documentation. To summarize, make sure the repository is configured in ~/.m2/settings.xml looks like

<settings xmlns="http://maven.apache.org/SETTINGS/1.0.0"
  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.0.0
                      http://maven.apache.org/xsd/settings-1.0.0.xsd">

  <activeProfiles>
    <activeProfile>github</activeProfile>
  </activeProfiles>

  <profiles>
    <profile>
      <id>github</id>
      <repositories>
        <repository>
          <id>central</id>
          <url>https://repo1.maven.org/maven2</url>
        </repository>
        <repository>
          <id>github</id>
          <url>https://maven.pkg.github.com/wiremock/wiremock-extension-state</url>
          <snapshots>
            <enabled>true</enabled>
          </snapshots>
        </repository>
      </repositories>
    </profile>
  </profiles>

  <servers>
    <server>
      <id>github</id>
      <username>USERNAME</username>
      <password>TOKEN</password>
    </server>
  </servers>
</settings>

Running the service

Run from code base

mvn spring-boot:run

Run from packaged jar

Package the application

mvn package
# this will generate packaged jar file idk-mock-0.0.1-SNAPSHOT.jar in target directory

Run the jar file

java -jar idk-mock-xxxx.jar

Test scenarios for vendors

Acuant AssureID

A json file can be used as document images to trigger response needed.

The specification of the json file looks like the following:

{
  "front" : {
    "httpStatus": 200|500|438|439|440,
    "fixedDelays": 1000
  },
  "back" : {
    "httpStatus": 200|500|438|439|440,
    "fixedDelays": 1000
  },
  "result": {
    "httpStatus": 500|438|439|440,
    "ognlExpression": "",
    "ognlExpressions": [
      "xxxx",
      "yyyy"
    ],
    "fixedDelays": 1000
  }
}

The "front", "back" and "result" parts specify respose configurations for the three service calls.

The ognlExpression is used to modify a template response using OGNL language. The OGLN language provides the capability not only to navigate the object graph but also to change it.

An example to trigger a 2D Barcode Content alert.

{
  "ognlExpression" : "#this.alerts.{? #this.key=='2D Barcode Content'}[0].result=5, #this.result=5"
}

List of Alert that you can change:

• "2D Barcode Content",
• "2D Barcode Read",
• "Birth Date Crosscheck",
• "Birth Date Valid",
• "Document Classification",
• "Document Crosscheck Aggregation",
• "Document Expired",
• "Document Number Crosscheck",
• "Expiration Date Crosscheck",
• "Expiration Date Valid",
• "Full Name Crosscheck",
• "Image Tampering Check",
• "Issue Date Crosscheck",
• "Issue Date Valid",
• "Sex Crosscheck",

An example to trigger 440 http status code, which means a IMAGE_SIZE failure (438 IMAGE_LOAD_FAILURE, 439 PIXEL_DEPTH_FALURE).

{
  "httpStatus": 440
}

LexisNexis TrueID

List of Alerts

• "Visible Pattern",
• "2D Barcode Content",
• "2D Barcode Read",
• "Birth Date Crosscheck",
• "Birth Date Valid",
• "Document Classification",
• "Document Crosscheck Aggregation",
• "Document Expired",
• "Document Number Crosscheck",
• "Expiration Date Crosscheck",
• "Expiration Date Valid",
• "Full Name Crosscheck",
• "Issue Date Crosscheck",
• "Issue Date Valid",
• "Sex Crosscheck",

TrueID authentication result field failure

An example to change a 2D Barcode Content authentication result.

{
  "ognlExpressions" :  [
    "#detail=#this.products.{parameterDetails.{? group.value=='AUTHENTICATION_RESULT' && name.endsWith('AlertName') && values.{?value=='2D Barcode Content'}.size==1 }}[0][0]",
    "#target_name=#detail.name",
    "#name_seq=#target_name.split(\"_\")[1]",
    "#result_name=\"Alert_\"+#name_seq+ \"_AuthenticationResult\"",
    "#auth_result=#this.products.{parameterDetails.{? group.value=='AUTHENTICATION_RESULT' && name==#result_name }}[0][0]",
    "#auth_result.values[0].value='Failed'"
  ]
}

TrueID uses no http status for data checks, an example to change image metrics.

{
  "ognlExpressions": [
    "#detail=#this.products.{parameterDetails.{? group.value=='IMAGE_METRICS_RESULT' && name=='GlareMetric' }}[0][0]",
    "#detail.values[0].value='10'"
  ]
}

Note:

Part of the wiremock-state-extension configuration code for Springis from the spring-cloud-contract-wiremock project which does support wiremock v3 now.