Skip to content

Commit d875972

Browse files
committed
[nrf fromlist] doc: wifi: Add server certificate domain validation instructions
Add instructions for verifying the authentication server’s certificate domain using exact domain match and domain suffix match options. Upstream PR #: 98190 Signed-off-by: Triveni Danda <[email protected]>
1 parent c42c579 commit d875972

File tree

1 file changed

+23
-0
lines changed

1 file changed

+23
-0
lines changed

doc/connectivity/networking/api/wifi.rst

Lines changed: 23 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -120,6 +120,29 @@ To initiate a Wi-Fi connection using enterprise security, use one of the followi
120120
Server certificate is also provided in the same directory for testing purposes.
121121
Any AAA server can be used for testing purposes, for example, ``FreeRADIUS`` or ``hostapd``.
122122

123+
Server Certificate Domain Name Verification
124+
-------------------------------------------
125+
126+
The authentication server’s identity is verifed by validating the domain name in the X.509 certificate received from the server, using the Common Name (CN) field.
127+
128+
* Exact domain match — Verifies that the certificate’s CN exactly matches the specified domain.
129+
130+
* Domain suffix match — Allows a certificate whose CN ends with the given domain suffix.
131+
132+
To initiate a Wi-Fi connection using enterprise security with server certificate validation, use one of the following commands depending on the desired validation mode:
133+
134+
* Exact domain match
135+
136+
.. code-block:: console
137+
138+
wifi connect -s <SSID> -c <channel> -k 12 -K <Private key Password> -e <Domain match>
139+
140+
* Domain suffix match
141+
142+
.. code-block:: console
143+
144+
wifi connect -s <SSID> -c <channel> -k 12 -K <Private key Password> -x <Domain suffix name>
145+
123146
Certificate requirements for EAP methods
124147
----------------------------------------
125148

0 commit comments

Comments
 (0)