Recently, Chrome browser has been updated their web policy and it affects using BioMnini/BioMini Plus 2 on BioStar 2. If you have an issue with enrolling fingerprint via BioMini, please visit the below article first.
[Known Issue] Cannot Scan Fingerprint Using BioMini Suddenly


BioMini is the USB fingerprint reader used for biometric enrollment. 

Supported devices in BioStar 2 are shown in the link below: 

[Both BioStar] Biomini and Biomini Plus support


BioMini agent / USB Agent needs to be installed on the client PC in order to recognize the device in BioStar 2. 

You can download the program from Setting > Usb Agent of BioStar 2 web client.


Terminology 

Up to BioStar 2.3, the program was called Biomini Agent because only BioMini was used with the program. 

However, in BioStar 2.4 the program's name changed to USB Agent because it now supports DE-620 as well. 



Configuration


Note: Although you have an option to check 'run on Windows startup', the USB Agent will not run automatically (up to BioStar 2.5) because of a bug. 

You will have to run USB Agent manually in the Windows start menu when you restart your PC.

[This feature does not work up to BioStar 2.5] 


1. Install the latest driver

First check that the latest fingerprint driver is installed (version 2.2)

Direct download link: 

Sup_Fingerprint_Driver_v2.2.0.exe

http://gofile.me/471Oh/5xHcJBB5N


Note: unplug the BioMini when you are installing the driver.

The driver can also be found at Suprema ID homepage: download center.


Login is required in accordance with your account.





2. Check Device manager

Open device manager and check that Suprema Fingerprint Scanner is detected properly. 


3. Check USB Agent Certification

USB Agent is running. You can search it in the Windows start menu. 


Once the program is running right click on the USB Agent icon on the system tray and click Setup.


Click Enroll Certificates and click Yes when a Security Warning popup appears to enroll the certificate. 


Restart the service by clicking Stop and then Start 


4. Check the BioStar 2 Device menu

If  all settings are configured properly, the device should appear as a USB device on the Device menu. 


    


Troubleshooting


1. Check if the USB Agent port is being used by another service 

You currently (BioStar 2.5) cannot change the default port use of the USB Device Agent of 8081 and 8082 because of a UI bug. 

Check that port 8081 and 8082 is not being used by another service.  

Refer to the guide below: 

[General] Checking Port Usage in Windows

If another service is using port 8081 and 8082 then service will crash or 'Started' will be not shown when you click Start.
Remove the other service that is using the same ports.


Or you can change the Biomini Agent port in BioStar 2.6 as desired and above as shown below: 

[BioStar 2] Changing Biomini / USB Agent Port


If you must change the USB Agent port in BioStar 2.5 or below refer to the guide below: 

[Known Issue] Biomini Agent / USB Agent Port Cannot be Changed


2. Change Access privileges
If you're getting the error below every time when scanning the fingerprint with Biomini, it is likely that USB Agent is being run with insufficient privileges.


In that case stop the process first in Task Manager.

In BioStar 2.3 or below the service will appear as Biomini-Agent.exe *32


In BioStar 2.4 and above the service will appear as usb-agent.exe *32


Search the Biomini Agent / USB Agent in Windows Start menu and select the Properties menu after a right click. 


Check Run this program and an administrator on the compatibility tab and click OK


Run Biomini Agent / USB Agent again. 




3. Check the API

If you are using a proxy server, you will have to add the localhost as an exception.


You can check if the localhost is working correctly by trying to access the URL below:


localhost:[webserver port]/api/device

The image above shows that the connection is possible and working.

If you get a error message like below even if BioStar 2 service is running, it means that localhost connection is blocked. 



4. Check the USB Agent logs

You can find the USB agent logs in the folder below: 

C:\Program Files (x86)\USB Device Agent\usb-agent\logs


Open the log files to see what errors are appearing. 

Provide the log file to the technical support team when requested.