openssl/demos/http3/README.md
James Muir 22fa1602da quic http3 demo: minor updates
-update run command to include LD_LIBRARY_PATH
-suggest installing libnghttp3-dev on Ubuntu
-drop "-f" from clean recipe (it is already included in $(RM))

Part of https://github.com/openssl/project/issues/253

Reviewed-by: Hugo Landau <hlandau@openssl.org>
Reviewed-by: Matt Caswell <matt@openssl.org>
Reviewed-by: Paul Dale <pauli@openssl.org>
(Merged from https://github.com/openssl/openssl/pull/22623)
2023-11-08 11:12:55 +11:00

1.2 KiB

HTTP/3 Demo using OpenSSL QUIC and nghttp3

This is a simple demo of how to use HTTP/3 with OpenSSL QUIC using the HTTP/3 library “nghttp3”.

The demo is structured into two parts:

  • an adaptation layer which binds nghttp3 to OpenSSL's QUIC implementation (ossl-nghttp3.c);
  • a simple application which makes an HTTP/3 request using this adaptation layer (ossl-nghttp3-demo.c).

The Makefile in this directory can be used to build the demo on *nix-style systems. You will need the nghttp3 library and header file. On Ubuntu, these can be obtained by installing the package libnghttp3-dev.

Running the Demo

Depending on your system configuration it may be necessary to set the SSL_CERT_FILE or SSL_CERT_DIR environment variables to a location where trusted root CA certificates can be found.

After building by running make, run ./ossl-nghttp3-demo with a hostname and port as the sole argument:

$ make
$ LD_LIBRARY_PATH=../.. ./ossl-nghttp3-demo www.google.com:443

The demo produces the HTTP response headers in textual form as output followed by the response body.

See Also