1
0
mirror of https://github.com/fafhrd91/actix-web synced 2024-12-01 02:54:36 +01:00
actix-web/guide/src/qs_13.md

43 lines
1.4 KiB
Markdown
Raw Normal View History

2017-12-14 07:36:28 +01:00
# HTTP/2.0
2017-12-02 09:36:50 +01:00
2017-12-14 07:36:28 +01:00
Actix web automatically upgrades connection to *HTTP/2.0* if possible.
2017-12-02 09:36:50 +01:00
## Negotiation
2018-01-13 20:17:48 +01:00
*HTTP/2.0* protocol over tls without prior knowledge requires
2017-12-02 09:36:50 +01:00
[tls alpn](https://tools.ietf.org/html/rfc7301). At the moment only
`rust-openssl` has support. Turn on `alpn` feature to enable `alpn` negotiation.
With enable `alpn` feature `HttpServer` provides
[serve_tls](../actix_web/struct.HttpServer.html#method.serve_tls) method.
```toml
[dependencies]
actix-web = { git = "https://github.com/actix/actix-web", features=["alpn"] }
```
```rust,ignore
use std::fs::File;
use actix_web::*;
fn main() {
let mut file = File::open("identity.pfx").unwrap();
let mut pkcs12 = vec![];
file.read_to_end(&mut pkcs12).unwrap();
let pkcs12 = Pkcs12::from_der(&pkcs12).unwrap().parse("12345").unwrap();
HttpServer::new(
2017-12-14 06:56:30 +01:00
|| Application::new()
.resource("/index.html", |r| r.f(index)))
2017-12-20 03:36:29 +01:00
.bind("127.0.0.1:8080").unwrap();
.serve_ssl(pkcs12).unwrap();
2017-12-02 09:36:50 +01:00
}
```
2017-12-14 07:36:28 +01:00
Upgrade to *HTTP/2.0* schema described in
2017-12-02 09:36:50 +01:00
[rfc section 3.2](https://http2.github.io/http2-spec/#rfc.section.3.2) is not supported.
2017-12-05 01:26:40 +01:00
Starting *HTTP/2* with prior knowledge is supported for both clear text connection
2017-12-02 09:36:50 +01:00
and tls connection. [rfc section 3.4](https://http2.github.io/http2-spec/#rfc.section.3.4)
Please check [example](https://github.com/actix/actix-web/tree/master/examples/tls)
for concrete example.