如何为Rider或Visual Studio解决方案的.NET Core应用配置自定义证书和密钥

以下配置适用于Visual Studio 2019、JetBrains Rider两种IDE，可实现启动调试时使用你指定的lan.company.com自定义证书。

一、项目级通用配置（优先推荐，所有IDE通用） #

• 首先将你的自定义证书（推荐使用包含公钥和私钥的PFX格式文件）存放到项目根目录，或本机固定可访问的路径
• 优先修改开发环境配置文件appsettings.Development.json（不影响生产配置），添加Kestrel服务的证书配置：

{
  "Kestrel": {
    "Endpoints": {
      "Https": {
        "Url": "https://lan.company.com:5001",
        "Certificate": {
          "Path": "你的证书存放路径，例如./lan.company.com.pfx",
          "Password": "证书私钥密码（未设置可省略该字段）"
        }
      }
    }
  }
}

• 修改启动配置文件Properties/launchSettings.json，将启动地址替换为你的自定义域名：

"profiles": {
  "你的项目名称": {
    "commandName": "Project",
    "dotnetRunMessages": true,
    "launchBrowser": true,
    "applicationUrl": "https://lan.company.com:5001;http://lan.company.com:5000",
    "environmentVariables": {
      "ASPNETCORE_ENVIRONMENT": "Development"
    }
  }
}

• 修改系统hosts文件，添加记录127.0.0.1 lan.company.com，确保自定义域名解析到本地

注意：如果你使用IIS Express而非Kestrel启动项目，需要额外打开项目.vs文件夹下的IIS Express配置文件applicationhost.config，添加站点绑定规则<binding protocol="https" bindingInformation="*:5001:lan.company.com" />，同时将你的自定义证书导入到IIS Express证书存储并绑定到对应端口。

二、Visual Studio 2019 补充配置 #

• 打开VS顶部菜单栏「工具」->「选项」->「项目和解决方案」->「ASP.NET Core」
• 取消勾选自动检测自签名证书选项，避免IDE自动替换为默认localhost证书
• 启动项目时选择对应名称的启动项即可

三、JetBrains Rider 补充配置 #

• 点击右上角启动按钮旁的下拉箭头，选择「编辑配置」打开运行/调试设置页
• 找到对应项目的.NET启动配置，切换到「ASP.NET Core」标签页，取消勾选使用默认Kestrel证书选项
• 确认启动URL为https://lan.company.com:你设置的端口后保存配置即可

四、生效校验 #

启动项目后浏览器访问https://lan.company.com:端口，点击地址栏的锁图标查看证书详情，确认证书信息和你自定义的证书一致即为配置成功。

内容的提问来源于stack exchange，提问作者Michael Prescott