Install services on Windows

Install the MBKYC desktop services on Windows via Chocolatey or the MSI installer.

Install the desktop services from the MBKYC Nexus repositories. Replace repo.client.ae with the host your ICP contact gives you, and use your issued credentials.

The Zhiang and Suprema BMS-2 fingerprint readers need a WinUSB driver that isn’t bundled in the MSI/Chocolatey packages yet — on a stock machine they show Status=Error until the driver is installed manually. The PC/SC and Morpho services install with no custom driver.

Chocolatey (recommended)

1. Add the source

   choco source add --name mbkyc `
     --source "https://repo.client.ae/repository/mbkyc-nuget" `
     --user "your_username" --password "your_password"
   
2. Install

   choco install mbkyc-pcsc-service mbkyc-morpho-service -y
   
3. Uninstall (when needed)

   choco uninstall mbkyc-pcsc-service mbkyc-morpho-service -y
   

Available packages

Package	Description
mbkyc-pcsc-service	PC/SC smart card reader service
mbkyc-morpho-service	Morpho (IDEMIA MSO 1350) fingerprint service
mbkyc-suprema-service	Suprema BioMini Slim 2 (BMS-2) fingerprint service — needs the WinUSB driver (see warning above)
mbkyc-zhiang-service	NEXUS / Zhiang fingerprint service — needs the WinUSB driver (see warning above)
mbkyc-web-host	Browser extension native messaging host
mbkyc-capi	C API library

MSI installer

Download a service’s MSI directly from the raw repository and install it silently:

$user = "your_username"
$pass = "your_password"
$headers = @{ Authorization = "Basic " + [Convert]::ToBase64String([Text.Encoding]::ASCII.GetBytes("${user}:${pass}")) }

# Download (replace <VERSION>, e.g. 0.4.0)
Invoke-WebRequest -Headers $headers -OutFile mbkyc-pcsc-service.msi `
  -Uri "https://repo.client.ae/repository/mbkyc-raw/mbkyc/mbkyc-pcsc-service/<VERSION>/windows/msi/mbkyc-pcsc-service-<VERSION>-x86_64.msi"

# Install / uninstall (silent)
msiexec /i mbkyc-pcsc-service.msi /qn
msiexec /x mbkyc-pcsc-service.msi /qn

C API library

For C/C++ and .NET consumers who need the C API on Windows:

NuGet

nuget sources add -Name mbkyc -Source "https://repo.client.ae/repository/mbkyc-nuget" `
  -Username "your_username" -Password "your_password"
nuget install MBKYC.Capi -Source mbkyc

vcpkg

$headers = @{ Authorization = "Basic " + [Convert]::ToBase64String([Text.Encoding]::ASCII.GetBytes("your_username:your_password")) }
Invoke-WebRequest -Headers $headers -OutFile mbkyc-capi-vcpkg.zip `
  -Uri "https://repo.client.ae/repository/mbkyc-raw/mbkyc/mbkyc-capi/<VERSION>/vcpkg/mbkyc-capi-vcpkg-<VERSION>.zip"
Expand-Archive mbkyc-capi-vcpkg.zip -DestinationPath vcpkg-overlay
vcpkg install mbkyc-capi --overlay-ports=.\vcpkg-overlay

Service management

# Status
Get-Service MBKYCPcscGenericSmartcard
Get-Service MBKYCUsbMorphoFingerprint

# Start / Stop
Start-Service MBKYCPcscGenericSmartcard
Stop-Service  MBKYCPcscGenericSmartcard

# Logs (Event Viewer)
Get-WinEvent -LogName Application `
  -FilterXPath "*[System[Provider[@Name='MBKYCPcscGenericSmartcard']]]" -MaxEvents 50