从ASP.NET Web应用调用WPF桌面应用实现客户端智能卡读取方案咨询

核心实现：WPF集成自托管Kestrel服务器 #

在驻留通知区域的WPF应用中嵌入Kestrel自托管Web服务器，监听本地回环地址（如localhost:5000），暴露API接口接收Web应用的调用请求，触发读卡器操作。

实现步骤示例 #

1. 添加依赖包：在WPF项目中引入Microsoft.AspNetCore.App NuGet包，包含Kestrel及ASP.NET Core MVC相关组件。
2. 启动Kestrel服务器：在WPF的App.xaml.cs中初始化并启动服务器，配置路由与跨域规则：

using Microsoft.AspNetCore.Builder;
using Microsoft.AspNetCore.Hosting;
using Microsoft.Extensions.DependencyInjection;

public partial class App : Application
{
    private IWebHost _webHost;

    protected override void OnStartup(StartupEventArgs e)
    {
        base.OnStartup(e);
        _webHost = new WebHostBuilder()
            .UseKestrel()
            .UseUrls("http://localhost:5000")
            .ConfigureServices(services =>
            {
                services.AddControllers();
                // 配置CORS，仅允许你的Web应用域名访问
                services.AddCors(options =>
                {
                    options.AddPolicy("TrustedWebApp",
                        policy => policy.WithOrigins("https://your-web-app-domain.com")
                                        .AllowAnyHeader()
                                        .AllowAnyMethod());
                });
            })
            .Configure(app =>
            {
                app.UseCors("TrustedWebApp");
                app.UseRouting();
                app.UseEndpoints(endpoints =>
                {
                    endpoints.MapControllers();
                });
            })
            .Build();
        _webHost.Start();
    }

    protected override void OnExit(ExitEventArgs e)
    {
        _webHost?.StopAsync().Wait();
        base.OnExit(e);
    }
}

3. 编写读卡器API控制器：创建控制器处理读取请求，调用已有的读卡器逻辑：

using Microsoft.AspNetCore.Mvc;

[ApiController]
[Route("api/card")]
public class CardReaderController : ControllerBase
{
    [HttpGet("read")]
    public IActionResult ReadCard()
    {
        try
        {
            // 调用你的读卡器读取业务逻辑
            var cardData = SmartCardReader.ReadCardInfo();
            return Ok(new { Success = true, CardData = cardData });
        }
        catch (Exception ex)
        {
            return BadRequest(new { Success = false, ErrorMessage = ex.Message });
        }
    }
}

前端JavaScript调用实现 #

Web应用前端直接通过HTTP请求调用本地WPF的API接口，处理返回的卡片数据。

示例代码 #

async function triggerLocalCardRead() {
    try {
        const response = await fetch('http://localhost:5000/api/card/read', {
            method: 'GET',
            mode: 'cors'
        });
        const result = await response.json();
        if (result.Success) {
            // 将卡片数据提交到Web应用后端或进行前端展示
            console.log('读取到的卡片信息:', result.CardData);
        } else {
            alert('卡片读取失败: ' + result.ErrorMessage);
        }
    } catch (error) {
        alert('无法连接本地读卡器应用，请确认应用已启动');
    }
}

后端调用方案 #

若Web应用后端需要触发本地读卡器操作，可按以下方式实现：

• 前端先验证本地API的可访问性，将本地服务地址（如localhost:5000）传递给后端；
• 后端基于该地址发起HTTP请求到本地WPF服务器，注意仅当Web应用与WPF应用在同一客户端机器时才能成功调用；
• 后端需添加请求验证逻辑（如API密钥、请求签名），确保请求来自可信前端。

关键安全考量 #

• 严格CORS配置：仅允许你的Web应用域名访问本地API，禁止使用通配符；
• 本地访问限制：Kestrel仅监听localhost，避免外部网络非法访问；
• 请求身份验证：为API添加密钥或签名验证，过滤恶意请求；
• 权限校验：WPF应用内部验证当前用户是否具备读卡器操作权限。

Web与本地应用通信补充方案参考 #

除自托管Web服务器外，常见的浏览器与本地应用通信方案包括：

1. 自定义URL协议：注册如mycardapp://的自定义协议，浏览器通过链接唤起本地应用，适合简单指令传递，但数据交互能力有限；
2. 浏览器扩展Native Messaging：开发浏览器扩展，通过原生消息API与本地应用通信，安全性高，但需用户安装扩展，多浏览器适配成本高；
3. WebSocket长连接：本地服务器提供WebSocket端点，建立双向实时连接，适合需要持续交互的场景。

内容的提问来源于stack exchange，提问作者Martin Novotný