cn.hutool.crypto.symmetric.fpe

Class FPE

java.lang.Object

cn.hutool.crypto.symmetric.fpe.FPE

All Implemented Interfaces:

Serializable

public class FPE
extends Object
implements Serializable

FPE(Format Preserving Encryption)实现，支持FF1和FF3-1模式。
相关介绍见：https://anquan.baidu.com/article/193

FPE是一种格式保持与明文相同的加密方式，通常用于数据脱敏中，因为它需要保持明密文的格式相同， 例如社保号经过加密之后并不是固定长度的杂文，而是相同格式、打乱的号码，依然是社保号的格式。

FPE算法可以保证：

• 数据长度不变。加密前长度是N，加密后长度仍然是N
• 数据类型不变，加密前是数字类型，加密后仍然是数字类型
• 加密过程可逆，加密后的数据可以通过密钥解密还原原始数据

此类基于BouncyCastle实现。

Since:

5.7.12

Author:

looly

See Also:

Serialized Form

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	FPE.FPEMode FPE模式 FPE包括两种模式：FF1和FF3（FF2弃用），核心均为Feistel网络结构。

Constructor Summary

Constructors

Constructor and Description
FPE(FPE.FPEMode mode, byte[] key, org.bouncycastle.crypto.AlphabetMapper mapper) 构造，使用空的Tweak
FPE(FPE.FPEMode mode, byte[] key, org.bouncycastle.crypto.AlphabetMapper mapper, byte[] tweak) 构造

Method Summary

Modifier and Type	Method and Description
char[]	decrypt(char[] data) 加密
String	decrypt(String data) 解密
char[]	encrypt(char[] data) 加密
String	encrypt(String data) 加密

Methods inherited from class java.lang.Object

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

Constructor Detail

FPE

public FPE(FPE.FPEMode mode,
           byte[] key,
           org.bouncycastle.crypto.AlphabetMapper mapper)

构造，使用空的Tweak

Parameters:

mode - FPE模式枚举，可选FF1或FF3-1

key - 密钥，null表示随机密钥，长度必须是16bit、24bit或32bit

mapper - Alphabet字典映射，被加密的字符范围和这个映射必须一致，例如手机号、银行卡号等字段可以采用数字字母字典表

FPE

public FPE(FPE.FPEMode mode,
           byte[] key,
           org.bouncycastle.crypto.AlphabetMapper mapper,
           byte[] tweak)

构造

Parameters:

mode - FPE模式枚举，可选FF1或FF3-1

key - 密钥，null表示随机密钥，长度必须是16bit、24bit或32bit

mapper - Alphabet字典映射，被加密的字符范围和这个映射必须一致，例如手机号、银行卡号等字段可以采用数字字母字典表

tweak - Tweak是为了解决因局部加密而导致结果冲突问题，通常情况下将数据的不可变部分作为Tweak，null使用默认长度全是0的bytes

Method Detail

encrypt

public String encrypt(String data)

加密

Parameters:

data - 数据，数据必须在构造传入的AlphabetMapper中定义的范围

Returns:

密文结果

encrypt

public char[] encrypt(char[] data)

加密

Parameters:

data - 数据，数据必须在构造传入的AlphabetMapper中定义的范围

Returns:

密文结果

decrypt

public String decrypt(String data)

解密

Parameters:

data - 密文数据，数据必须在构造传入的AlphabetMapper中定义的范围

Returns:

明文结果

decrypt

public char[] decrypt(char[] data)

加密

Parameters:

data - 密文数据，数据必须在构造传入的AlphabetMapper中定义的范围

Returns:

明文结果