IDAnalyzer 1.2.2
dotnet add package IDAnalyzer --version 1.2.2
NuGet\Install-Package IDAnalyzer -Version 1.2.2
<PackageReference Include="IDAnalyzer" Version="1.2.2" />
paket add IDAnalyzer --version 1.2.2
#r "nuget: IDAnalyzer, 1.2.2"
// Install IDAnalyzer as a Cake Addin #addin nuget:?package=IDAnalyzer&version=1.2.2 // Install IDAnalyzer as a Cake Tool #tool nuget:?package=IDAnalyzer&version=1.2.2
ID Analyzer .NET SDK
This is a .Net SDK for ID Analyzer Identity Verification APIs, though all the APIs can be called with without the SDK using simple HTTP requests as outlined in the documentation, you can use this SDK to accelerate server-side development.
We strongly discourage users to connect to ID Analyzer API endpoint directly from client-side applications that will be distributed to end user, such as mobile app, or in-browser JavaScript. Your API key could be easily compromised, and if you are storing your customer's information inside Vault they could use your API key to fetch all your user details. Therefore, the best practice is always to implement a client side connection to your server, and call our APIs from the server-side.
Installation
Install through nuget CLI
nuget install IDAnalyzer
Install through Visual Studio Package Manager Console
Install-Package IDAnalyzer
Alternatively, download this package and add the project under/IDAnalyzer
to your solution
Core API
ID Analyzer Core API allows you to perform OCR data extraction, facial biometric verification, identity verification, age verification, document cropping, document authentication (fake ID check), paperwork automation using an ID image (JPG, PNG, PDF accepted) and user selfie photo or video. Core API has great global coverage, supporting over 98% of the passports, driver licenses and identification cards currently being circulated around the world.
The sample code below will extract data from this sample Driver License issued in California, compare it with a photo of Lena, and check whether the ID is real or fake.
CoreAPI coreapi = new CoreAPI(API_KEY, API_REGION);
// Throw exception if API returns error
coreapi.ThrowAPIException(true);
// Enable authentication and use 'quick' module to check if ID is authentic
coreapi.EnableAuthentication(true, "quick");
// Send document to Core API and get json response
JObject result = await coreapi.Scan("https://www.idanalyzer.com/img/sampleid1.jpg", "", "https://upload.wikimedia.org/wikipedia/en/7/7d/Lenna_%28test_image%29.png");
// Print document holder name
Console.WriteLine(String.Format("Hello your name is {0} {1}", (string)result.SelectToken("result.firstName"), (string)result.SelectToken("result.lastName")));
// Parse document authentication results
if (result.ContainsKey("authentication")){
if ((double)result.SelectToken("authentication.score") > 0.5) {
Console.WriteLine("The document uploaded is authentic");
}else if ((double)result.SelectToken("authentication.score") > 0.3){
Console.WriteLine("The document uploaded looks little bit suspicious");
}else
{
Console.WriteLine("The document uploaded is fake");
}
}
// Parse face verification results
if (result.ContainsKey("face")){
if (result.SelectToken("face.error") != null){
// View complete error codes under API reference: https://developer.idanalyzer.com/coreapi.html
Console.WriteLine(String.Format("Face verification failed! Code: {0}, Reason: {1}", (string)result.SelectToken("face.error"), (string)result.SelectToken("face.error_message")));
}else
{
if ((bool)result.SelectToken("face.isIdentical") == true){
Console.WriteLine("Great! Your photo looks identical to the photo on document");
}else
{
Console.WriteLine("Oh no! Your photo looks different to the photo on document");
}
Console.WriteLine(String.Format("Similarity score: {0}", (string)result.SelectToken("face.confidence")));
}
}
// Print result
Console.WriteLine(Environment.NewLine + "Raw JSON Result: ");
Console.WriteLine(result.ToString());
DocuPass API
DocuPass allows you to verify user identity and have them sign legal documents without designing your own web page or mobile UI. A unique DocuPass URL can be generated for each of your users and your users can verify their own identity by simply opening the URL in their browser. DocuPass URLs can be directly opened using any browser, you can also embed the URL inside an iframe on your website, or within a WebView inside your iOS/Android/Cordova mobile app.
DocuPass comes with 4 modules and you need to choose an appropriate DocuPass module for integration.
To start, we will assume you are trying to verify one of your user that has an ID of "5678" in your own database, we need to generate a DocuPass verification request for this user. A unique DocuPass reference code and URL will be generated.
DocuPass docupass = new DocuPass(API_KEY, "My Company Inc.", API_REGION);
// Throw exception if API returns error
docupass.ThrowAPIException(true);
// We need to set an identifier so that we know internally who we are verifying, this string will be returned in the callback. You can use your own user/customer id.
docupass.SetCustomID(textBox7.Text);
// Enable vault cloud storage to store verification results, so we can look up the results
docupass.EnableVault(true);
// Set a callback URL where verification results will be sent, you can use docupass_callback.php in demo folder as a template
docupass.SetCallbackURL("https://www.your-website.com/docupass_callback.php");
// We want DocuPass to return document image and user face image in URL format so we can store them on our own server later.
docupass.SetCallbackImage(true, true, 1);
// We will do a quick check on whether user have uploaded a fake ID
docupass.EnableAuthentication(true, "quick", 0.3);
// Enable photo facial biometric verification with threshold of 0.5
docupass.EnableFaceVerification(true, 1, 0.5);
// Users will have only 1 attempt at verification
docupass.SetMaxAttempt(1);
// We want to redirect user back to your website when they are done with verification
docupass.SetRedirectionURL("https://www.your-website.com/verification_succeeded.php", "https://www.your-website.com/verification_failed.php");
// Create a DocuPass Mobile Session
JObject result = await docupass.CreateMobile();
// JObjectresult = await docupass.CreateLiveMobile();
Console.WriteLine("Scan the QR Code below to verify your identity: ");
Console.WriteLine((string)result["qrcode"]);
Console.WriteLine("Or open your mobile browser and type in: ");
Console.WriteLine((string)result["url"]);
//JObject result = await docupass.CreateIframe();
//Console.WriteLine("Embed following URL on your website: ");
//Console.WriteLine((string)result["url"]);
//JObject result = await docupass.CreateRedirection();
//Console.WriteLine("Redirect your user to the following URL: ");
//Console.WriteLine((string)result["url"]);
Console.WriteLine(Environment.NewLine+"Raw JSON Result: ");
Console.WriteLine(result.ToString());
Demo
Check out demo project for more demo code.
SDK Reference
Check out ID Analyzer Dot Net SDK Reference
Product | Versions Compatible and additional computed target framework versions. |
---|---|
.NET | net5.0 was computed. net5.0-windows was computed. net6.0 was computed. net6.0-android was computed. net6.0-ios was computed. net6.0-maccatalyst was computed. net6.0-macos was computed. net6.0-tvos was computed. net6.0-windows was computed. net7.0 was computed. net7.0-android was computed. net7.0-ios was computed. net7.0-maccatalyst was computed. net7.0-macos was computed. net7.0-tvos was computed. net7.0-windows was computed. net8.0 was computed. net8.0-android was computed. net8.0-browser was computed. net8.0-ios was computed. net8.0-maccatalyst was computed. net8.0-macos was computed. net8.0-tvos was computed. net8.0-windows was computed. |
.NET Core | netcoreapp2.0 was computed. netcoreapp2.1 was computed. netcoreapp2.2 was computed. netcoreapp3.0 was computed. netcoreapp3.1 was computed. |
.NET Standard | netstandard2.0 is compatible. netstandard2.1 was computed. |
.NET Framework | net461 was computed. net462 was computed. net463 was computed. net47 was computed. net471 was computed. net472 was computed. net48 was computed. net481 was computed. |
MonoAndroid | monoandroid was computed. |
MonoMac | monomac was computed. |
MonoTouch | monotouch was computed. |
Tizen | tizen40 was computed. tizen60 was computed. |
Xamarin.iOS | xamarinios was computed. |
Xamarin.Mac | xamarinmac was computed. |
Xamarin.TVOS | xamarintvos was computed. |
Xamarin.WatchOS | xamarinwatchos was computed. |
-
.NETStandard 2.0
- Newtonsoft.Json (>= 12.0.3)
NuGet packages
This package is not used by any NuGet packages.
GitHub repositories
This package is not used by any popular GitHub repositories.
v1.2.1
Added AML Support
Added Base64 Content as Scan input in Core API