Package cn.gmkit.zuc

Class ZUCUtil

java.lang.Object

cn.gmkit.zuc.ZUCUtil

public final class ZUCUtil
extends Object

Static convenience entry point for ZUC-128.

This class mirrors ZUC; it exists for users who prefer a utility naming style consistent with SM2/SM3/SM4 helpers in this module.

Field Summary

Fields

Modifier and Type	Field	Description
static final int	IV_LENGTH	ZUC-128 IV length in bytes.
static final int	KEY_LENGTH	ZUC-128 key length in bytes.

Method Summary

Modifier and Type	Method	Description
static byte[]	decrypt(byte[] key, byte[] iv, byte[] ciphertext)	使用 ZUC 对字节密文解密；实现与 encrypt(byte[], byte[], byte[]) 相同。
static String	decryptBase64ToUtf8(String keyHex, String ivHex, String ciphertextBase64)	解密 Base64 密文并按 UTF-8 解码。
static String	decryptHexToUtf8(String keyHex, String ivHex, String ciphertextHex)	解密十六进制密文并按 UTF-8 解码。
static String	eea3(String keyHex, int count, int bearer, int direction, int bitLength)	生成兼容入口的 EEA3 字对齐密钥流。
static byte[]	eea3Encrypt(String keyHex, int count, int bearer, int direction, byte[] message)	按完整消息字节长度执行 EEA3 加密。
static byte[]	eea3Encrypt(String keyHex, int count, int bearer, int direction, byte[] message, int bitLength)	按指定有效位数执行 3GPP EEA3 加密。
static String	eia3(String keyHex, int count, int bearer, int direction, byte[] message)	计算完整消息的 EIA3 兼容 MAC。
static String	eia3(String keyHex, int count, int bearer, int direction, byte[] message, int bitLength)	按指定有效位数计算标准 EIA3 MAC。
static String	eia3(String keyHex, int count, int bearer, int direction, String message)	按 UTF-8 文本计算完整消息的 EIA3 兼容 MAC。
static byte[]	encrypt(byte[] key, byte[] iv, byte[] plaintext)	使用 ZUC 对字节消息加密；ZUC 是异或流密码，解密使用同一方法。
static String	encryptBase64(String keyHex, String ivHex, String plaintext)	按 UTF-8 文本输入执行 ZUC 加密并返回 Base64 密文。
static String	encryptHex(String keyHex, String ivHex, String plaintext)	按 UTF-8 文本输入执行 ZUC 加密并返回十六进制密文。
static byte[]	keystream(byte[] key, byte[] iv, int lengthBytes)	生成 ZUC 密钥流字节。
static String	keystreamHex(String keyHex, String ivHex, int lengthBytes)	生成十六进制 ZUC 密钥流。
static int[]	keystreamWords(byte[] key, byte[] iv, int lengthWords)	生成按大端解释的 32 位 ZUC 密钥流字。
static String	keystreamWordsHex(String keyHex, String ivHex, int lengthWords)	生成按大端字序拼接的十六进制密钥流字。

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Details

KEY_LENGTH

public static final int KEY_LENGTH

ZUC-128 key length in bytes.

See Also:

• Constant Field Values

IV_LENGTH

public static final int IV_LENGTH

ZUC-128 IV length in bytes.

See Also:

• Constant Field Values

Method Details

keystream

public static byte[] keystream(byte[] key,
 byte[] iv,
 int lengthBytes)

生成 ZUC 密钥流字节。

Parameters:

key - 16 字节密钥

iv - 16 字节初始化向量

lengthBytes - 输出字节数，不能为负

Returns:

密钥流字节

See Also:

• ZUC.keystream(byte[], byte[], int)

keystreamHex

public static String keystreamHex(String keyHex,
 String ivHex,
 int lengthBytes)

生成十六进制 ZUC 密钥流。

Parameters:

keyHex - 32 个十六进制字符的密钥

ivHex - 32 个十六进制字符的 IV

lengthBytes - 输出字节数

Returns:

小写十六进制密钥流

See Also:

• ZUC.keystreamHex(String, String, int)

keystreamWords

public static int[] keystreamWords(byte[] key,
 byte[] iv,
 int lengthWords)

生成按大端解释的 32 位 ZUC 密钥流字。

Parameters:

key - 16 字节密钥

iv - 16 字节初始化向量

lengthWords - 输出的 32 位字数量

Returns:

无符号 32 位值使用 int 承载的数组

See Also:

• ZUC.keystreamWords(byte[], byte[], int)

keystreamWordsHex

public static String keystreamWordsHex(String keyHex,
 String ivHex,
 int lengthWords)

生成按大端字序拼接的十六进制密钥流字。

Parameters:

keyHex - 32 个十六进制字符的密钥

ivHex - 32 个十六进制字符的 IV

lengthWords - 输出的 32 位字数量

Returns:

小写十六进制密钥流

See Also:

• ZUC.keystreamWordsHex(String, String, int)

encrypt

public static byte[] encrypt(byte[] key,
 byte[] iv,
 byte[] plaintext)

使用 ZUC 对字节消息加密；ZUC 是异或流密码，解密使用同一方法。

Parameters:

key - 16 字节密钥

iv - 16 字节初始化向量

plaintext - 明文字节

Returns:

密文字节

See Also:

• ZUC.encrypt(byte[], byte[], byte[])

encryptHex

public static String encryptHex(String keyHex,
 String ivHex,
 String plaintext)

按 UTF-8 文本输入执行 ZUC 加密并返回十六进制密文。

Parameters:

keyHex - 32 个十六进制字符的密钥

ivHex - 32 个十六进制字符的 IV

plaintext - UTF-8 明文

Returns:

小写十六进制密文

See Also:

• ZUC.encryptHex(String, String, String)

encryptBase64

public static String encryptBase64(String keyHex,
 String ivHex,
 String plaintext)

按 UTF-8 文本输入执行 ZUC 加密并返回 Base64 密文。

Parameters:

keyHex - 32 个十六进制字符的密钥

ivHex - 32 个十六进制字符的 IV

plaintext - UTF-8 明文

Returns:

Base64 密文

See Also:

• ZUC.encryptBase64(String, String, String)

decrypt

public static byte[] decrypt(byte[] key,
 byte[] iv,
 byte[] ciphertext)

使用 ZUC 对字节密文解密；实现与 encrypt(byte[], byte[], byte[]) 相同。

Parameters:

key - 16 字节密钥

iv - 16 字节初始化向量

ciphertext - 密文字节

Returns:

明文字节

See Also:

• ZUC.decrypt(byte[], byte[], byte[])

decryptHexToUtf8

public static String decryptHexToUtf8(String keyHex,
 String ivHex,
 String ciphertextHex)

解密十六进制密文并按 UTF-8 解码。

Parameters:

keyHex - 32 个十六进制字符的密钥

ivHex - 32 个十六进制字符的 IV

ciphertextHex - 十六进制密文

Returns:

UTF-8 明文

See Also:

• ZUC.decryptHexToUtf8(String, String, String)

decryptBase64ToUtf8

public static String decryptBase64ToUtf8(String keyHex,
 String ivHex,
 String ciphertextBase64)

解密 Base64 密文并按 UTF-8 解码。

Parameters:

keyHex - 32 个十六进制字符的密钥

ivHex - 32 个十六进制字符的 IV

ciphertextBase64 - Base64 密文

Returns:

UTF-8 明文

See Also:

• ZUC.decryptBase64ToUtf8(String, String, String)

eea3

public static String eea3(String keyHex,
 int count,
 int bearer,
 int direction,
 int bitLength)

生成兼容入口的 EEA3 字对齐密钥流。

Parameters:

keyHex - 32 个十六进制字符的密钥

count - 32 位计数器

bearer - 5 位承载标识，范围 0 至 31

direction - 方向位，只能为 0 或 1

bitLength - 需要的有效位数

Returns:

字对齐的小写十六进制密钥流

See Also:

• ZUC.eea3(String, int, int, int, int)

eea3Encrypt

public static byte[] eea3Encrypt(String keyHex,
 int count,
 int bearer,
 int direction,
 byte[] message,
 int bitLength)

按指定有效位数执行 3GPP EEA3 加密。

Parameters:

keyHex - 32 个十六进制字符的密钥

count - 32 位计数器

bearer - 5 位承载标识，范围 0 至 31

direction - 方向位，只能为 0 或 1

message - 消息字节

bitLength - 有效消息位数，不能超过消息字节数乘 8

Returns:

与有效位数对应的密文字节，末字节未使用位清零

See Also:

• ZUC.eea3Encrypt(String, int, int, int, byte[], int)

eea3Encrypt

public static byte[] eea3Encrypt(String keyHex,
 int count,
 int bearer,
 int direction,
 byte[] message)

按完整消息字节长度执行 EEA3 加密。

Parameters:

keyHex - 32 个十六进制字符的密钥

count - 32 位计数器

bearer - 5 位承载标识，范围 0 至 31

direction - 方向位，只能为 0 或 1

message - 消息字节

Returns:

与输入等长的密文字节

See Also:

• ZUC.eea3Encrypt(String, int, int, int, byte[])

eia3

public static String eia3(String keyHex,
 int count,
 int bearer,
 int direction,
 byte[] message)

计算完整消息的 EIA3 兼容 MAC。

Parameters:

keyHex - 32 个十六进制字符的密钥

count - 32 位计数器

bearer - 5 位承载标识，范围 0 至 31

direction - 方向位，只能为 0 或 1

message - 消息字节

Returns:

8 个十六进制字符的 MAC

See Also:

• ZUC.eia3(String, int, int, int, byte[])

eia3

public static String eia3(String keyHex,
 int count,
 int bearer,
 int direction,
 byte[] message,
 int bitLength)

按指定有效位数计算标准 EIA3 MAC。

Parameters:

keyHex - 32 个十六进制字符的密钥

count - 32 位计数器

bearer - 5 位承载标识，范围 0 至 31

direction - 方向位，只能为 0 或 1

message - 消息字节

bitLength - 有效消息位数，不能超过消息字节数乘 8

Returns:

8 个十六进制字符的 MAC

See Also:

• ZUC.eia3(String, int, int, int, byte[], int)

eia3

public static String eia3(String keyHex,
 int count,
 int bearer,
 int direction,
 String message)

按 UTF-8 文本计算完整消息的 EIA3 兼容 MAC。

Parameters:

keyHex - 32 个十六进制字符的密钥

count - 32 位计数器

bearer - 5 位承载标识，范围 0 至 31

direction - 方向位，只能为 0 或 1

message - UTF-8 消息文本

Returns:

8 个十六进制字符的 MAC

See Also:

• ZUC.eia3(String, int, int, int, String)