NET部署多域名Https（SSL）通过代码的方式

给大家介绍了怎么在配置文件中使用 Kestrel 部署 Https，正好今天有小伙伴稳问到：可以通过代码的方式实现 Kestrel 的 Https 的部署吗？答案是肯定的，我们这次一样去不是多个域名。

在使用代码实现中，我是主要使用到 ListenOptions.UseHttps，我们先看看官方文档怎么说吧，不想看我的可以直接跳转到官方文档，传送门

ListenOptions.UseHttps

将 Kestrel 配置为使用 HTTPS。

ListenOptions.UseHttps扩展：

UseHttps：将 Kestrel 配置为使用 HTTPS，采用默认证书。 如果没有配置默认证书，则会引发异常。

UseHttps(string fileName)

UseHttps(string fileName, string password)

UseHttps(string fileName, string password, Action configureOptions)

UseHttps(StoreName storeName, string subject)

UseHttps(StoreName storeName, string subject, bool allowInvalid)

UseHttps(StoreName storeName, string subject, bool allowInvalid, StoreLocation location)

UseHttps(StoreName storeName, string subject, bool allowInvalid, StoreLocation location, Action configureOptions)

UseHttps(X509Certificate2 serverCertificate)

UseHttps(X509Certificate2 serverCertificate, Action configureOptions)

UseHttps(Action configureOptions)

ListenOptions.UseHttps参数：

• filename是证书文件的路径和文件名，关联包含应用内容文件的目录。

• password是访问 X.509 证书数据所需的密码。

• configureOptions是配置HttpsConnectionAdapterOptions的Action。 返回ListenOptions。

• storeName是从中加载证书的证书存储。

• subject是证书的主题名称。

• allowInvalid指示是否存在需要留意的无效证书，例如自签名证书。

• location是从中加载证书的存储位置。

• serverCertificate是 X.509 证书。

在生产中，必须显式配置 HTTPS。 至少必须提供默认证书。

下面要描述的支持的配置：

• 无配置

• 从配置中替换默认证书

• 更改代码中的默认值

无配置

Kestrel 在http://localhost:5000和https://localhost:5001上进行侦听（如果默认证书可用）。

从配置中替换默认证书

Kestrel 可以使用默认 HTTPS 应用设置配置架构。 从磁盘上的文件或从证书存储中配置多个终结点，包括要使用的 URL 和证书。

架构的注意事项：

• 终结点的名称不区分大小写。 例如，由于再也无法解析标识符Families，因此HTTPSandHttps是等效的。

• 每个终结点都要具备Url参数。 此参数的格式和顶层Urls配置参数一样，只不过它只能有单个值。

• 这些终结点不会添加进顶层Urls配置中定义的终结点，而是替换它们。 通过Listen在代码中定义的终结点与在配置节中定义的终结点相累积。

• Certificate部分是可选的。 如果未指定Certificate部分，则使用Certificates:Default中定义的默认值。 如果没有可用的默认值，则使用开发证书。 如果没有默认值，且开发证书不存在，则服务器将引发异常，并且无法启动。

• Certificate部分支持多个证书源。

• 只要不会导致端口冲突，就能在配置中定义任何数量的终结点。

证书源

可以将证书节点配置为从多个源加载证书：

• Path和Password用于加载 .pfx 文件。

• Path、KeyPath和Password用于加载 .pem/.crt和 .key 文件。

• Subject和Store用于从证书存储中加载。

好了，罗嗦话说完了，我们抽取文档的一部分进行实践

varbuilder = WebApplication.CreateBuilder(args);

builder.WebHost.ConfigureKestrel(serverOptions=>{
    serverOptions.ListenAnyIP(5005,listenOptions=>{
        listenOptions.UseHttps(httpsOptions=>{varlocalhostCert = CertificateLoader.LoadFromStoreCert("localhost","My", StoreLocation.CurrentUser,
                allowInvalid:true);varexampleCert = CertificateLoader.LoadFromStoreCert("example.com","My", StoreLocation.CurrentUser,
                allowInvalid:true);varsubExampleCert = CertificateLoader.LoadFromStoreCert("sub.example.com","My", StoreLocation.CurrentUser,
                allowInvalid:true);varcerts =newDictionary<string, X509Certificate2>(
                StringComparer.OrdinalIgnoreCase)
            {
                ["localhost"] = localhostCert,
                ["example.com"] = exampleCert,
                ["sub.example.com"] = subExampleCert
            };

            httpsOptions.ServerCertificateSelector =(connectionContext, name) =>{if(name is notnull&& certs.TryGetValue(name, outvarcert))
                {returncert;
                }returnexampleCert;
            };
        });
    });
});

上面的代码一看就能懂，比较无奈的是官方文档的 SSL 证书是从 证书存储区 里获取的，在实际应用中，明显是不够方便，最好是那种直接写 证书路径 和 密码的，这样才能一目了然嘛，而这里的关键就是 X509Certificate2 这个类了，可以看到，最终是通过检索一个字典返回的，接受的就是这个 X509Certificate2 类，所以我们看看这个类到底是个什么东西，传送门；

这里我们只关注构造函数，下面是官方文档，或者直接 F12 进去看更为直接

构造函数

直接 F12 也贴出来吧，方便大伙查看

帅气的小伙伴可能已经发现了，里面就存在了一个 直接传入 文件路径 和 密码 作为参数的构造函数，毫无疑问，它就是我们要找的！！！下面我们直接看代码：

Program.cs

builder.WebHost.ConfigureKestrel(serverOptions=>{
    serverOptions.ConfigureHttpsDefaults(listenOptions=>{
        listenOptions.SslProtocols = SslProtocols.Tls13;
    });
    serverOptions.ListenAnyIP(5209,listenOptions=>{
        listenOptions.UseHttps(httpsOptions=>{vartest1 =newX509Certificate2("cer\\test1.ysmc.net.cn_server.pfx","密码1");vartest2 =newX509Certificate2("cer\\test2.ysmc.net.cn_server.pfx","密码2");varcerts =newDictionary<string, X509Certificate2>(
                StringComparer.OrdinalIgnoreCase)
            {
                ["test1.ysmc.net.cn"] = test1,
                ["test2.ysmc.net.cn"] = test2
            };

            httpsOptions.ServerCertificateSelector =(connectionContext, name) =>{if(name is notnull&& certs.TryGetValue(name, outvarcert))
                {returncert;
                }returntest1;
            };
        });
    });
});

因为是配合了 YARP 食用的，详情可以查看我前面的文章，传送门，所以不同的域名会反向代理到不同的网站上面，好了，文章到此结束，感谢大佬们的阅读，谢谢！