diff --git a/docs/zh_CN/migration-guides/release-5.x/5.5/security.rst b/docs/zh_CN/migration-guides/release-5.x/5.5/security.rst
index 87004c5383..3d486929c1 100644
--- a/docs/zh_CN/migration-guides/release-5.x/5.5/security.rst
+++ b/docs/zh_CN/migration-guides/release-5.x/5.5/security.rst
@@ -1,4 +1,19 @@
 安全性
-=======
+======
 
 :link_to_translation:`en:[English]`
+
+.. only:: SOC_SHA_SUPPORTED
+
+    Mbed TLS
+    --------
+
+    从 **ESP-IDF v5.5** 开始，SHA 子功能 API（:cpp:func:`esp_sha_block` 和 :cpp:func:`esp_sha_dma`）的使用方式发生了变化。
+
+    在此之前，这些 API 会在内部自动设置 SHA 模式。但从 ESP-IDF v5.5 起，需要在调用 API 前显式设置 SHA 模式。
+
+    例如，如果你打算使用 **SHA-256** 算法，必须首先调用 :cpp:func:`esp_sha_set_mode` 并传入参数 ``SHA2_256``：
+
+    .. code-block:: c
+
+        esp_sha_set_mode(SHA2_256);
diff --git a/docs/zh_CN/migration-guides/release-6.x/6.0/security.rst b/docs/zh_CN/migration-guides/release-6.x/6.0/security.rst
index 87004c5383..840f15434c 100644
--- a/docs/zh_CN/migration-guides/release-6.x/6.0/security.rst
+++ b/docs/zh_CN/migration-guides/release-6.x/6.0/security.rst
@@ -2,3 +2,12 @@
 =======
 
 :link_to_translation:`en:[English]`
+
+Mbed TLS
+--------
+
+    从 **ESP-IDF v6.0** 开始，一些已废弃的 mbedtls 头文件已被移除，例如 ``esp32/aes.h``、``esp32/sha.h``、``esp32s2/aes.h``、``esp32s2/sha.h`` 和 ``esp32s2/gcm.h``。请改为分别包含 ``aes/esp_aes.h``、``sha/sha_core.h`` 和 ``aes/esp_aes_gcm.h``。
+
+    .. only:: SOC_SHA_SUPPORTED
+
+        SHA 模块头文件 ``sha/sha_dma.h`` 和 ``sha/sha_block.h`` 也已废弃并被移除，请改为包含 ``sha/sha_core.h``。