SecuGen Connect

The Fingerprint SDK as a Service

Privacy controls for GDPR-aligned deployments

Connect any HTTP-capable app to SecuGen readers through one local API
platform-independent, language-independent, and local-first by design.
The Problem

Legacy SDKs Are Holding You Back

Biometrics integration has traditionally forced teams to manage platform-specific DLLs, JNI bridges, and fragile native dependencies. Every language stack becomes a separate integration project, which slows delivery and increases maintenance risk.

As systems grow, teams often duplicate logic across desktop, web, and backend services. That creates version drift, inconsistent behavior, and long release cycles whenever device SDK components change.

Why SecuGen Connect

Any HTTP-capable language. One local contract.

Connect Bridge replaces the library-first model with a loopback HTTP/JSON service. Call the API directly or use an optional Connect SDKβ€”without platform-specific or language-specific application code.

For licensed deployments, local entitlement validation supports offline operation while the entitlement and its offline policy remain valid. Activation and periodic refresh or renewal require cloud connectivity when the selected license model requires them.

Before: per-language SDK wrappers, runtime dependency conflicts, and repeated integration/debug cycles.

After: one secure Connect Bridge endpoint and a unified response model across all clients.

Operational gain: simpler rollout, fewer moving parts, and faster issue isolation.

Business gain: predictable delivery cadence with lower integration cost.

The Solution

SecuGen Connect

One Service. Every Language.

SecuGen Connect system flow Desktop, browser, mobile, and kiosk applications call one local Connect Bridge, which coordinates fingerprint capture, licensing, and match results. SecuGen Connect System Flow Connect Bridge coordinates apps, fingerprint hardware, and cloud licensing. Desktop Application Web / Browser Client Mobile / Kiosk App Connect Bridge Local API (4499; fallback 4498–4494) Capture / Template / Match / Verify Direct HTTP/JSON or Optional SDK Local Entitlement Validation + Policy Fingerprint Device Secure local device capture License Server connect.secugen.com Activate / Refresh / Volume Seats Result to Application Match decision, score, template metadata Consistent behavior across desktop, web, mobile, and kiosk flows

Connect Bridge keeps application requests, device capture, and licensing policy in one controlled flow.

Capabilities

What SecuGen Connect Does

⚑

Universal Language Support

Java, Python, C#, Node.js, Go, Rust, PHP, Delphi, and more can call the same HTTP/JSON API directly or through an optional Connect SDK.

πŸ”

Cross-Brand Template Hub

Submit supported raw8 fingerprint images and generate ANSI 378, ISO 19794-2, or SG400 templates through the shared biometric engine.

πŸš€

Built-in 1:N Matching

Enroll templates and run local 1:N identification with the integrated SQLite-backed matching engine. No external matching database is required.

🌐

Web-Native & Multi-Platform

Supports Chrome, Edge, and Firefox after loopback origin and session policy setup. Windows is production-ready; macOS is packaged and hardware-verified; Android is a hardware-verified preview; Linux packages and an iOS implementation preview are available with platform-specific rollout requirements. No browser extension, plugin, or applet is required.

πŸ”’

Enterprise Security

Loopback-only binding, origin controls, short-lived session authentication, AES-256-GCM template storage, SHA-256 nonce replay prevention, and TLS 1.2+ for cloud traffic.

πŸ¦€

Cross-Platform Shared Core

The Rust desktop runtime and shared core provide session, nonce, rate-limit, device, and biometric logic. Mobile shells reuse the shared core through JNI or C FFI where applicable.

☁️

Cloud Licensing

Centralized license management with Ed25519/EdDSA-signed entitlements for subscription, perpetual, and trial licensing models.

πŸ’»

Works on Desktop

Capture, extraction, and matching execute on the endpoint. Cloud use is limited to licensing and account workflows when the selected policy requires it.

πŸ”Œ

Works Offline

Capture, match, and identify without an internet connection while a valid entitlement and offline policy permit. Activation and periodic refresh or renewal may require cloud access.


Migration Scope

SDKs and Integration Paths You Can Consolidate

For capture, template, verify, and identify workflows, SecuGen Connect can consolidate multiple legacy integration paths (including Linux SDK flows) into one service API.

Consolidate

FDxSDKPro C/C++ (`SGFPM_*`, Windows/Linux)

Move from handle lifecycle and buffer management to clean local HTTP request/response calls.

Consolidate

Linux SDK `.so` + Native Binding Layer

Remove per-distro `.so` packaging, linker/runtime path issues, and language-specific wrapper maintenance.

Consolidate

Java `JSGFPLib` + JNI Setup

Remove JAR + native library packaging and eliminate PATH / JVM-native compatibility issues.

Consolidate

.NET Native Wrapper Integrations

Avoid x86/x64 binary drift and use the same API contract already used by other stacks.

Consolidate

Android `FDxSDKPro.aar` Bridge Code

Move device-specific AAR and JNI handling behind Connect Bridge, then use the local API or optional Android SDK from application code.

Modernize

Legacy SecuGen Web API + Plugin-era Pages

Upgrade browser-centric flows to a secure service model ready for multi-channel apps.


System Architecture

How It Works

Connect Bridge runs on the user's endpoint, connecting the application to fingerprint hardware while keeping biometric operations local. It contacts the cloud control plane only for licensing and account workflows when required.

Application
Local Endpoint
Cloud Control Plane
πŸ–₯️ Desktop App Java Β· Python Β· C# Β· Go
🌐 Web Browser Chrome · Edge · Firefox
πŸ“± Mobile App Android Β· iOS
Local HTTP / JSON
πŸ›‘οΈ Connect Bridge
REST API Session Auth CORS Gate Rate Limit
πŸ¦€ Rust Shared Core
Session Mgmt Nonce Replay Rate Limit Biometric Extract/Match
Rust runtime Β· JNI/C FFI for mobile shells where applicable
127.0.0.1:4499 Β· fallback 4498–4494 Β· loopback HTTP Β· outbound TLS 1.2+
Device API
SQL
HTTPS (Cloud)
πŸ”Œ Device Access Windows native adapters Β· Linux libusb/Bluetooth
Android USB Host/BLE GATT Β· macOS libusb/CoreBluetooth Β· iOS CoreBluetooth
πŸ“Š 1:N Engine SQLite Β· AES-GCM
☁️ License Server EdDSA JWT · Stripe/PayPal · PostgreSQL
USB / Bluetooth
πŸ–οΈ SecuGen Reader HU20-AL Β· HU30 Β· HU20-AP Β· HU20-A Β· HUPx-AP Β· HUPx Β· …
All SecuGen USB readers Β· supported SecuGen Bluetooth readers
REST API Layer Rust Shared Core Matching Engine Cloud Licensing Hardware

Technology

Built With

πŸ¦€

Rust Runtime & Shared Core

Desktop Bridge runtime plus shared session, nonce, rate-limit, device, and biometric logic. Mobile shells use JNI or C FFI where applicable.

🐹

Go (Golang)

Go services power the License Server, customer and admin portals, Stripe/PayPal billing workflows, the download catalog, and the optional server-matching service.

πŸ—ƒοΈ

SQLite

Embedded, serverless 1:N matching engine. Local template storage with zero external dependencies.

🐘

PostgreSQL

Primary cloud persistence for License Server state, seat governance, audit, and multi-tenant operations.

πŸ“œ

JWT (Ed25519 / EdDSA)

Tamper-evident EdDSA-signed entitlements validated locally by Connect Bridge, subject to the entitlement's validity and offline policy.

πŸ”

AES-GCM

AES-256-GCM protects the local template store at rest with configured or generated key material. Applications remain responsible for downstream template handling.

πŸ”

Transport Security

Mainstream loopback traffic uses HTTP while remaining bound to the endpoint and policy-protected; HTTPS is available where required. Cloud connections use TLS 1.2+.

πŸ“¦

TypeScript SDK

Typed client for the maintained v1/v2 Bridge surface and authenticated event stream. npm install secugen


Comparison

SecuGen Connect vs Existing SecuGen Web API

SecuGen Connect keeps the simplicity of web-style integration, then extends it to a secure, enterprise-ready runtime for web, desktop, and mobile teams with one consistent API contract.

Comparison of SecuGen Connect, the existing SecuGen Web API, and legacy SDK or plugin integrations.
Feature SecuGen Connect SecuGen Web API Legacy SDK / Plugin Stack
Architecture Loopback REST + authenticated WebSocket events Web-first local bridge DLL/JNI/ActiveX split stack
Developer Onboarding Direct HTTP/JSON or optional Connect SDK Browser/JS-oriented integration Per-language binaries and runtime setup
Language Coverage Any language that can call HTTP Best fit for web JavaScript flows SDK-specific (Java/.NET/C++ each separate)
Desktop/Mobile Reuse Same endpoint contract across channels Additional wrappers typically required Rebuild per platform
1:N Identification Built-in encrypted SQLite engine External matching logic needed External matching logic needed
Template Interoperability Supported raw8 image β†’ ANSI 378 / ISO 19794-2 / SG400 Primarily capture-focused web workflows Often device/SDK-bound flows
Licensing Server Built-in cloud licensing server (JWT) External/app-side licensing flow typically required Dongle/local key distribution model
Cross-Platform Parity Shared Rust logic with platform-specific runtime and rollout status Windows-focused with limited portability Per-platform SDK rebuild required
Deployment Operations Central policy + token-based control Application-managed rollout Manual DLL/plugin distribution

Why this matters: teams standardize on one API, ship features faster, and reduce support tickets tied to native library or browser dependency issues.


Developer Experience

Before & After

❌ Legacy Java SDK

// Requires: sgfplib.jar + platform DLLs // JNI setup, PATH config, .so/.dll copy JSGFPLib fplib = new JSGFPLib(); fplib.Init(SGFDxDeviceName.SG_DEV_AUTO); fplib.OpenDevice(0); byte[] imgBuf = new byte[width*height]; fplib.GetImageEx(imgBuf, 5000, 0, 50); // Manual memory mgmt, error codes... fplib.CloseDevice(); fplib.Close();

βœ… SecuGen Connect

// One call. Capture + match + signed assertion. HttpClient client = HttpClient.newHttpClient(); var res = client.send( HttpRequest.newBuilder() .uri(URI.create("http://127.0.0.1:4499/v2/auth/login")) .header("Content-Type", "application/json") .POST(BodyPublishers.ofString(""" {"userId":"user-42", "groupId":"my-app"} """)) .build(), BodyHandlers.ofString() ); // Returns: { matched, score, assertion }
Deployment Planning

Deployment Requirements

Use these deployment baselines for planning, then confirm the current package, platform, device, and entitlement requirements for your rollout.

Runtime Requirements

OS
Windows 10/11 x64 (production); macOS Apple silicon (packaged and hardware-verified); Android (hardware-verified preview); Linux packages/API available with reader support dependent on udev/libusb and device validation; iOS implementation preview with distribution pending
CPU Arch
x64 and arm64 artifacts vary by platform; select the published package that matches the endpoint architecture
Recommended Spec
2 CPU cores and 4 GB RAM per endpoint for stable day-to-day capture, enroll, and verify workloads
Browser
Required only for web integrations (Chrome / Edge / Firefox with loopback HTTP access and allowed origin setup)
Non-Browser App Mode
Supported: desktop/local apps can call Connect Bridge directly over the local HTTP API by default (no browser required)
Network
Loopback service on 127.0.0.1:4499 with fallback ports 4498–4494; outbound license-server access for activation and policy-driven refresh or renewal
Optional Demo Tooling
Node.js 18+ and npm 9+ (only for local demo-web workflows)

Note: platform status reflects repository evidence reviewed on 2026-08-18. Confirm the current Download Center, device compatibility matrix, and target artifact before rollout.


Next Step

Put the architecture to work

Install Connect Bridge, validate the local integration flow, or continue with the developer guide.