From 4a7805ad650949ad5e49c929ca9bd4e5991ced3f Mon Sep 17 00:00:00 2001 From: admin Date: Sun, 25 Oct 2026 17:09:34 +0800 Subject: [PATCH] =?UTF-8?q?docs:=20cipher=20=E5=90=91=E9=87=8F=E7=8B=AC?= =?UTF-8?q?=E7=AB=8B=E9=AA=8C=E7=AE=97=E9=80=9A=E8=BF=87=EF=BC=8C=E4=BF=AE?= =?UTF-8?q?=E6=AD=A3=E9=95=BF=E5=BA=A6=E6=96=AD=E8=A8=80=EF=BC=8896=20hex?= =?UTF-8?q?=20=E5=AD=97=E7=AC=A6=EF=BC=8C=E9=9D=9E=2064=EF=BC=89?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-Authored-By: Claude --- docs/contract.md | 11 +++++++++++ 1 file changed, 11 insertions(+) diff --git a/docs/contract.md b/docs/contract.md index 2b7714f..003e1db 100644 --- a/docs/contract.md +++ b/docs/contract.md @@ -119,6 +119,17 @@ encrypt_password("123456") == "d4958348e22108119b3ef57b022c83f4bf857dd0b247eaab15b9a43d47ee3c503900f7135bf0de255bc33620c3cdc02b" ``` +**中间值(已用 openssl 独立验算通过,2026-10-25)**: +``` +md5_hex("EY8WePvjM5GGwQzn") = "05b0175907a859751f57a04d5a5ee9ac" ← 32 字符,当 32 个 ASCII 字节用 +md5_hex("123456") = "e10adc3949ba59abbe56e057f20f883e" ← 32 字符,当 32 个 ASCII 字节用 +``` + +🔴 **输出长度**:输入是 32 字节(= 16 的整数倍)⇒ PKCS7 **补满一整块 16 字节** ⇒ +密文 48 字节 ⇒ hex **96 个字符**(不是 64)。 +自查:若你的实现输出 64 个 hex 字符 ⇒ 漏了 PKCS7 填充。 +解密时必须**去掉 PKCS7 填充**;填充非法 ⇒ 返回 `None`。 + **口令比对**:库内存 `md5(明文)`;登录时 `decrypt_to_md5(密文)` 得到 `md5(明文)` ⇒ **大小写不敏感**比较。 **依赖版本组合(别混用)**:`aes 0.8` + `ecb 0.1`(cipher 0.4 家族);`md-5 0.10`(crate 名 `md5`,`use md5::{Digest, Md5};`)。