README.md
1# lws minimal http server with tls and certs from memory
2
3This is the same as the minimal-http-server-tls example, but shows how
4to init the vhost with both PEM or DER certs from memory instead of files.
5
6The server listens on port 7681 (initialized with PEM in-memory certs) and
7port 7682 (initialized with DER in-memory certs).
8
9## build
10
11```
12 $ cmake . && make
13```
14
15## usage
16
17```
18 $ ./lws-minimal-http-server-tls-mem
19[2019/02/14 14:46:40:9783] USER: LWS minimal http server TLS | visit https://localhost:7681
20[2019/02/14 14:46:40:9784] NOTICE: Using SSL mode
21[2019/02/14 14:46:40:9784] NOTICE: lws_tls_server_vhost_backend_init: vh first: mem CA OK
22parsing as der
23[2019/02/14 14:46:40:9849] NOTICE: no client cert required
24[2019/02/14 14:46:40:9849] NOTICE: created client ssl context for first
25[2019/02/14 14:46:40:9849] NOTICE: Using SSL mode
26[2019/02/14 14:46:40:9850] NOTICE: lws_tls_server_vhost_backend_init: vh second: mem CA OK
27parsing as der
28[2019/02/14 14:46:40:9894] NOTICE: no client cert required
29[2019/02/14 14:46:40:9894] NOTICE: created client ssl context for second
30[2019/02/14 14:46:40:9894] NOTICE: vhost first: cert expiry: 36167d
31[2019/02/14 14:46:40:9894] NOTICE: vhost second: cert expiry: 36167d
32[2018/03/20 13:23:14:0207] NOTICE: vhost default: cert expiry: 730459d
33```
34
35Visit https://127.0.0.1:7681 and https://127.0.0.1:7682
36
37Because it uses a selfsigned certificate, you will have to make an exception for it in your browser.
38
39## Certificate creation
40
41The selfsigned certs provided were created with
42
43```
44echo -e "GB\nErewhon\nAll around\nlibwebsockets-test\n\nlocalhost\nnone@invalid.org\n" | openssl req -new -newkey rsa:4096 -days 36500 -nodes -x509 -keyout "localhost-100y.key" -out "localhost-100y.cert"
45```
46
47they cover "localhost" and last 100 years from 2018-03-20.
48
49You can replace them with commercial certificates matching your hostname.
50
51The der content was made from PEM like this
52
53```
54 $ cat ../minimal-http-server-tls/localhost-100y.key | grep -v ^- | base64 -d | hexdump -C | tr -s ' ' | cut -d' ' -f2- | cut -d' ' -f-16 | sed "s/|.*//g" | sed "s/0000.*//g" | sed "s/^/0x/g" | sed "s/\ /\,\ 0x/g" | sed "s/\$/,/g" | sed "s/0x,//g"
55```
56
57## HTTP/2
58
59If you built lws with `-DLWS_WITH_HTTP2=1` at cmake, this simple server is also http/2 capable
60out of the box. If the index.html was loaded over http/2, it will display an HTTP 2 png.
61