摘要：項(xiàng)目介紹日志脫敏是常見(jiàn)的安全需求。特性基于注解的日志脫敏可以自定義策略實(shí)現(xiàn)，策略生效條件常見(jiàn)的脫敏內(nèi)置方案深拷貝，且原始對(duì)象不用實(shí)現(xiàn)任何接口。放在集合屬性上，且屬性為普通對(duì)象作為演示，集合中為普通的字符串。

日志脫敏是常見(jiàn)的安全需求。普通的基于工具類(lèi)方法的方式，對(duì)代碼的入侵性太強(qiáng)。編寫(xiě)起來(lái)又特別麻煩。

本項(xiàng)目提供基于注解的方式，并且內(nèi)置了常見(jiàn)的脫敏方式，便于開(kāi)發(fā)。

用戶也可以基于自己的實(shí)際需要，自定義注解。

基于注解的日志脫敏

可以自定義策略實(shí)現(xiàn)，策略生效條件

常見(jiàn)的脫敏內(nèi)置方案

java 深拷貝，且原始對(duì)象不用實(shí)現(xiàn)任何接口。

    com.github.houbb
    sensitive-core
    0.0.2

User.java

我們對(duì) password 使用脫敏，指定脫敏策略為 StrategyPassword。(直接返回 null)

public class User {

    @Sensitive(strategy = StrategyChineseName.class)
    private String username;
    
    @Sensitive(strategy = StrategyCardId.class)
    private String idCard;
    
    @Sensitive(strategy = StrategyPassword.class)
    private String password;
    
    @Sensitive(strategy = StrategyEmail.class)
    private String email;
    
    @Sensitive(strategy = StrategyPhone.class)
    private String phone;
    
    //Getter & Setter
    //toString()
}

如果某個(gè)屬性是單個(gè)集合或者對(duì)象，則需要使用注解 @SensitiveEntry。

放在集合屬性上，且屬性為普通對(duì)象

會(huì)遍歷每一個(gè)屬性，執(zhí)行上面的脫敏策略。

放在對(duì)象屬性上

會(huì)處理對(duì)象中各個(gè)字段上的脫敏注解信息。

放在集合屬性上，且屬性為對(duì)象

遍歷每一個(gè)對(duì)象，處理對(duì)象中各個(gè)字段上的脫敏注解信息。

UserEntryBaseType.java

作為演示，集合中為普通的字符串。

public class UserEntryBaseType {

    @SensitiveEntry
    @Sensitive(strategy = StrategyChineseName.class)
    private List chineseNameList;

    @SensitiveEntry
    @Sensitive(strategy = StrategyChineseName.class)
    private String[] chineseNameArray;
    
    //Getter & Setter & toString()
}

構(gòu)建對(duì)象

/**
 * 構(gòu)建用戶-屬性為列表，列表中為基礎(chǔ)屬性
 * @return 構(gòu)建嵌套信息
 * @since 0.0.2
 */
public static UserEntryBaseType buildUserEntryBaseType() {
    UserEntryBaseType userEntryBaseType = new UserEntryBaseType();
    userEntryBaseType.setChineseNameList(Arrays.asList("盤(pán)古", "女?huà)z", "伏羲"));
    userEntryBaseType.setChineseNameArray(new String[]{"盤(pán)古", "女?huà)z", "伏羲"});
    return userEntryBaseType;
}

測(cè)試演示

/**
 * 用戶屬性中有集合或者map，集合中屬性是基礎(chǔ)類(lèi)型-脫敏測(cè)試
 * @since 0.0.2
 */
@Test
public void sensitiveEntryBaseTypeTest() {
    UserEntryBaseType userEntryBaseType = DataPrepareTest.buildUserEntryBaseType();
    System.out.println("脫敏前原始： " + userEntryBaseType);
    UserEntryBaseType sensitive = SensitiveUtil.desCopy(userEntryBaseType);
    System.out.println("脫敏對(duì)象： " + sensitive);
    System.out.println("脫敏后原始： " + userEntryBaseType);
}

日志信息

脫敏前原始： UserEntryBaseType{chineseNameList=[盤(pán)古, 女?huà)z, 伏羲], chineseNameArray=[盤(pán)古, 女?huà)z, 伏羲]}
脫敏對(duì)象： UserEntryBaseType{chineseNameList=[*古, *媧, *羲], chineseNameArray=[*古, *媧, *羲]}
脫敏后原始： UserEntryBaseType{chineseNameList=[盤(pán)古, 女?huà)z, 伏羲], chineseNameArray=[盤(pán)古, 女?huà)z, 伏羲]}

演示對(duì)象

這里的 User 和上面的 User 對(duì)象一致。

public class UserEntryObject {

    @SensitiveEntry
    private User user;

    @SensitiveEntry
    private List userList;

    @SensitiveEntry
    private User[] userArray;
    
    //...
}

對(duì)象構(gòu)建

/**
 * 構(gòu)建用戶-屬性為列表，數(shù)組。列表中為對(duì)象。
 * @return 構(gòu)建嵌套信息
 * @since 0.0.2
 */
public static UserEntryObject buildUserEntryObject() {
    UserEntryObject userEntryObject = new UserEntryObject();
    User user = buildUser();
    User user2 = buildUser();
    User user3 = buildUser();
    userEntryObject.setUser(user);
    userEntryObject.setUserList(Arrays.asList(user2));
    userEntryObject.setUserArray(new User[]{user3});
    return userEntryObject;
}

測(cè)試演示

/**
 * 用戶屬性中有集合或者對(duì)象，集合中屬性是對(duì)象-脫敏測(cè)試
 * @since 0.0.2
 */
@Test
public void sensitiveEntryObjectTest() {
    UserEntryObject userEntryObject = DataPrepareTest.buildUserEntryObject();
    System.out.println("脫敏前原始： " + userEntryObject);
    UserEntryObject sensitiveUserEntryObject = SensitiveUtil.desCopy(userEntryObject);
    System.out.println("脫敏對(duì)象： " + sensitiveUserEntryObject);
    System.out.println("脫敏后原始： " + userEntryObject);
}

測(cè)試結(jié)果

脫敏前原始： UserEntryObject{user=User{username="脫敏君", idCard="123456190001011234", password="1234567", email="[email protected]", phone="18888888888"}, userList=[User{username="脫敏君", idCard="123456190001011234", password="1234567", email="[email protected]", phone="18888888888"}], userArray=[User{username="脫敏君", idCard="123456190001011234", password="1234567", email="[email protected]", phone="18888888888"}]}
脫敏對(duì)象： UserEntryObject{user=User{username="脫*君", idCard="123456**********34", password="null", email="123**@qq.com", phone="188****8888"}, userList=[User{username="脫*君", idCard="123456**********34", password="null", email="123**@qq.com", phone="188****8888"}], userArray=[User{username="脫*君", idCard="123456**********34", password="null", email="123**@qq.com", phone="188****8888"}]}
脫敏后原始： UserEntryObject{user=User{username="脫敏君", idCard="123456190001011234", password="1234567", email="[email protected]", phone="18888888888"}, userList=[User{username="脫敏君", idCard="123456190001011234", password="1234567", email="[email protected]", phone="18888888888"}], userArray=[User{username="脫敏君", idCard="123456190001011234", password="1234567", email="[email protected]", phone="18888888888"}]}

issues

如果你對(duì)本項(xiàng)目有興趣，并且對(duì)代碼有一定追求，可以申請(qǐng)加入本項(xiàng)目開(kāi)發(fā)。

如果你善于寫(xiě)文檔，或者愿意補(bǔ)全測(cè)試案例，也非常歡迎加入。