Class KdfUtil

java.lang.Object
com.sure.tool.crypto.KdfUtil

public final class KdfUtil extends Object
密钥派生工具,基于 JDK 25 正式特性 JEP 510(Key Derivation Function API)。

提供 HKDF(RFC 5869)密钥派生:extract-then-expand 与 expand-only 两种模式, 用于从高熵输入密钥材料(IKM)派生会话密钥、子密钥等,构造与 TLS 1.3 / WireGuard 一致。 核心实现仅依赖 JDK KDF,零第三方运行期依赖。

Since:
1.7.0
Author:
suretool contributors
  • Field Summary

    Fields
    Modifier and Type
    Field
    Description
    static final String
    HKDF-SHA256 算法名
    static final String
    HKDF-SHA384 算法名
    static final String
    HKDF-SHA512 算法名
  • Method Summary

    Modifier and Type
    Method
    Description
    static byte[]
    hkdf(byte[] ikm, byte[] salt, byte[] info, int length)
    HKDF extract-then-expand:从输入密钥材料派生指定长度的字节材料(默认 HKDF-SHA256)。
    static byte[]
    hkdf(byte[] ikm, byte[] salt, byte[] info, int length, String algorithm)
    HKDF extract-then-expand:指定哈希算法的重载版本。
    static byte[]
    hkdfExpand(SecretKey prk, byte[] info, int length, String algorithm)
    HKDF expand-only:基于已提取的伪随机密钥(PRK)进行扩展(默认 HKDF-SHA256)。

    Methods inherited from class Object

    clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
  • Field Details

  • Method Details

    • hkdf

      public static byte[] hkdf(byte[] ikm, byte[] salt, byte[] info, int length)
      HKDF extract-then-expand:从输入密钥材料派生指定长度的字节材料(默认 HKDF-SHA256)。
      Parameters:
      ikm - 输入密钥材料
      salt - 盐值,可为 null 或空数组(HKDF 规范允许空盐)
      info - 上下文与应用信息,可为 null 或空数组
      length - 派生输出长度(字节)
      Returns:
      派生出的字节材料
      Throws:
      IllegalArgumentException - 参数非法或派生失败
    • hkdf

      public static byte[] hkdf(byte[] ikm, byte[] salt, byte[] info, int length, String algorithm)
      HKDF extract-then-expand:指定哈希算法的重载版本。
      Parameters:
      ikm - 输入密钥材料
      salt - 盐值,可为 null 或空数组
      info - 上下文与应用信息,可为 null 或空数组
      length - 派生输出长度(字节)
      algorithm - HKDF 算法名(HKDF_SHA256 / HKDF_SHA384 / HKDF_SHA512)
      Returns:
      派生出的字节材料
      Throws:
      IllegalArgumentException - 参数非法或派生失败
    • hkdfExpand

      public static byte[] hkdfExpand(SecretKey prk, byte[] info, int length, String algorithm)
      HKDF expand-only:基于已提取的伪随机密钥(PRK)进行扩展(默认 HKDF-SHA256)。

      适用于已持有 PRK 的场景,跳过 extract 阶段直接生成指定长度输出。

      Parameters:
      prk - 已提取的伪随机密钥
      info - 上下文与应用信息,可为 null 或空数组
      length - 派生输出长度(字节)
      algorithm - HKDF 算法名
      Returns:
      派生出的字节材料
      Throws:
      IllegalArgumentException - 参数非法或派生失败