摘要B/S 系统用中间件做 UKey 认证很成熟但大量工业软件、CAD、ERP 客户端是 C/S 架构。本文讲解 UKey 通过 C 动态库DLL/SO与 C# SDK 直接嵌入桌面客户端的强认证方案本地签名验签、离线可用、支持 WinForms/WPF/Qt/MFC并给出 C# 调用示例与 SCADA 工控落地的真实效果最快半天完成基础集成。一、C/S 架构为什么不能只靠中间件很多工控、设计、行业软件是桌面客户端C/S 架构它们运行在隔离内网甚至完全离线环境没有 Web 中间件进程用 C# WinForms/WPF、QtC、MFC 写就不是浏览器对启动速度、离线能力、硬件绑定要求高这类场景UKey 提供C 动态库DLL/SO C# SDK直接调用方式无需起 HTTP 中间件客户端直连 UKey 芯片完成签名验签。二、C/S 四种集成模式A. 本地签名验签认证离线可用客户端启动时或关键操作前通过 C 动态库调 UKey 完成签名验签。私钥在芯片内签名签名值送服务端验签。客户端直连 UKey无中间件→ 芯片内签名 → 签名值送服务端验签适用需离线运行或不依赖 Web 的独立客户端。支持 WinForms/WPF/Qt/MFC可结合 ASP 服务端做统一权限。B. C/S ASP 远程联合认证客户端本地签名后把签名结果提交后端 ASP 平台统一身份鉴别与权限校验。UKey 本地签名 ASP 鉴权 双重保障 一个 UKey 打通所有 C/S 客户端系统 支持在线吊销 / 策略下发 / 日志审计 / 桥接 AD/LDAP适用多系统统一管控的大型企业。C. KeyID 绑定快速接入类似 Web 端 KeyID客户端读 UKey 序列号与服务端列表比对开发量最小。登录按钮事件里加 UKey 检测 → 比对 KeyID↔用户映射适用安全性要求中等的内部系统1 天可集成后续可无缝升级到签名验签。D. C/S 加密通信隧道利用 UKey 对称加密SM4/AES在客户端与服务端间建加密通道防窃听篡改。会话密钥由 UKey 真随机数生成 → 每次连接不同密钥 → 配签名验签实现身份传输双重安全适用工控 SCADA、金融交易终端。三、C# SDK 调用示例WinForms 登录// 引用安当 UKey C# SDK封装了对 C 动态库的 P/InvokeusingAnDang.UKey;publicclassLoginForm:Form{privatevoidbtnLogin_Click(objectsender,EventArgse){stringusertxtUser.Text;stringpwdtxtPwd.Text;// 第一因素用户名密码if(!AuthServer.VerifyPassword(user,pwd)){MessageBox.Show(密码错误);return;}// 第二因素UKey 本地签名usingvarkeyUKeyDevice.Open();// 自动查找已插入 UKeyif(keynull){MessageBox.Show(请插入 UKey);return;}stringnonceAuthServer.GetChallenge(user);// 服务端下发随机数byte[]sigkey.SignSm2(nonce);// 芯片内 SM2 签名私钥不出设备boolokAuthServer.VerifySignature(user,nonce,sig);// 服务端公钥验签if(ok)EnterDesktop();elseMessageBox.Show(UKey 验签失败);}}关键点key.SignSm2在芯片内完成私钥永不离开 UKey。即使客户端被调试器 attached也 dump 不出私钥。四、C 动态库Qt / C示例#includeukey_api.h// 安当 UKey C 动态库头文件voidonLogin(constchar*user,constchar*pwd){if(!server_verify_pwd(user,pwd))return;UKEY_HANDLE hukey_open();// 打开已插入设备if(!h){show_error(请插入 UKey);return;}charnonce[64];server_get_challenge(user,nonce);unsignedcharsig[128];intsiglen0;ukey_sm2_sign(h,nonce,strlen(nonce),sig,siglen);// 芯片内签名if(server_verify_sig(user,nonce,sig,siglen))enter_desktop();ukey_close(h);}五、集成工作量与框架支持客户端框架集成方式基础集成耗时WinForms / WPFC# SDKNuGet0.5~1 天QtCC 动态库 头文件0.5~1 天MFC / 原生 CC 动态库1 天ElectronNode.js addon 调 C 库1 天Web 中间件RESTful端口 23001 天支持语言C / C# / C / Python / PHP / Java。六、真实落地SCADA 工控客户端某大型石化企业 DCS/SCADA 监控系统采用 C/S 架构C#.NET WinForm 客户端。通过安当 UKey C# SDK 集成操作员登录客户端时必须插入个人 UKey 完成签名验签防止未授权人员操控生产设备。效果200 操作站全部接入满足等保 2.0 三级身份鉴别要求。另一例某甲级设计院 CAD 协同平台C/Qt用 UKey DLL 实现一软一 Key设计师插 Key 才能开软件——既做登录认证又做版权保护。七、常见坑与建议驱动预装批量部署时把 UKey 驱动随客户端静默安装避免首次插入无驱动。离线优先工控场景选本地签名验签模式别依赖联网验签。降级策略Key 丢失时服务端删除公钥记录即失效对接 ASP 可一键吊销。PIN 保护启用 UKey PIN 码防 Key 被捡到后直接冒用。八、小结C/S 桌面软件的 UKey 强认证核心是把签名运算留在芯片内、私钥不出设备。C# SDK 和 C 动态库让 WinForms/Qt/MFC 客户端半天就能接上离线可用、工控友好。配合 ASP 远程联合认证还能把分散的桌面系统收编成统一身份体系——这正是大量工业软件、行业 SaaS 落地双因素的低摩擦路径。
)
