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

History

Shyamal Khachane f2905d1388 fix(esp_wifi): WPA3 enterprise 192 bit fix and config modification 1. Added SOC caps dependency for enabling 192 bit security in wifi enterprise example 2. Fixed authmode in log and connected event for WPA3 enterprise 192 bit security		2023-09-12 10:43:17 +05:30
..
generate_certs	feat(certs): Add python script for generating certificate	2023-06-26 22:38:33 +08:00
main	fix(esp_wifi): WPA3 enterprise 192 bit fix and config modification	2023-09-12 10:43:17 +05:30
CMakeLists.txt	tools: Increase the minimal supported CMake version to 3.16	2022-06-01 06:35:02 +00:00
README.md	feat(certs): Add python script for generating certificate	2023-06-26 22:38:33 +08:00

README.md

Supported Targets	ESP32	ESP32-C2	ESP32-C3	ESP32-C6	ESP32-S2	ESP32-S3

WPA2 Enterprise Example

This example shows how ESP32 connects to AP with Wi-Fi enterprise encryption. The example does the following steps:

Install CA certificate which is optional.
Install client certificate and client key which is required in TLS method and optional in PEAP and TTLS methods.
Set identity of phase 1 which is optional.
Set user name and password of phase 2 which is required in PEAP and TTLS methods.
Enable wpa2 enterprise.
Connect to AP.

Note:

The certificates currently are generated and are present in examples/wifi/wifi_enterprise/main folder.
The expiration date of the certificates is 2027/06/05.
In case using suite-b, please go into generate_certs directory, then execute the script as python generate_certs.py <cert_type> sha384 to create appropriate certificates such as RSA-3072 or p384 EC certificates.

The steps to create new certificates are given below.

The file ca.pem, ca.key, server.pem, server.crt and server.key can be used to configure AP with enterprise encryption.

How to use Example

Configuration

idf.py menuconfig

Set SSID of Access Point to connect in Example Configuration.
Select EAP method (TLS, TTLS or PEAP).
Select Phase2 method (only for TTLS).
Enter EAP-ID.
Enter Username and Password (only for TTLS and PEAP).
Enable or disable Validate Server option.

Build and Flash the project.

idf.py -p PORT flash monitor

Steps to create enterprise openssl certs

make directry tree

  mkdir demoCA
  mkdir demoCA/newcerts
  mkdir demoCA/private
  sh -c "echo '01' > ./demoCA/serial"
  touch ./demoCA/index.txt
  touch xpextensions

     add following lines in xpextensions file

      [ xpclient_ext ]
      extendedKeyUsage = 1.3.6.1.5.5.7.3.2

      [ xpserver_ext ]
      extendedKeyUsage = 1.3.6.1.5.5.7.3.1

ca.pem: root certificate, foundation of certificate verigy

  openssl req -new -x509 -keyout ca.key -out ca.pem

generate rsa keys for client and server

  openssl genrsa -out client.key 2048
  openssl genrsa -out server.key 2048

generate certificate signing req for both client and server

  openssl req -new -key client.key -out client.csr
  openssl req -new -key server.key -out server.csr

create certs (.crt) for client nd server

  openssl ca -batch -keyfile ca.key -cert ca.pem -in client.csr -key (password) -out client.crt -extensions xpclient_ext -extfile xpextensions
  openssl ca -batch -keyfile ca.key -cert ca.pem -in server.csr -key (password) -out server.crt -extensions xpserver_ext -extfile xpextensions

export .p12 files

  openssl pkcs12 -export -out client.p12 -inkey client.key -in client.crt
  openssl pkcs12 -export -out server.p12 -inkey server.key -in server.crt

create .pem files

  openssl pkcs12 -in client.p12 -out client.pem
  openssl pkcs12 -in server.p12 -out server.pem

Example output

Here is an example of wpa2 enterprise(PEAP method) console output.

I (1352) example: Setting WiFi configuration SSID wpa2_test...
I (1362) wpa: WPA2 ENTERPRISE VERSION: [v2.0] enable

I (1362) wifi: rx_ba=1 tx_ba=1

I (1372) wifi: mode : sta (24:0a:c4:03:b8:dc)
I (3002) wifi: n:11 0, o:1 0, ap:255 255, sta:11 0, prof:11
I (3642) wifi: state: init -> auth (b0)
I (3642) wifi: state: auth -> assoc (0)
I (3652) wifi: state: assoc -> run (10)
I (3652) wpa: wpa2_task prio:24, stack:6144

I (3972) wpa: >>>>>wpa2 FINISH

I (3982) wpa: wpa2 task delete

I (3992) wifi: connected with wpa2_test, channel 11
I (5372) example: ~~~~~~~~~~~
I (5372) example: IP:0.0.0.0
I (5372) example: MASK:0.0.0.0
I (5372) example: GW:0.0.0.0
I (5372) example: ~~~~~~~~~~~
I (6832) event: ip: 192.168.1.112, mask: 255.255.255.0, gw: 192.168.1.1
I (7372) example: ~~~~~~~~~~~
I (7372) example: IP:192.168.1.112
I (7372) example: MASK:255.255.255.0
I (7372) example: GW:192.168.1.1
I (7372) example: ~~~~~~~~~~~
I (9372) example: ~~~~~~~~~~~
I (9372) example: IP:192.168.1.112
I (9372) example: MASK:255.255.255.0
I (9372) example: GW:192.168.1.1
I (9372) example: ~~~~~~~~~~~