ASP.NET Core + IIS Express 如何设置 SSL 证书

体操

ASP.NET Core + IIS Express 如何设置 SSL 证书

在使用 ASP.NET Core 开发 Web 应用程序时，我们经常需要为应用程序配置 SSL 证书，以提供更安全的通信。本文将介绍如何在 ASP.NET Core 应用程序中使用 IIS Express 设置 SSL 证书，并提供案例代码来演示具体操作步骤。

1. 生成自签名 SSL 证书

首先，我们需要生成一个自签名的 SSL 证书。自签名证书是由我们自己签名的证书，不需要经过第三方机构的认证。在开发环境中，自签名证书是一个很好的选择。

可以使用 OpenSSL 工具来生成自签名证书。以下是一个使用 OpenSSL 生成自签名证书的示例命令：

shell
openssl req -x509 -newkey rsa:4096 -nodes -keyout localhost.key -out localhost.crt -days 365

执行以上命令后，会生成一个私钥文件 localhost.key 和一个证书文件 localhost.crt。

2. 配置应用程序启用 SSL

接下来，我们需要在 ASP.NET Core 应用程序中配置启用 SSL。可以在 Startup.cs 文件的 ConfigureServices 方法中添加以下代码：

csharp
public void ConfigureServices(IServiceCollection services)
{
    // ...
    if (Environment.IsDevelopment())
    {
        services.Configure<KestrelServerOptions>(options =>
        {
            options.Listen(iPaddress.Loopback, 443, listenOptions =>
            {
                listenOptions.UseHttps("localhost.crt", "localhost.key");
            });
        });
    }
    // ...
}

以上代码片段中，我们使用 KestrelServerOptions 对象来配置 Kestrel 服务器的选项。在开发环境中，我们通过判断 Environment.IsDevelopment() 是否为 true，来确定是否使用 SSL。

当应用程序在开发环境下运行时，Kestrel 服务器将使用 localhost.crt 和 localhost.key 作为 SSL 证书和私钥。

3. 配置 IIS Express 使用 SSL 证书

现在，我们需要配置 IIS Express 来使用 SSL 证书。可以在项目的根目录下的 .vs\config\applicationhost.config 文件中进行配置。

找到 节点，将其修改为以下内容：

XML
<site name="YourSiteName" id="YourSiteId">
    <application path="/" applicationPool="Clr4IntegratedAppPool">
        <virtualDirectory path="/" physicalPath="YourPhysicalPath" />
    </application>
    <bindings>
        <binding protocol="https" bindingInformation="*:443:localhost" />
    </bindings>
</site>

在以上代码中，YourSiteName 为你的站点名称，YourSiteId 为你的站点 ID，YourPhysicalPath 为你的应用程序的物理路径。

bindingInformation="*:443:localhost" 指定了 IIS Express 监听的端口和主机名。在这个例子中，使用的是默认的 443 端口和 localhost 主机名。

4. 配置 IIS Express 使用 SSL 证书文件

在 .vs\config\applicationhost.config 文件中的 节点下，找到 节点，将其修改为以下内容：

XML
<siteDefaults>
    <!-- ... -->
    <bindings>
        <binding protocol="https" sslFlags="0" />
    </bindings>
</siteDefaults>

以上代码中的 sslFlags="0" 指定了 SSL 证书的标志。默认情况下，IIS Express 会自动根据配置文件中的绑定信息加载证书。

5. 运行应用程序

现在，我们可以运行 ASP.NET Core 应用程序并使用 SSL 进行安全通信了。

在 Visual Studio 中，选择使用 IIS Express 运行应用程序。应用程序将在启动时自动加载我们之前生成的 SSL 证书，并使用该证书进行 HTTPS 通信。

在浏览器中访问 https://localhost，即可看到应用程序已经成功启用了 SSL。

本文介绍了如何在 ASP.NET Core 应用程序中使用 IIS Express 设置 SSL 证书。通过生成自签名证书、配置应用程序启用 SSL、配置 IIS Express 使用 SSL 证书文件，我们可以在开发环境中轻松启用 SSL，并提供更安全的通信。

希望本文对你有所帮助！