mirror of https://github.com/espressif/esp-idf.git synced 2024-10-05 20:47:46 -04:00

History

Angus Gratton 04ae56806c Merge branch 'master' into feature/esp32s2beta_update		2019-08-08 15:26:58 +10:00
..
main	tools: Mass fixing of empty prototypes (for -Wstrict-prototypes)	2019-08-01 16:28:56 +07:00
CMakeLists.txt	ci: support to build esp32s2beta simple examples	2019-07-08 09:16:06 +08:00
Makefile	examples/protocols/http(s)_server: use common network component	2019-04-15 03:32:05 +00:00
README.md	build system: Use CMake-based build system as default when describing commands	2019-07-08 17:31:27 +10:00
sdkconfig.ci	example/https_server: Add default sdkconfig	2019-06-25 23:43:35 +00:00
sdkconfig.defaults	example/https_server: Add default sdkconfig	2019-06-25 23:43:35 +00:00

README.md

HTTP server with SSL support using OpenSSL

This example creates a SSL server that returns a simple HTML page when you visit its root URL.

See the esp_https_server component documentation for details.

Before using the example, open the project configuration menu (idf.py menuconfig) to configure Wi-Fi or Ethernet. See "Establishing Wi-Fi or Ethernet Connection" section in examples/protocols/README.md for more details.

Certificates

You will need to approve a security exception in your browser. This is because of a self signed certificate; this will be always the case, unless you preload the CA root into your browser/system as trusted.

You can generate a new certificate using the OpenSSL command line tool:

openssl req -newkey rsa:2048 -nodes -keyout prvtkey.pem -x509 -days 3650 -out cacert.pem -subj "/CN=ESP32 HTTPS server example"

Expiry time and metadata fields can be adjusted in the invocation.

Please see the openssl man pages (man openssl-req) for more details.

It is strongly recommended to not reuse the example certificate in your application; it is included only for demonstration.