asp.net core gRPC 配置TLS

文章目录

• 使用 ASP.NET Core 的 gRPC 服务(下链接有中文源地址）本文章用于自己记录
• 配置 Kestrel
• HTTP/2
• TLS
• 协议协商

使用 ASP.NET Core 的 gRPC 服务(下链接有中文源地址）本文章用于自己记录

配置 Kestrel

Kestrel gRPC 终结点：

• 需要 HTTP/2。
• 应通过传输层安全性（TLS）来保护。

HTTP/2

• gRPC 要求 HTTP/2。 gRPC for ASP.NET Core 验证HttpRequest为HTTP/2。
• 在大多数现代操作系统上，Kestrel支持 HTTP/2 。 默认情况下，Kestrel 终结点配置为支持 HTTP/1.1 和 HTTP/2 连接。

TLS

用于 gRPC 的 Kestrel 终结点应使用 TLS 进行保护。 在开发中，将在存在 ASP.NET Core 开发证书https://localhost:5001时，自动创建一个使用 TLS 保护的终结点。 不需要配置。 https前缀验证 Kestrel 终结点是否正在使用 TLS。

在生产环境中，必须显式配置 TLS。 在下面的appsettings示例中，提供了使用 TLS 保护的 HTTP/2 终结点：

{
  "Kestrel": {
    "Endpoints": {
      "HttpsInlineCertFile": {
        "Url": "https://localhost:5001",
        "Protocols": "Http2",
        "Certificate": {
          "Path": "<path to .pfx file>",
          "Password": "<certificate password>"
        }
      }
    }
  }
}

或者，可以在Program.cs中配置 Kestrel 终结点：

public static IHostBuilder CreateHostBuilder(string[] args) =>
    Host.CreateDefaultBuilder(args)
        .ConfigureWebHostDefaults(webBuilder =>
        {
            webBuilder.ConfigureKestrel(options =>
            {
                options.Listen(IPAddress.Any, 5001, listenOptions =>
                {
                    listenOptions.Protocols = HttpProtocols.Http2;
                    listenOptions.UseHttps("<path to .pfx file>", 
                        "<certificate password>");
                });
            });
            webBuilder.UseStartup<Startup>();
        });

协议协商

TLS 用于保护通信的安全性。 当终结点支持多个协议时，TLS应用层协议协商（ALPN）握手用于协商客户端与服务器之间的连接协议。 此协商确定连接是使用 HTTP/1.1 还是 HTTP/2。
如果在不使用 TLS 的情况下配置了 HTTP/2 终结点，则终结点的 ListenOptions.Protocols 必须设置为 HttpProtocols.Http2。 具有多个协议（例如）的终结HttpProtocols.Http1AndHttp2点不能使用 TLS，因为没有协商。 到不安全终结点的所有连接默认为 HTTP/1.1，并且 gRPC 调用失败。
有关通过 Kestrel 启用 HTTP/2 和 TLS 的详细信息，请参阅Kestrel 终结点配置。

阅读原文
.netcore Kestrel终结点配置