From 91f1158c69abafe77bd0417d6c1955773ac4e48c Mon Sep 17 00:00:00 2001 From: Rob Ede Date: Mon, 7 Mar 2022 13:40:36 +0000 Subject: [PATCH] update http2 docs --- content/docs/http2.md | 11 ++++------- 1 file changed, 4 insertions(+), 7 deletions(-) diff --git a/content/docs/http2.md b/content/docs/http2.md index 8262c8b..f63c9a7 100644 --- a/content/docs/http2.md +++ b/content/docs/http2.md @@ -4,17 +4,13 @@ menu: docs_protocols weight: 250 --- -`actix-web` automatically upgrades connections to _HTTP/2_ if possible. +Actix Web will prefer HTTP/2 connections if the client signals support for it via [TLS ALPN][tlsalpn]. # Negotiation -_HTTP/2_ protocol over TLS without prior knowledge requires [TLS ALPN][tlsalpn]. - -> Currently, only `rust-openssl` has support. - -`alpn` negotiation requires enabling the feature. When enabled, `HttpServer` provides the [bind_openssl][bindopenssl] method. +When either of the `rustls` or `openssl` features are enabled, `HttpServer` provides the [bind_rustls][bindrustls] method and [bind_openssl][bindopenssl] methods, respectively. ```toml [dependencies] @@ -24,12 +20,13 @@ openssl = { version = "0.10", features = ["v110"] } {{< include-example example="http2" file="main.rs" section="main" >}} -Upgrades to _HTTP/2.0_ schema described in [rfc section 3.2][rfcsection32] is not supported. Starting _HTTP/2_ with prior knowledge is supported for both clear text connection and tls connection. [rfc section 3.4][rfcsection34]. +Upgrades to HTTP/2 described in [RFC §3.2][rfcsection32] are not supported. Starting HTTP/2 with prior knowledge is supported for both cleartext and TLS connections ([RFC §3.4][rfcsection34]) (when using the lower level `actix-http` service builders). > Check out [examples/tls][examples] for a concrete example. [rfcsection32]: https://http2.github.io/http2-spec/#rfc.section.3.2 [rfcsection34]: https://http2.github.io/http2-spec/#rfc.section.3.4 +[bindrustls]: https://docs.rs/actix-web/4/actix_web/struct.HttpServer.html#method.bind_rustls [bindopenssl]: https://docs.rs/actix-web/4/actix_web/struct.HttpServer.html#method.bind_openssl [tlsalpn]: https://tools.ietf.org/html/rfc7301 [examples]: https://github.com/actix/examples/tree/master/https-tls/rustls