Skip to content

Commit 8f5e74e

Browse files
shenmengjingShen7436
authored andcommitted
docs: Update the CN translation for esp_crt_bundle.rst
1 parent ce92b0a commit 8f5e74e

File tree

2 files changed

+38
-9
lines changed

2 files changed

+38
-9
lines changed

docs/en/api-reference/protocols/esp_crt_bundle.rst

Lines changed: 7 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -87,28 +87,26 @@ Cross-Signed Certificate Support
8787
Overview
8888
^^^^^^^^
8989

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.
9491

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.
9795

9896
.. note::
9997

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.
10199

102100
Key Points:
101+
103102
- The bundle can act as a dynamic CA store, providing candidate root certificates during the handshake.
104103
- The verification callback uses the issuer information from the certificate chain to locate and provide matching root certificates from the bundle.
105104
- This is especially useful for environments where cross-signing is common, such as during root CA transitions.
106105

107106
Usage
108107
^^^^^
109108

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.
112110

113111
.. note::
114112

docs/zh_CN/api-reference/protocols/esp_crt_bundle.rst

Lines changed: 31 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -81,6 +81,37 @@ ESP x509 证书包 API 提供了一种简便的方法,帮助你安装自定义
8181

8282
证书包会与 Mozilla 的 NSS 根证书商店定期同步。在 ESP-IDF 的次要版本或补丁版本中,为了保证兼容性,会将上游证书包中已弃用的证书添加到弃用列表。如有需要,可以通过 :ref:`CONFIG_MBEDTLS_CERTIFICATE_BUNDLE_DEPRECATED_LIST` 将弃用证书加入默认证书包。这些弃用证书将在下一个 ESP-IDF 主要版本中移除。
8383

84+
交叉签名证书支持
85+
----------------
86+
87+
概述
88+
^^^^
89+
90+
启用配置选项 :ref:`CONFIG_MBEDTLS_CERTIFICATE_BUNDLE_CROSS_SIGNED_VERIFY` 时,ESP x509 证书包 API 将支持验证包含交叉签名根证书的证书链。
91+
92+
即使证书链中包含交叉签名根证书,验证过程中也能从证书包中智能匹配候选的证书颁发机构 (CA),从而提高与各类服务器证书的互操作性。
93+
94+
启用该功能后,证书验证逻辑与默认的 mbedTLS 行为一致,能够确保与交叉签名证书链兼容,且验证过程稳健可靠。
95+
96+
.. note::
97+
98+
启用交叉签名证书支持功能后,运行时的堆内存使用量将增加约 700 字节,但由于证书包体积减小,flash 占用会降低。
99+
100+
关键点:
101+
102+
- 证书包可作为动态 CA 存储,在握手过程中提供候选的根证书;
103+
- 验证回调函数会使用证书链中的颁发者信息,从证书包中定位并提供匹配的根证书;
104+
- 该功能在交叉签名较为常见的场景中能够提供帮助,例如根 CA 切换期间。
105+
106+
使用方法
107+
^^^^^^^^
108+
109+
除了在项目配置中启用 :ref:`CONFIG_MBEDTLS_CERTIFICATE_BUNDLE_CROSS_SIGNED_VERIFY` 外,应用无需额外更改。握手过程中,证书包会自动提供候选的 CA。
110+
111+
.. note::
112+
113+
如果启用了 :ref:`CONFIG_MBEDTLS_CERTIFICATE_BUNDLE_CROSS_SIGNED_VERIFY`,其内部会使用 ``MBEDTLS_X509_TRUSTED_CERT_CALLBACK``。在此情况下,用户 **不应** 自行提供受信任证书回调函数,因为证书包会自动处理。
114+
84115
应用示例
85116
---------
86117

0 commit comments

Comments
 (0)