原创WebApi框架：采用HTTPS协议SelfHosting，Windows服务承载WebApi服务

作者:C/S框架网|www.cscode.ne 发布日期:2020/02/12 13:12:46

原创WebApi框架：采用HTTPS协议SelfHosting，Windows服务承载WebApi服务

前言

自2017年发布CSFramework WebApi服务端开发框架以来，一直是使用http协议，默认WebApi使用http协议承载。有三种承载(Hosting或宿主)方式：IIS Hosting(IIS承载)、Self Hosting（自承载）以及Windows Service Hosting(Win服务承载)。

由于最近微信小程序项目比较多，发布和部署微信小程序必须采用https协议，原http协议的WebApi接口访问不了的。为了解决这个问题，又开始技术探索，研究了几天，终于找到解决方案并整理成册，希望给Self Hosting或Windows服务Hosting启动Https协议WebApi服务用户启示和帮助。

PS：IIS部署HTTPS协议的WebApi服务比较简单，下载一个免费SSL证书，安装部署到IIS服务即可，这里不做介绍了。

思路和尝试

直接将WebApi监听的地址修改为Https启动服务显然是不行的，必须借助证书绑定开启对应的端口才行。开始想到去申请的一个免费的证书，由于WebAPi安装在本地Windows服务中且IP地址不固定，所以免费的证书不可取，只能借助MakeCert命令自行创建证书来解决这个问题。

关于证书的信任关系

两个服务器之间是如何利用证书来进行相互之间的信任呢？请看下图：

贴图图片-WebApi框架HTTPS协议SelfHostingWin服务承载13

在如上图中，管理员通过交换双方之间的公钥中的指纹来建立二者服务器之间的信任关系。

完整解决方案：

一、以管理员身份运行VS2015开发人员命令提示

贴图图片-WebApi框架HTTPS协议SelfHostingWindows服务承载

二、生成证书，在命令窗体内执行MakeCert命令

cmd:

MakeCert -sv e:\CSFrameworkWebApiCA.pvk -n "CN=localhost" e:\CSFrameworkWebApiCA.cer -b 02/12/2020 -e 12/31/2050 –r

//来源:C/S框架网(www.csframework.com) QQ:23404761

【注意】：该命令最后一个-r不能缺少，-r是创建自创建证书的标识，否则当利用Pvk2pfx创建私钥时则会出现【ERROR: File not found.(Error Code = 0x80070002)】

贴图图片-WebApi框架HTTPS协议SelfHostingWindows服务承载1

三、打开MMC将创建的证书导入到【受信任的颁发证书机构】中

贴图图片-WebApi框架HTTPS协议SelfHostingWindows服务承载2

四、创建证书的私钥

cmd:

Pvk2pfx -pvk CSFrameworkWebApiCA.pvk -spc CSFrameworkWebApiCA.cer -pfx CSFrameworkWebApiCA.pfx -po test

//来源:C/S框架网(www.csframework.com) QQ:23404761

注意：-po 后面是密码，如：test

五、导入个人证书，必须选择个人信息交换(*.pfx文件格式)

贴图图片-WebApi框架HTTPS协议SelfHostingWindows服务承载3

六. 拿到该证书的指纹，获取证书指纹信息。

贴图图片-WebApi框架HTTPS协议SelfHostingWindows服务承载4

七、证书绑定ip及端口，通过如下命令进行：（这是本文最关键环节！！！）

cmd:

netsh http add sslcert ipport=0.0.0.0:19893 certhash= 93d80be8cc4cb75bff28f412fbe00f5180106e40 appid={61982502-E5D4-4794-BB01-ZDA7414480DF}

//来源:C/S框架网(www.csframework.com) QQ:23404761

certhash参数：指定的证书的指纹。

appid参数：是一个 GUID，用于标识所属应用程序，自己生成一个GUID。

部署Self Hosting 或Windows Service Hosting 宿主的WebApi服务，通过工具操作非常方便，C/S框架网提供IP端口绑定SSL证书用于支持HTTPS协议的原创工具：