Class Sm4Util

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

public final class Sm4Util extends Object
国密 SM4 分组密码算法工具类(纯 JDK 实现,零第三方依赖)。

SM4 为 128 位分组、128 位密钥的对称密码算法,支持 ECB / CBC 模式与 PKCS#7 填充,实现遵循 GB/T 32907-2016。

用法示例:

byte[] key = Sm4Util.generateKey();
String cipher = Sm4Util.encryptHex(key, "明文");
String plain  = Sm4Util.decryptStr(key, cipher);
Since:
1.0.1
Author:
suretool
  • Method Summary

    Modifier and Type
    Method
    Description
    static byte[]
    decrypt(byte[] key, byte[] data)
    SM4-ECB 解密(去除 PKCS#7 填充)。
    static byte[]
    decryptCbc(byte[] key, byte[] iv, byte[] data)
    SM4-CBC 解密(去除 PKCS#7 填充)。
    static byte[]
    decryptHex(byte[] key, String hex)
    SM4-ECB 解密,输入十六进制密文。
    static String
    decryptStr(byte[] key, String hex)
    SM4-ECB 解密十六进制密文为字符串(UTF-8)。
    static byte[]
    encrypt(byte[] key, byte[] data)
    SM4-ECB 加密(PKCS#7 填充)。
    static byte[]
    encryptCbc(byte[] key, byte[] iv, byte[] data)
    SM4-CBC 加密(PKCS#7 填充)。
    static String
    encryptHex(byte[] key, byte[] data)
    SM4-ECB 加密,密文以十六进制返回。
    static String
    encryptHex(byte[] key, String text)
    SM4-ECB 加密字符串(UTF-8),密文以十六进制返回。
    static byte[]
    生成 16 字节(128 位)随机 SM4 密钥。

    Methods inherited from class Object

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

    • generateKey

      public static byte[] generateKey()
      生成 16 字节(128 位)随机 SM4 密钥。
      Returns:
      16 字节密钥
    • encrypt

      public static byte[] encrypt(byte[] key, byte[] data)
      SM4-ECB 加密(PKCS#7 填充)。
      Parameters:
      key - 16 字节密钥
      data - 明文
      Returns:
      密文
      Throws:
      CryptoException - 密钥长度非法时抛出
    • decrypt

      public static byte[] decrypt(byte[] key, byte[] data)
      SM4-ECB 解密(去除 PKCS#7 填充)。
      Parameters:
      key - 16 字节密钥
      data - 密文
      Returns:
      明文
      Throws:
      CryptoException - 密钥长度非法或密文非法时抛出
    • encryptCbc

      public static byte[] encryptCbc(byte[] key, byte[] iv, byte[] data)
      SM4-CBC 加密(PKCS#7 填充)。
      Parameters:
      key - 16 字节密钥
      iv - 16 字节初始向量
      data - 明文
      Returns:
      密文
      Throws:
      CryptoException - 参数非法时抛出
    • decryptCbc

      public static byte[] decryptCbc(byte[] key, byte[] iv, byte[] data)
      SM4-CBC 解密(去除 PKCS#7 填充)。
      Parameters:
      key - 16 字节密钥
      iv - 16 字节初始向量
      data - 密文
      Returns:
      明文
      Throws:
      CryptoException - 参数非法时抛出
    • encryptHex

      public static String encryptHex(byte[] key, byte[] data)
      SM4-ECB 加密,密文以十六进制返回。
      Parameters:
      key - 16 字节密钥
      data - 明文
      Returns:
      十六进制密文
    • decryptHex

      public static byte[] decryptHex(byte[] key, String hex)
      SM4-ECB 解密,输入十六进制密文。
      Parameters:
      key - 16 字节密钥
      hex - 十六进制密文
      Returns:
      明文
    • encryptHex

      public static String encryptHex(byte[] key, String text)
      SM4-ECB 加密字符串(UTF-8),密文以十六进制返回。
      Parameters:
      key - 16 字节密钥
      text - 明文字符串
      Returns:
      十六进制密文
    • decryptStr

      public static String decryptStr(byte[] key, String hex)
      SM4-ECB 解密十六进制密文为字符串(UTF-8)。
      Parameters:
      key - 16 字节密钥
      hex - 十六进制密文
      Returns:
      明文字符串