You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: docs/en/api-reference/protocols/esp_crt_bundle.rst
+7-9Lines changed: 7 additions & 9 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -87,28 +87,26 @@ Cross-Signed Certificate Support
87
87
Overview
88
88
^^^^^^^^
89
89
90
-
When the configuration option :ref:`CONFIG_MBEDTLS_CERTIFICATE_BUNDLE_CROSS_SIGNED_VERIFY` is enabled,
91
-
the ESP x509 Certificate Bundle API adds support for verifying certificate chains that include cross-signed root certificates.
92
-
This feature allows the verification process to dynamically select candidate Certificate Authorities (CAs) from the bundle,
93
-
even when the certificate chain contains cross-signed roots, improving interoperability with a wider range of server certificates.
90
+
When the configuration option :ref:`CONFIG_MBEDTLS_CERTIFICATE_BUNDLE_CROSS_SIGNED_VERIFY` is enabled, the ESP x509 Certificate Bundle API adds support for verifying certificate chains that include cross-signed root certificates.
94
91
95
-
With this functionality enabled, certificate verification is performed in a manner equivalent to the default mbedTLS behaviour,
96
-
ensuring compatibility and robust validation for cross-signed chains.
92
+
This feature allows the verification process to dynamically select candidate Certificate Authorities (CAs) from the bundle, even when the certificate chain contains cross-signed roots, improving interoperability with a wider range of server certificates.
93
+
94
+
With this functionality enabled, certificate verification is performed in a manner equivalent to the default mbedTLS behavior, ensuring compatibility and robust validation for cross-signed chains.
97
95
98
96
.. note::
99
97
100
-
Enabling cross-signed certificate support increases run-time heap utilisation by approximately 700 bytes, but reduces the flash footprint as the bundle size is reduced.
98
+
Enabling cross-signed certificate support increases run-time heap utilization by approximately 700 bytes, but reduces the flash footprint as the bundle size is reduced.
101
99
102
100
Key Points:
101
+
103
102
- The bundle can act as a dynamic CA store, providing candidate root certificates during the handshake.
104
103
- The verification callback uses the issuer information from the certificate chain to locate and provide matching root certificates from the bundle.
105
104
- This is especially useful for environments where cross-signing is common, such as during root CA transitions.
106
105
107
106
Usage
108
107
^^^^^
109
108
110
-
No additional application changes are required beyond enabling :ref:`CONFIG_MBEDTLS_CERTIFICATE_BUNDLE_CROSS_SIGNED_VERIFY` in your project configuration.
111
-
The bundle will automatically provide candidate CAs during the TLS handshake.
109
+
No additional application changes are required beyond enabling :ref:`CONFIG_MBEDTLS_CERTIFICATE_BUNDLE_CROSS_SIGNED_VERIFY` in your project configuration. The bundle will automatically provide candidate CAs during the TLS handshake.
0 commit comments