Trust Bioidentity v3

Bioidentity v3 is an SDK responsible for providing identity validation through a photograph of a person's fingerprint using the camera of a mobile device

Table of content

• Implementation
• Permissions
• Methods

• Builder
  • Init
  • Request Validation
  • Request Enrol
  • Handle Response

• Responses
• Errors
• Logs

Implementation

To enable the retrieval of Trust Technologies hosted packages via Gradle, the first step is to add your repository to the build.gradle file (project level).

To do add the following, at any location, to your build.gradle file:

  repositories {  
     maven { url" https://dl.cloudsmith.io/q5Eobaq15KV0Rlk3/trusttechnologies/bioidentityv3/maven/" }
}

After the repository is added to the build.gradle file, all that is left is to specify the dependency in the dependencies section of the project build.gradle file (app level).

To do this add the below to your build.gradle file (app level):

dependencies {    
 implementation 'com.trust.bioidentity:Bioidentity:1.0.1'
}   

See the actual version here.

Permissions

For the correct use of the SDK camera permissions are needed.

<uses-permission android:name="android.permission.CAMERA" />

Methods

Builder

Name	Description	Default Value	Optional
context	Specifies the context	-	No
nin	DNI of the user	-	No
country	Specifies the country	CHL	No
index	-	-	-
strategyType	Specifies the finger	FINGER	No
companyId	Specifies the id of the company	-	No
provider	Specifies the provider company	TRUST	No
clientId	Specifies the client Id	-	No
clientSecret	Specifies the client secret	-	No
transactionId	Specifies the transaction Id	null	Yes

Example Builder

val trust = Bioidentity.Builder()  
    .withContext(this)  
    .withCompanyId(1)  
    .withIndex(2)  
    .withClientId(<YOUR_CLIENT_ID>)  
    .withClientSecret(<YOUR_CLIENT_SECRET>)
    .withProvider(Provider.TRUST)  
    .withCountry(Country.CHL)  
    .withStrategyType(Strategy.FINGER)  
    .build()

Init

Bioidentity.init(context)

Request validation

trust.requestValidation()

Request enrol

trust.requestEnrol()

Handle response

TrustBioidentify.handleResponse(resultCode: Int, data: Intent?): TrustBioidentifyResponse

Responses

Response	Description
RESULT_CANCELED	The user has canceled the process
RESULT_FIRST_USER	Service error has occurred
RESULT_OK	Validation was successful
RESULT_REJECTED	Validation was rejected

Errors

Possible errors that can be found when integrating the SDK

Code	Value
0	Unknow error
400	Bad request
401	The request was unauthorized
403	The request was forbidden
404	The requested could not be found
405	Method not allowed
500	Internal server error
501	Not implemented
502	Bad gateway
503	Service unavailable
2000	Error code bioidentity response
2003	Unsupported code bioidentity response
9000	Server error

Logs

The logs can only be seen in the debug environment and through the TAG "PRETTY_LOGGER"

to see the logs of the calls to the server, they can be seen through the TAG OkHttpClient

Log example

┌──────────────────────────────────────────────────────────────────────────────────
│ Thread: main
├┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄
│ ErrorManagerKt.objectToJsonError (ErrorManager.kt:122)
│ TrustLog.e (TrustLog.kt:16)
├┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄
│ {"errorCode":1000,"errorMessage":"ID must not be null or empty","stackTrace":[]}
└──────────────────────────────────────────────────────────────────────────────────