key_derivation

io.github.bowenerchen/cipherhub · Verify this server

[kdf] 执行密钥派生（KDF），从高熵秘密或口令派生对称密钥材料。 【支持算法】 - HKDF（默认）：RFC 5869 extract-then-expand，底层哈希 Sha256（默认）/ Sha384 / Sha512 - Sm3Kdf：GB/T 32918 密钥派生，SM3(Z ∥ be32(ct))，ct 从 1 起，适合对 SM2 ECDH 共享秘密派生密钥 - Pbkdf2Sm3：RFC 8018 PBKDF2，PRF 为 HMAC-SM3，用于口令拉伸 【参数】（按算法适用，错配会被拒） - algorithm：HKDF / Sm3Kdf / Pbkdf2Sm3，默认 HKDF - hash_algorithm：仅 HKDF，默认 Sha256 - input_in_hex：HKDF 的 IKM / Sm3Kdf 的共享秘密 Z，Hex（1B~16MB），与 password 二选一 - password：仅 Pbkdf2Sm3，口令原文 utf-8（1~1024B） - salt_in_hex：HKDF/Pbkdf2Sm3 可选盐 Hex（≤256B）。HKDF 空=未提供（RFC 5869 补 HashLen 零）；Pbkdf2Sm3 空=服务端生成 16B 随机盐并在响应回显 - info_in_hex：仅 HKDF，可选上下文信息 Hex（≤256B） - iterations：仅 Pbkdf2Sm3，10000~4000000（默认 10000；受 8s 网关约束，eet CLI 上限为 16777216，互通测试建议取 ≤100 万区间） - derived_key_length：派生长度，16~1024B（默认 32；Pbkdf2Sm3 上限 256B） 【输出】derived_key_in_hex、derived_key_in_base64、salt_used_in_hex（实际使用的盐，Pbkdf2Sm3 未提供盐时回显服务端随机盐）、salt_generated、algorithm、hash_algorithm、iterations、derived_key_length、input_bytes。 【典型用途】ECDH 共享秘密到会话密钥的收口、口令到加密密钥的拉伸、多上下文密钥隔离（HKDF info）。