Java基于logback?MessageConverter實(shí)現(xiàn)日志脫敏方案分析
背景簡(jiǎn)介
日志脫敏 是常見(jiàn)的安全需求,最近公司也需要將這一塊內(nèi)容進(jìn)行推進(jìn)。看了一圈網(wǎng)上的案例,很少有既輕量又好用的輪子可以讓我直接使用。我一直是反對(duì)過(guò)度設(shè)計(jì)的,而同樣我認(rèn)為輪子就應(yīng)該是可以讓人拿去直接用的。所以我準(zhǔn)備分享兩篇博客分別實(shí)現(xiàn)兩種日志脫敏方案。
方案分析
- logback MessageConverter + 正則匹配本篇博客主要介紹此方法
- 優(yōu)勢(shì)
- 侵入性低、工作量極少, 只需要修改xml配置文件,適合老項(xiàng)目
- 劣勢(shì)
- 效率低,會(huì)對(duì)每一行日志都進(jìn)行正則匹配檢查,效率受日志長(zhǎng)度影響,日志越長(zhǎng)效率越低,影響日志吞吐量
- 因基于正則匹配 存在錯(cuò)殺風(fēng)險(xiǎn),部分內(nèi)容難以準(zhǔn)確識(shí)別
- 劣勢(shì)
- 侵入性低、工作量極少, 只需要修改xml配置文件,適合老項(xiàng)目
- 優(yōu)勢(shì)
- fastjson Filter + 注解 + 工具類下一篇博客介紹
- 優(yōu)勢(shì)
- 性能損耗低、效率高、擴(kuò)展性強(qiáng),精準(zhǔn)脫敏,適合QPS較高日志吞吐量較大的項(xiàng)目。
- 劣勢(shì)
- 侵入性較高,需對(duì)所有可能的情況進(jìn)行脫敏判斷
- 存在漏殺風(fēng)險(xiǎn),全靠開(kāi)發(fā)控制
- 優(yōu)勢(shì)
其實(shí)還有一種方案,基于 工具類+配置模式
優(yōu)勢(shì)是 工作量低(比注解模式低,比正則匹配模式高),靈活度高,性能也好。但是只適合那些新項(xiàng)目,如果是老項(xiàng)目大家命名不規(guī)范,就很難推動(dòng)整改了。此處不進(jìn)行擴(kuò)展。詳見(jiàn):項(xiàng)目日志脫敏
logback MessageConverter + 正則匹配
流程圖解

代碼案例
正則匹配日志脫敏工具類
此工具類主要用于實(shí)現(xiàn)依據(jù)配置的正則匹配規(guī)則集,進(jìn)行依次匹配。并提取敏感文本對(duì)其執(zhí)行對(duì)應(yīng)的脫敏策略。大家拿去用可以不做修改
package com.zhibo.log.format;
import org.apache.commons.lang3.StringUtils;
import org.springframework.stereotype.Component;
import java.util.List;
import java.util.Map;
import java.util.regex.Matcher;
import java.util.regex.Pattern;
/**
* @Author: Zhibo.lv
* @Description: 正則匹配日志脫敏工具類
**/
@Component
public class LogSensitiveUtils {
// 脫敏日志最大長(zhǎng)度,超出此長(zhǎng)度的日志放棄脫敏,直接返回
private static Integer SENSITIVE_LOG_MAX_LENGTH = 10000;
/**
* 日志脫敏 獲取規(guī)則集進(jìn)行依次匹配
* @param content 明文日志文本
* @return 脫敏后的日志文本
*/
public static String filterSensitive(String content) {
try {
if (StringUtils.isNotBlank(content) && content.length() < SENSITIVE_LOG_MAX_LENGTH) {
for (Map.Entry<String, List<Pattern>> entry : LogSensitiveConstants.SENSITIVE_SEQUENCE.entrySet()) {
content = filter(content, entry.getKey(), entry.getValue());
}
}
return content;
} catch (Exception e) {
return content;
}
}
/**
*
* @param content 需脫敏字符串
* @param type 文本類型,依據(jù)類型可以做不同的脫敏方式
* @param patterns 該方式下需匹配的正則
* @return
*
*/
public static String filter(String content, String type, List<Pattern> patterns) {
for (Pattern pattern : patterns) {
Matcher matcher = pattern.matcher(content);
StringBuffer sb = new StringBuffer();
while (matcher.find()) {
matcher.appendReplacement(sb, Matcher.quoteReplacement(baseSensitive(matcher.group(), type)));
}
matcher.appendTail(sb);
content = sb.toString();
}
return content;
}
/**
* 依據(jù)正則抓去的文本執(zhí)行對(duì)應(yīng)的脫敏策略
* @param str 待脫敏的字符串
* @return
*/
private static String baseSensitive(String str, String type) {
if (StringUtils.isBlank(str)) {
return StringUtils.EMPTY;
}
//通過(guò)工廠獲取對(duì)應(yīng)類型的脫敏類執(zhí)行脫敏方法
return SensitiveStrategyBuiltInUtil.getStrategy(type).des(str);
}
}正則匹配日志脫敏常量
此工具類主要是進(jìn)行配置需要脫敏的文本的正則。需要大家依據(jù)業(yè)務(wù)調(diào)整或新增
package com.zhibo.log.format;
import java.util.ArrayList;
import java.util.List;
import java.util.Map;
import java.util.TreeMap;
import java.util.regex.Pattern;
/**
* @Author: Zhibo
* @Description: 正則匹配日志脫敏常量
**/
public class LogSensitiveConstants {
/**
* 過(guò)濾先后順序:身份證 -> 手機(jī)號(hào)
* 順序原因:避免部分業(yè)務(wù)需求出現(xiàn)可能同時(shí)滿足多個(gè)正則規(guī)則的文本,大家可以優(yōu)先提取更長(zhǎng)的、更復(fù)雜的文本。后處理簡(jiǎn)單的
*/
public static final Map<String,List<Pattern>> SENSITIVE_SEQUENCE = new TreeMap<String, List<Pattern>>();
/**
* 手機(jī)號(hào)匹配規(guī)則集,支持配置多個(gè)正則規(guī)則
*/
public static final List<Pattern> SENSITIVE_PHONE_KEY = new ArrayList<Pattern>(1);
/**
* 身份證號(hào)碼匹配規(guī)則集,支持配置多個(gè)正則規(guī)則
*/
public static final List<Pattern> SENSITIVE_ID_NO_KEY = new ArrayList<Pattern>(1);
/**
* 手機(jī)號(hào)正則匹配,11位1開(kāi)頭數(shù)字
* 瞻前顧后:校驗(yàn)符合要求的文本前后均不能為數(shù)字 避免誤匹配
*/
public static final String PHONE_REGEX = "(?<!\\d)[1][3-9][0-9]{9}(?!\\d)";
/**
* 身份證號(hào)正則匹配 18位數(shù)版本
* 15位數(shù)的身份證號(hào)碼暫不考慮,如果需要自行新增下方正則加入 SENSITIVE_ID_NO_KEY 中
* (?<!\d)([1-9]\d{7}((0\d)|(1[0-2]))(([0|1|2]\d)|3[0-1])\d{3})(?!\d)
* 瞻前顧后:校驗(yàn)符合要求的文本前后均不能為數(shù)字 避免誤匹配
*/
public static final String ID_NO_REGEX = "(?<!\\d)([1-9]\\d{5}[1-9]\\d{3}((0\\d)|(1[0-2]))(([0|1|2]\\d)|3[0-1])\\d{3}([0-9]|X))(?!\\d)";
static {
SENSITIVE_ID_NO_KEY.add(Pattern.compile(ID_NO_REGEX));
SENSITIVE_PHONE_KEY.add(Pattern.compile(PHONE_REGEX));
}
// 脫敏替代字符
public static final char STAR = '*';
// 手機(jī)號(hào)類型脫敏替代字符
public static final String PHONE_MASK = "****";
/** 手機(jī)號(hào)碼脫敏策略 */
public static final String STRATEGY_PHONE = "strategyPhone";
/** 身份證號(hào)碼脫敏策略 */
public static final String STRATEGY_ID_NO = "strategyIdNo";
static {
//將每一個(gè)規(guī)則集綁定一個(gè)對(duì)應(yīng)的類型
SENSITIVE_SEQUENCE.put(STRATEGY_ID_NO, SENSITIVE_ID_NO_KEY);
SENSITIVE_SEQUENCE.put(STRATEGY_PHONE, SENSITIVE_PHONE_KEY);
}
private LogSensitiveConstants() {
}
}脫敏策略代碼
定義文本脫敏接口 IStrategy
package com.zhibo.log.sensitive.api;
/**
* @Author: Zhibo
* @Description: 脫敏策略
*/
public interface IStrategy {
/**
* 脫敏
* @param original 原始內(nèi)容
* @return 脫敏后的字符串
*/
String des(final Object original);
}文本脫敏抽象類,進(jìn)行通用實(shí)現(xiàn) AbstractStringStrategy
package com.zhibo.log.sensitive.core.strategory;
import com.zhibo.log.sensitive.api.IStrategy;
import com.zhibo.log.format.LogSensitiveConstants;
import java.security.MessageDigest;
/**
* @Author: zhibo
* @Description: 抽象字符串策略,
* 支持在脫敏后的文本后面追加明文的MD5加密串,方便研發(fā)進(jìn)行日志查詢使用
*/
public abstract class AbstractStringStrategy implements IStrategy {
/**
* 獲取掩碼之前的長(zhǎng)度
* @param original 原始
* @param chars 字符串
* @return 結(jié)果
*/
protected abstract int getBeforeMaskLen(Object original, char[] chars);
/**
* 獲取掩碼之后的長(zhǎng)度
* @param original 原始
* @param chars 字符串
* @return 結(jié)果
*/
protected abstract int getAfterMaskLen(Object original, char[] chars);
/**
* 針對(duì)固定長(zhǎng)度的加密直接返回脫敏字符串,避免StringBuilder循環(huán)拼接
* @return 脫敏字符串
* 如返回null 則通過(guò) {@link AbstractStringStrategy#getBeforeMaskLen(Object, char[])} 與 {@link AbstractStringStrategy#getAfterMaskLen(Object, char[])}
* 進(jìn)行截取字符串
*/
protected String getMask(){
return null;
}
/**
* 是否需要拼接MD5密文方便日志查詢。
* @return false : 不拼接(默認(rèn))
* true : 拼接密文 用于日志查詢 格式 [MD5]
*/
protected Boolean addMD5(){
return false;
}
@Override
public String des(Object original) {
if(original == null) {
return null;
}
String strValue = original.toString();
char[] chars = strValue.toCharArray();
int beforeMaskLen = getBeforeMaskLen(original, chars);
int afterMaskLen = getAfterMaskLen(original, chars);
//范圍糾正
int maxLen = chars.length;
beforeMaskLen = Math.min(beforeMaskLen, maxLen);
afterMaskLen = Math.min(afterMaskLen, maxLen);
StringBuilder stringBuilder = new StringBuilder();
//獲取明文前綴
if(beforeMaskLen > 0) {
stringBuilder.append(chars, 0, beforeMaskLen);
}
//獲取脫敏字符串
String mask = getMask();
if (null == mask){//如未指定脫敏字符串則按規(guī)則循環(huán)拼接
// 中間使用掩碼
for(int i = beforeMaskLen; i < chars.length - afterMaskLen; i++) {
stringBuilder.append(LogSensitiveConstants.STAR);
}
}else {
stringBuilder.append(mask);
}
//獲取明文后綴
if(afterMaskLen > 0) {
stringBuilder.append(chars, chars.length - afterMaskLen, afterMaskLen);
}
if (addMD5()){
addMD5(strValue,stringBuilder);
}
return stringBuilder.toString();
}
// MD5加密
private void addMD5(String originalString,StringBuilder stringBuilder) {
try {
MessageDigest md = MessageDigest.getInstance("MD5");
md.update(originalString.getBytes());
byte[] digest = md.digest();
stringBuilder.append("[");
for (byte b : digest) {
stringBuilder.append(String.format("%02x", b));
}
stringBuilder.append("]");
} catch (Exception e) {
e.printStackTrace();
}
}
}身份證脫敏策略實(shí)現(xiàn) StrategyIdNo
package com.zhibo.log.sensitive.core.strategory;
/**
* @Author: Zhibo
* @Description: 身份證號(hào)脫敏
* 脫敏規(guī)則:保留前6 后4 位,其它由星號(hào)替換
*/
public class StrategyIdNo extends AbstractStringStrategy {
@Override
protected int getBeforeMaskLen(Object original, char[] chars) {
return 6;
}
@Override
protected int getAfterMaskLen(Object original, char[] chars) {
return 4;
}
}手機(jī)號(hào)碼脫敏策略實(shí)現(xiàn) StrategyPhone
package com.zhibo.log.sensitive.core.strategory;
import com.zhibo.log.format.LogSensitiveConstants;
/**
* @Author: zhibo
* @Description: 手機(jī)號(hào)脫敏
* 脫敏規(guī)則:186****8567[MD5]
*/
public class StrategyPhone extends AbstractStringStrategy {
@Override
protected int getBeforeMaskLen(Object original, char[] chars) {
return 3;
}
@Override
protected int getAfterMaskLen(Object original, char[] chars) {
return 4;
}
@Override
protected String getMask() {
return LogSensitiveConstants.PHONE_MASK;
}
@Override
protected Boolean addMD5(){
return true;
}
}logback 消息轉(zhuǎn)換器實(shí)現(xiàn)
最關(guān)鍵的方法來(lái)啦
package com.zhibo.log.format;
import ch.qos.logback.classic.pattern.MessageConverter;
import ch.qos.logback.classic.spi.ILoggingEvent;
/**
* @Author: Zhibo
* @Description: 日志脫敏轉(zhuǎn)換器
**/
public class SensitiveConverter extends MessageConverter {
@Override
public String convert(ILoggingEvent event){
// 獲取原始日志
String requestLogMsg = super.convert(event);
// 執(zhí)行日志脫敏
return LogSensitiveUtils.filterSensitive(requestLogMsg);
}
public SensitiveConverter() {
}
}自此我們的工具包也就完成了,業(yè)務(wù)系統(tǒng)需要使用此工具只需要修改resources目錄下的logback.xml配置。
<!-- 新增或修改原有消息轉(zhuǎn)換器為SensitiveConverter --> <conversionRule conversionWord="msgToo" converterClass="com.zhibo.log.format.SensitiveConverter" />
并將文件輸出日志的消息內(nèi)容替換為指定消息轉(zhuǎn)換器的 conversionWord

脫敏效果展示

有請(qǐng)?zhí)崾?/h3>
注:此方法對(duì)日志吞吐量存在影響,由于正則需要循環(huán)匹配整個(gè)日志文本,所以正則規(guī)則越多,日志文本越長(zhǎng),耗時(shí)越長(zhǎng)。如您的應(yīng)用程序?qū)θ罩就掏铝恳筝^高且存在大量超長(zhǎng)日志文本請(qǐng)壓測(cè)后使用。
如配置了logback的異步打印,且設(shè)置了允許日志丟棄,在壓測(cè)中可能出現(xiàn)因線程池與等待隊(duì)列均被占滿而導(dǎo)致日志丟失情況。下面是我的問(wèn)題復(fù)盤(pán):
logback日志異步打印配置如下
<appender name="ASYNC-FILE" class="ch.qos.logback.classic.AsyncAppender"> <neverBlock>true</neverBlock><!-- 非阻塞方式運(yùn)行 如隊(duì)列滿就開(kāi)始丟棄日志 --> <queueSize>1024</queueSize><!-- 等待隊(duì)列大小 --> <discardingThreshold>0</discardingThreshold><!-- 日志隊(duì)列深度,配置0 隊(duì)列滿后丟棄最老的日志 --> <appender-ref ref="FILE"/> </appender>
以上配置 為logback線程池工作配置,默認(rèn)線程池 線程數(shù)為 10個(gè),最大隊(duì)列長(zhǎng)度為1024個(gè)。
意味著如果日志產(chǎn)生的速度超過(guò)10個(gè)線程工作處理日志的速度,則無(wú)法處理的日志會(huì)被寫(xiě)入BlockingQueue 隊(duì)列,當(dāng)隊(duì)列滿了之后就會(huì)導(dǎo)致日志丟失的情況。
到此這篇關(guān)于Java基于logback MessageConverter實(shí)現(xiàn)日志脫敏的文章就介紹到這了,更多相關(guān)java logback MessageConverter日志脫敏內(nèi)容請(qǐng)搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家!
- idea項(xiàng)目啟動(dòng)報(bào)錯(cuò),日志包沖突slf4j和logback沖突問(wèn)題
- SpringBoot整合日志功能(slf4j+logback)詳解(最新推薦)
- springboot項(xiàng)目配置logback-spring.xml實(shí)現(xiàn)按日期歸檔日志的方法
- SpringBoot3配置Logback日志滾動(dòng)文件的方法
- 如何為?Spring?Boot?項(xiàng)目配置?Logback?日志
- 解決logback使用${spring.application.name}日志打印路徑的問(wèn)題
- 如何為L(zhǎng)ogback日志添加唯一追蹤ID
相關(guān)文章
nacos在mac上部署提示找不到或無(wú)法加載主類的解決
這篇文章主要介紹了nacos在mac上部署提示找不到或無(wú)法加載主類的解決,具有很好的參考價(jià)值,希望對(duì)大家有所幫助,如有錯(cuò)誤或未考慮完全的地方,望不吝賜教2024-06-06
SpringBoot加載多個(gè)配置文件實(shí)現(xiàn)dev、product多環(huán)境切換的方法
這篇文章主要介紹了SpringBoot加載多個(gè)配置文件實(shí)現(xiàn)dev、product多環(huán)境切換,本文給大家介紹的非常詳細(xì),對(duì)大家的學(xué)習(xí)或工作具有一定的參考借鑒價(jià)值,需要的朋友可以參考下2023-03-03
如何使用 Shell 腳本查看多個(gè)服務(wù)器的端口是否打開(kāi)的方法
這篇文章主要介紹了如何使用 Shell 腳本來(lái)查看多個(gè)服務(wù)器的端口是否打開(kāi)的方法,本文通過(guò)實(shí)例代碼給大家介紹的非常詳細(xì),對(duì)大家的學(xué)習(xí)或工作具有一定的參考借鑒價(jià)值,需要的朋友可以參考下2020-06-06
Springboot線程池并發(fā)處理數(shù)據(jù)優(yōu)化方式
這篇文章主要介紹了Springboot線程池并發(fā)處理數(shù)據(jù)優(yōu)化方式,具有很好的參考價(jià)值,希望對(duì)大家有所幫助。如有錯(cuò)誤或未考慮完全的地方,望不吝賜教2021-12-12
java 實(shí)現(xiàn)截取字符串并按字節(jié)分別輸出實(shí)例代碼
這篇文章主要介紹了java 實(shí)現(xiàn)截取字符串并按字節(jié)分別輸出實(shí)例代碼的相關(guān)資料,需要的朋友可以參考下2017-03-03

