privid_fhe_cs 2.5.6

Private ID C# SDK

Ver = 2.5.x

Description : C# SDK Decentralized biometrics with fully homomorphic encryption.

1. API Documentation —-------------------

https://github.com/prividentity/PrivateIdentity/wiki/C%23-SDK

2. Test Procedure

Use the test application provided as privid_fhe_cs_example2 in NuGet

3. Integration to existing application

Add Nuget package privid_fhe_cs 
Add following lines to 'Post-build event' in Project Options->Build->Events
		xcopy /E /Y  $(Pkgprivid_fhe_cs)\lib\windows\*.dll $(ProjectDir)    //  for Windows project 
		cp  $(Pkgprivid_fhe_cs)\lib\windowslinux\*.so $(ProjectDir)         //  for Linux project 
Edit the project file line 
		From :
		<PackageReference Include="privid_fhe_cs" Version="x.y.x" />
		To :
		<PackageReference Include="privid_fhe_cs" Version="x.y.z" GeneratePathProperty="true" />

Release Notes (2.5.x) Build 071811.1

Customer Reported Issues

Bug Fixes / Enhancements

1. Image size made multiple of 4 pixels in C# wrapper. This is due to SixLabors.ImageSharp compatiblity for odd image sizes.

New Features

1. Added support for age prediction (Beta). New API added.
2. Added support for ISO 19794-5 Face Portrait extraction (Beta). New API added.

How to Migrate from v2.4.x Compatible - no change required.

Release Notes (2.4.x) Build 6221.1

Customer Reported Issues

Unable to run C# SDK in Docker for Windows or Linux.

Bug Fixes / Enhancements

1. Image operations moved to C++ library from C# wrapper library
2. System.Drawing.Image is removed, instead SixLabors.ImageSharp is used for image IO.
3. Linux SO added in the package to support Linux Docker

New Features

1. Added support to find, validate, align and crop Photo ID
2. Added support to find, validate, align/crop face and barcode from Photo ID

How to Migrate from v2.1.x

1. Change Image.FromFile(filename) to Image.Load(filename)
2. Delete Results.cs file from the project. The results class moved to the DLL.

Release Notes (2.1.x) Build 4211.1

Customer Reported Issues

None

Bug Fixes

None

New Features

1. Local Cache Support Enables offline operation, reduces network traffic and improves performance by storing encrypted responses locally. The local cache is synchronized every 300 seconds and deleted after 24 hours.

How to Migrate from v1.9.x

 t_privid_results_xxxx classes moved out of the parent structure privid_fhe_face class and can be accessed directly. Please reference the new class name when defining the return values. 

 UPDATE PrivIdService.cs
 OLD :      privid_fhe_face.t_privid_results_is_valid validResult = privIdFheFace.is_valid(FixedSize(Image.FromFile(fileName), imWidth, imHeight));

 NEW : t_privid_results_is_valid validResult = privIdFheFace.is_valid(FixedSize(Image.FromFile(fileName), imWidth, imHeight));

Release Note (1.9.3)

Customer Reported Issues

1. SDK crashed when repeatedly pressing Compare. This was due to a debug file writing to a disk location where the file did not have write access. The debug file write is now disabled and the problem is resolved.

2. The Delete function consistently failed. This is repaired. This was due to a mismatched apiKey in the sample code.

3. The Compare function incorrectly accepted rotated images. In this case, the customer’s image was rotated 90 degrees. Due to this, the function returned (-1) instead of (0). Now the Compare function rejects invalid (rotated) images and performs the Compare function correctly.

4. In previous versions, the DLL needed to be copied to the correct location manually. This is now corrected. We added lib path variable to the project for easy DLL copy through Post-build script. This maintains the NUGET Library Path variable $(Pkgprivid_fhe_cs) through different versions.

Bug Fixes

5. Repaired an intermittent bug affecting memory allocation/free for image data storage. This appeared intermittently when running >300 function calls simultaneously.

6. Removed CLAHE augmentation from all functions. This improved recognition algorithm performance by a few percent. This function was a remnant from a previous model.

New Features

7. All functions (Is_valid, Enroll, Predict, Delete and Compare) now return two different response structures, one for enroll and predict and another for in_valid. These are convenience classes and methods that abstract the caller from the internal JSON response providing access methods independent of an interchange format.

8. Uses internal C++ REST library instead of C# REST, serialization and deserialization protocol.

9. Until now, encrypted uuid and guid passed to the user. This version decrypts the uuid and guid in the response structures.

10. The Compare function is now completely local, no longer interacts with the server and checks the is_valid flag locally. This is now much faster.

11. Implemented connection pooling by adding a context parameter that allows many calls with the same init function. This code is thread-safe.