摘要
日志是后端系统的 “黑匣子”,故障排查、业务对账、攻击溯源、SRC 漏洞取证、红蓝对抗溯源全都依赖日志。几乎所有开发团队都会接入日志框架:Logback、Log4j2、SLF4J,配合 ELK、Loki、阿里云 SLS、腾讯云 CLS 等日志平台存储日志。但绝大多数团队在日志开发上只追求 “能打印、能查到”,完全忽略日志本身就是一个巨大的敏感信息泄露面。
在代码审计和 SRC 漏洞评审过程中,日志泄露敏感信息属于高频低危~中危漏洞,很多开发者觉得 “只是打个日志而已,问题不大”。但大量真实事件证明:日志库一旦被越权访问、配置泄露、弱口令入侵、内部人员违规导出,日志里明文存放的手机号、身份证号、银行卡、会话 Token、Cookie、用户密码、接口入参、密钥等敏感数据会批量外泄,造成大规模个人信息泄露,触发《个人信息保护法》,带来高额处罚。
很多踩坑场景十分常见:直接打印接口全量入参、复制 DTO 对象直接打印、异常堆栈打印原始请求报文、调试日志忘记注释上线、第三方回调日志原样输出、错误日志打印解密后的明文数据、脱敏规则只做前端不做后端、日志脱敏漏字段、日志持久化之后无法回溯清理。
本文面向后端开发、安全开发、测试工程师、SDL 负责人,从日志安全风险根源、日志分级规范、敏感信息清单、脱敏算法选型、代码实战、框架拦截方案、日志存储传输安全、日志审计、SDL 落地、大量真实踩坑案例、漏洞修复方案完整讲解。同时区分业务日志、安全审计日志、调试日志三者边界,告诉你哪些日志必须留、哪些日志禁止打印、脱敏到底该怎么写,避免出现 “脱敏形同虚设” 或者 “脱敏过度导致排查故障困难” 两个极端。
免责声明:本文内容仅用于企业安全开发学习、代码评审、SDL 规范落地;文中脱敏代码、日志拦截方案仅用于内部业务加固,禁止用于未授权的系统探测、数据窃取。日志泄露敏感信息属于违规风险,生产环境务必严格按照规范执行。
前言
日志安全,在很多团队里面属于安全里的 “边角料”。比起 SQL 注入、越权、命令执行这类高危漏洞,日志泄露常常被轻视。很多 SRC 提交日志明文泄露手机号、身份证,厂商评级大多给到低危,于是很多开发和安全人员产生错觉:日志泄露危害很小,不用重点治理。
这个认知是非常片面的。
漏洞评级高低,不等于风险大小。日志泄露属于批量泄露类漏洞,单条日志里一条手机号危害有限,但日志平台存储着几个月、几年全量用户请求数据,一旦日志平台被拿下,就是批量个人信息泄露,量级可以达到几十万、上百万条。同时,日志里经常会藏着 Token、Cookie、签名密钥、解密明文,拿到日志可以直接接管用户账号、绕过鉴权。
我整理了审计中经常遇到的真实日志泄露场景:
场景 1:统一全局拦截器,打印接口请求参数、响应参数,直接把整个 JSON 入参打印,DTO 里面手机号、身份证、银行卡全部明文输出;
场景 2:开发本地调试,打印用户密码、短信验证码,上线忘记注释,调试日志永久落盘;
场景 3:捕获异常的时候,直接打印 log.error("请求失败,参数:{}", obj),异常堆栈连带完整明文报文一起输出;
场景 4:日志只在控制台脱敏,采集到日志平台的原始数据没有脱敏;
场景 5:脱敏代码只处理正常流程,异常分支、异步回调、MQ 消息日志漏掉脱敏;
场景 6:把解密之后的明文数据打印日志,AES 解密后的用户信息直接输出;
场景 7:日志保存周期无限长,几年前的敏感数据一直存储,没有过期自动清理;
场景 8:日志存储没有权限隔离,运维、测试人员全员可读全量日志;
场景 9:使用字符串替换简单脱敏,很容易被绕过,比如 138****1234 这种简单掩码,结合其他数据可以还原用户;
场景 10:安全审计日志缺失,攻击发生之后没有日志可以溯源;或者审计日志里面缺少关键字段,溯源失效。
日志安全分为两大方向:
第一:防止日志成为敏感信息泄露通道,也就是日志脱敏、禁止打印敏感字段;
第二:日志本身具备安全审计能力,也就是安全日志规范,发生入侵、越权、异常操作的时候,有完整日志用于溯源。
很多团队只看到第一点,忽略第二点:一味禁止打印信息,最后系统出问题,没有任何日志可以排查、溯源,走向另一个极端。好的日志规范,是一个平衡艺术:保留排查和溯源需要的必要字段,抹除不必要的敏感明文,做到可用,但是不可滥用。
本文结构安排:
- 日志安全基础认知:日志分类、风险来源、合规要求;
- 敏感信息梳理清单,区分个人信息、鉴权凭证、密钥类、业务敏感字段;
- 脱敏方案选型:掩码、哈希、保留摘要、完全不打印,不同场景怎么选;
- 代码实战:Java Logback/Log4j2 脱敏,全局拦截、序列化脱敏、注解脱敏方案;
- 高频踩坑案例:各种脱敏失效场景,错误代码和修复代码对比;
- 日志传输、存储、访问权限、留存周期安全规范;
- 安全审计日志规范:哪些操作必须留审计日志,审计日志字段标准;
- SAST 扫描规则、代码评审检查清单;
- SDL 落地流程、日常运营方案。
一、日志安全基础认知:日志类型、风险面、合规要求
1.1 日志三大分类,安全要求完全不一样
首先把日志分成三类,很多规范混乱就是因为把三类日志混在一起处理。
1)业务运行日志(普通业务日志)
用途:排查报错、业务流程跟踪、性能问题排查。
例子:订单创建、支付回调、库存扣减、用户查询接口入参出参。
安全要求:敏感字段必须脱敏,不需要的凭证类字段直接禁止打印。允许保留非敏感业务标识,比如订单号、用户 ID(内部 ID,不是手机号)。
2)调试日志(开发 Debug 日志)
用途:本地开发、联调阶段排查问题。
例子:打印完整报文、解密明文、原始密码、完整 Cookie。
安全红线:调试日志禁止在生产环境开启。很多框架默认 debug 级别关闭,但开发手动写死 log.info 打印调试内容,不会随着环境关闭,这是最常见的泄露源头。
生产环境原则:debug 级别日志关闭;所有调试用的敏感打印代码上线前删除或者用环境开关控制。
3)安全审计日志(审计日志,重点)
用途:攻击溯源、违规操作审计、满足等保、个保法要求。
例子:登录、登出、密码修改、权限变更、管理员操作、敏感数据查询、接口鉴权失败、IP 异常访问。
安全要求:审计日志不能随意脱敏关键溯源字段,但是同样不能包含明文密码、验证码;审计日志需要独立存储、防篡改、不可随意删除,留存周期满足合规要求。
核心区分口诀:
业务日志:敏感数据脱敏;
Debug 日志:生产禁止输出;
审计日志:保证溯源能力,凭证类敏感信息依然禁止明文打印。
1.2 日志泄露的风险来源
日志不是只存在应用服务器本地文件。一条日志会经历:应用内存输出 → 本地日志文件 → Agent 采集(Filebeat)→ 日志中间件(Kafka)→ 日志存储平台(ELK/SLS)→ 可视化面板。整条链路每一环都可能泄露。
风险点拆解:
- 应用层:代码直接打印明文,源头就已经泄露;
- 采集层:采集器采集原始日志,脱敏只做控制台展示,采集的数据没脱敏(非常经典坑);
- 传输层:日志传输 HTTP 明文,没有 TLS 加密,中间人抓包拿到日志;
- 存储层:日志库弱口令、对外开放、内部人员权限过大;
- 访问层:日志平台没有操作审计,谁导出、谁查询日志没有记录;
- 销毁层:日志永久保存,没有自动过期删除。
很多开发以为:我在控制台看到脱敏了就安全了。实际上脱敏只是前端展示层脱敏,落到存储里面的原始日志依旧明文,这个漏洞在 SRC 里非常常见。
1.3 合规层面硬性要求
《网络安全法》《个人信息保护法》《网络安全等级保护 2.0》都对日志和个人信息存储有明确约束:
- 处理个人信息应当遵循最小必要原则,不应当收集、存储不必要的个人信息;日志打印属于 “存储个人信息” 的一种形式;
- 等保 2.0 要求:审计日志留存不少于 6 个月;审计日志需要独立存放,防止被篡改、删除;
- 个人信息不得随意明文留存,对于手机号、身份证号这类敏感个人信息,存储需要采取去标识化、脱敏措施;
- 如果发生日志批量泄露,企业需要承担主体责任,处罚对象是企业,不是写日志的开发。
很多团队等保测评的时候,日志明文泄露是高频不通过项。
二、敏感信息清单:哪些字段必须处理,哪些字段禁止打印
做日志脱敏第一步,先建立统一敏感字段字典。团队所有开发统一一份清单,避免 A 开发觉得手机号要脱敏,B 开发忘记脱敏。
我们分成 4 大类,风险等级从高到低。
2.1 极高风险:禁止打印,任何情况下都不允许出现在日志里面
这类字段,不要想着脱敏,直接不打印。哪怕掩码之后也不建议输出,最好直接过滤丢弃。
- 用户明文密码、密码哈希之外的原始口令;
- 短信验证码、邮箱验证码、动态令牌;
- 密钥、AK/SK、数据库密码、JWT 签名密钥、AES 密钥、RSA 私钥;
- 完整 Cookie、完整 Authorization 头(Bearer Token、SessionId);
- 支付密码、银行卡 CVV 安全码。
原因:验证码、密钥、Token 这类数据,掩码之后依然有很大风险;而且这类数据生命周期很短,排查故障几乎不需要打印出来。排查问题不需要看用户验证码,打印验证码纯粹是调试坏习惯。
❌ 错误:
log.info("验证码:{}", code);
✅ 正确:直接删除这行日志;如果必须记录,可以记录【验证码发送成功】,不带上验证码内容。
2.2 高风险个人信息:必须脱敏,允许保留少量片段用于定位
属于个人信息里的敏感字段,业务排查偶尔需要根据片段定位用户,允许掩码展示,禁止全明文。
- 手机号:13812345678 → 138****5678
- 身份证号:430123199901011234 → 430***********1234
- 银行卡号:6222021234567890123 → 6222*********0123
- 邮箱:test123@qq.com → te***@qq.com
- 家庭住址、收货地址:只保留省市,详细地址抹除
2.3 中风险业务字段:按需脱敏,根据业务场景判断
- 用户真实姓名:可以保留姓氏,名字脱敏,张 * 三;
- IP 地址:溯源审计日志里面 IP 必须完整保留;普通业务日志如果不需要溯源,可以做部分掩码;
- 设备 ID、IMEI:移动端业务,按需脱敏;审计日志保留完整;
- 订单实付金额:一般不需要脱敏,但是金融业务内部要求除外。
2.4 低风险 / 安全字段:可以正常打印,用于排查和溯源
这类字段放心打印,不需要脱敏,是日志排查问题的核心:
- 内部用户 ID(userId,自增数字,不是手机号)
- 订单号、流水号、请求 traceId
- 接口路径、HTTP 方法、响应状态码
- 耗时、渠道 ID、产品 ID
- 操作类型:新增、修改、查询、删除
TraceId 是分布式链路追踪核心,绝对不能脱敏。
2.5 容易遗漏的隐形敏感字段(审计高频踩坑)
很多人只看 DTO 顶层字段,忽略嵌套对象、数组、List、Map、JSON 字符串里面藏着敏感信息:
- 请求头里面:token、cookie、authorization;很多全局日志打印 header 全量 map;
- 扩展字段:ext、extra、params,前端自由传入 JSON 字符串,敏感数据藏在 json 字符串里面;
- MQ 消息体、RocketMQ/Kafka 消息直接打印;
- 第三方回调报文:微信、支付宝回调,报文里面带用户敏感信息;
- 异常堆栈里面的 cause 消息,底层组件抛出异常携带明文参数;
- 序列化工具 toString 自动输出对象所有字段(默认的 POJO toString)。
重点提醒:
Map<String,Object>是脱敏最大坑,key 不固定,很难用注解拦截,很多脱敏框架对动态 Map 支持很差。
三、脱敏方案选型:四种脱敏方式,什么时候用哪一种
很多开发以为脱敏只有 替换成* 掩码这一种方案。实际上脱敏分为 4 种方案,不同场景选型不同,选错要么不安全,要么影响排查。
方案 1:掩码脱敏(部分保留,打星号)
规则:保留前缀几位、后缀几位,中间替换为 *。
适用场景:手机号、身份证、银行卡、姓名、邮箱。
优点:可以根据片段快速定位用户,客服、排查问题好用;
缺点:属于去标识化,不是匿名化。在有其他辅助数据的情况下,依然有概率关联到真实用户,不能当做完全匿名。
掩码规则统一规范(团队统一,不要每个人写不一样):
- 手机号:前 3 + 后 4,中间 4 个*:138****5678
- 身份证号:前 6 + 后 4,中间 8 个 *:430***********1234
- 银行卡:前 4 + 后 4,中间 *
- 邮箱:@前面保留前 2 字符,后面*:te***@qq.com
方案 2:摘要哈希脱敏(不可逆,无法还原)
把敏感字段做哈希,一般使用 SHA256,可以搭配固定盐值或者不加盐。
适用场景:只需要判断相等性,不需要看原文。比如统计同一个手机号访问次数,不需要看到手机号明文。
示例:手机号做 SHA256,日志打印哈希字符串。
优点:不可逆,无法从哈希反推出手机号;
缺点:完全看不到原文片段,不能用来客服定位用户;加盐哈希注意盐值不要硬编码。
⚠️ 注意:哈希脱敏不等于加密,哈希是单向的。如果盐值泄露,彩虹表依然可以碰撞。
方案 3:直接丢弃、不打印(最优,极高风险字段首选)
适用场景:验证码、密码、token、密钥。
逻辑:检测到字段,直接不输出,日志里面这个 key 直接移除。
日志输出示例:{"code":"[已过滤]"} 或者直接把这个 key 从 json 里面删掉。
优先顺序:能不打印,就不打印;必须打印,再考虑掩码。
方案 4:替换固定占位符
比如敏感字段统一输出 [sensitive],适合通用拦截,不确定字段名称的动态 Map 场景。
缺点:信息粒度最差,只能知道这里有敏感数据,无法做任何定位。
脱敏方案选择决策表
| 字段类型 | 推荐方案 |
|---|---|
| 密码、验证码、AK/SK、token | 直接过滤,禁止打印 |
| 手机号、身份证、银行卡 | 掩码脱敏 |
| 统计类、只需要去重、不需要人工查看 | SHA256 哈希 |
| 动态未知 key、自由扩展 json | 占位符 [sensitive] |
| 审计日志 IP、traceId、订单号 | 原样输出,不脱敏 |
四、Java 实战:日志脱敏落地,几种主流实现方案对比
Java 生态最常用日志框架:Logback、Log4j2,序列化:Jackson、Fastjson2。下面介绍业内四种主流脱敏实现方案,从简单到企业级,附带优缺点、代码示例。
不推荐使用 Fastjson1,存在安全漏洞,示例统一使用 Fastjson2、Jackson。
方案 1:手动脱敏(简单项目,小系统)
拿到对象之后,打印之前手动调用脱敏工具类,把敏感字段替换。
优点:简单直观,不需要引入组件;
缺点:侵入性极强,每一处打印都要记得调用;漏一处就泄露,不适合大型项目。
脱敏工具类基础示例:
public class DesensitizeUtil {
/**
* 手机号脱敏
*/
public static String phone(String phone) {
if (phone == null || phone.length() < 7) {
return phone;
}
return phone.substring(0,3) + "****" + phone.substring(phone.length()-4);
}
/**
* 身份证脱敏
*/
public static String idCard(String idCard) {
if(idCard == null || idCard.length() < 10){
return idCard;
}
return idCard.substring(0,6) + "********" + idCard.substring(idCard.length()-4);
}
/**
* 邮箱脱敏
*/
public static String email(String email) {
if(email == null || !email.contains("@")){
return email;
}
String[] arr = email.split("@");
String prefix = arr[0];
if(prefix.length() <=2){
return email;
}
return prefix.substring(0,2)+"***@"+arr[1];
}
}
❌ 错误写法(忘记脱敏):
log.info("用户信息:{}", userDTO);
✅ 正确手动写法:
UserDTO dto = getUser();
dto.setPhone(DesensitizeUtil.phone(dto.getPhone()));
dto.setIdCard(DesensitizeUtil.idCard(dto.getIdCard()));
log.info("用户信息:{}", dto);
弊端非常明显:开发随时忘记调用,代码评审压力巨大,适合学习,不适合中大型项目。
方案 2:注解 + Jackson 序列化脱敏(最推荐,业务 DTO 标准化)
思路:自定义注解 @Desensitize,标注字段类型(手机号、身份证、密码),重写 Jackson 序列化器,序列化输出日志的时候自动脱敏。
好处:DTO 字段只需要加注解,不管在哪里打印这个对象,序列化自动脱敏,一处注解全局生效。是企业项目首选方案。
第一步:自定义注解
@Target(ElementType.FIELD)
@Retention(RetentionPolicy.RUNTIME)
public @interface Desensitize {
DesensitizeType type();
enum DesensitizeType {
PHONE, ID_CARD, BANK, EMAIL, PASSWORD, CODE
}
}
第二步:自定义 Jackson StdScalarSerializer,根据注解类型脱敏。
第三步:DTO 使用注解标记
@Data
public class UserDTO {
private Long userId;
@Desensitize(type = DesensitizeType.PHONE)
private String phone;
@Desensitize(type = DesensitizeType.ID_CARD)
private String idCard;
@Desensitize(type = DesensitizeType.PASSWORD)
private String password;
private String userName;
}
当直接打印 log.info("user:{}", userDTO),Jackson 序列化的时候自动识别注解,密码字段直接输出 [filtered],手机号掩码。
坑点:如果对象 toString 方法是自己重写的,不走 Jackson 序列化,注解脱敏失效!很多老项目 POJO 重写 toString,这是高频脱敏失效点。
审计重点:检查 POJO 是否存在自定义 toString,自定义 toString 不会触发 Jackson 序列化脱敏。
方案 3:Logback/Log4j2 Converter 日志框架层脱敏(全局拦截)
思路:修改日志输出转换器,日志框架在输出文本之前,拦截日志消息字符串,正则匹配敏感正则,替换掩码。
优点:不侵入业务代码,不管打印什么对象,只要字符串里面匹配手机号、身份证正则,自动替换;适合存量老项目改造,大量历史代码来不及加注解。
缺点:正则误杀风险高,比如一段文本里面数字串刚好匹配身份证正则,被错误脱敏;动态 JSON 里面的 key-value 无法精准识别语义,只能匹配文本模式。
适合作为兜底方案,不能作为主方案。主方案优先注解序列化脱敏,框架正则脱敏作为第二道防线。
Logback 自定义 Converter 简要示例:
public class DesensitizeConverter extends ClassicConverter {
// 手机号正则
private static final Pattern PHONE_PATTERN = Pattern.compile("1[3-9]\\d{9}");
@Override
public String convert(ILoggingEvent event) {
String msg = event.getFormattedMessage();
Matcher matcher = PHONE_PATTERN.matcher(msg);
StringBuffer sb = new StringBuffer();
while(matcher.find()){
String phone = matcher.group();
String des = phone.substring(0,3)+"****"+phone.substring(7);
matcher.appendReplacement(sb, des);
}
matcher.appendTail(sb);
return sb.toString();
}
}
然后在 logback.xml 配置转换器。
注意:正则兜底只能防一部分泄露,不能替代业务层注解脱敏。正则无法识别验证码、token 这类语义字段。
方案 4:全局请求拦截器,入参打印统一处理(接口日志专用)
很多项目会写一个 Web 拦截器,统一打印所有接口请求入参、响应参数,这是泄露重灾区。
正确做法:在拦截器里面拿到请求对象之后,先做脱敏,再交给日志打印。
@Slf4j
@Component
public class WebLogInterceptor implements HandlerInterceptor {
@Override
public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception {
// 读取请求体
String body = getBody(request);
JSONObject json = JSON.parseObject(body);
// 递归遍历json,脱敏敏感key
desensitizeJson(json);
log.info("请求路径:{},入参:{}", request.getRequestURI(), json.toJSONString());
return true;
}
}
这里的坑是:如果是异步线程打印日志、MQ 消费者打印消息体,Web 拦截器管不到,会漏掉。所以拦截器方案只能覆盖 HTTP 接口,无法覆盖内部调用、定时任务、MQ。
递归 JSON 脱敏工具(处理 Map、嵌套 JSON、扩展字段 ext)
动态 JSON、Map<String,Object> 是脱敏难点,固定注解无法覆盖,需要写递归遍历方法,匹配 key 名称:password、code、token、phone、idCard,识别到 key 直接处理。
匹配 key 黑名单:password,passwd,pwd,code,verifyCode,token,authorization,sk,secret,cvv
匹配到黑名单 key,直接设置值为 [filtered];匹配到 phone/idCard,掩码。
递归方法需要支持嵌套 JSONObject、JSONArray。
这个是企业级脱敏必不可少的组件,用来对付前端传入的自由扩展字段。
五、高频踩坑案例复盘,错误代码和修复对比
下面是我在代码审计中反复遇到的日志脱敏漏洞案例,每一个都有真实 SRC 提交记录。
案例 1:只脱敏前端展示,采集原始日志没有脱敏
现象:开发在日志打印之后,做了一层页面展示脱敏;Filebeat 采集的原始日志文件里面依旧明文。
根因:混淆了 “页面展示脱敏” 和 “日志内容脱敏”。脱敏必须在应用输出日志的源头处理,也就是log.info输出之前处理。采集器拿到的原始文本就已经是脱敏之后的内容。
❌ 错误流程:
业务代码输出明文 → 本地明文日志文件 → filebeat 采集明文 → 存入 ES → 前端查询 ES 结果,前端 js 打星号。
✅ 正确流程:
业务代码对象脱敏 → log 输出脱敏文本 → 本地文件已经脱敏 → 采集脱敏文本入库。
案例 2:DTO 加了注解脱敏,但是重写 toString,打印调用 toString 不走 Jackson
现象:UserDTO 加了 @Desensitize 注解,但是开发者重写了 toString 方法,打印 log 的时候直接调用 toString 拼接字符串,Jackson 序列化器根本不触发,脱敏失效。
@Data
public class UserDTO {
@Desensitize(type = DesensitizeType.PHONE)
private String phone;
// ❌ 重写toString,自己拼接
@Override
public String toString() {
return "UserDTO{" + "phone='" + phone + '\'' + '}';
}
}
打印:log.info("user {}", userDTO),优先调用 toString,注解失效。
修复方案:两种选其一
- 删除自定义 toString,使用 Jackson 序列化输出日志;
- 在 toString 内部手动调用脱敏工具类。
案例 3:正常主流程脱敏,异常分支、catch 块里面直接打印原始参数
try{
saveUser(dto);
}catch(Exception e){
// ❌ 异常分支直接打印原始dto,漏掉脱敏
log.error("保存用户失败,参数:{}", dto, e);
}
很多开发只在成功分支脱敏,异常分支偷懒直接打印原始对象,异常日志成为泄露入口。
审计重点:搜索所有 log.error 打印入参的地方。异常日志是泄露高发区。
案例 4:调试日志使用 info 级别,生产环境不会关闭
// ❌ 调试日志,info级别,生产永久输出
log.info("debug 原始明文验证码:{}", verifyCode);
很多人以为 debug 日志用 log.debug,但是写的时候顺手写成log.info,上线之后一直输出验证码。
规范:调试信息必须使用 log.debug,生产环境 logback 配置关闭 debug 级别。严禁使用 info 打印调试敏感内容。
案例 5:日志打印解密后的明文
业务先 AES 解密拿到用户身份证明文,然后打印明文用于排查:
byte[] plain = aesUtil.decrypt(cipher);
String idCard = new String(plain);
// ❌ 解密明文直接打印
log.info("解密之后身份证:{}", idCard);
这个漏洞评级往往偏高。解密后的敏感明文,非必要禁止打印。如果解密异常必须排查,可以打印密文,不要打印解密结果。
案例 6:MQ 消息体、定时任务日志没有脱敏
Web 接口拦截器做了脱敏,但是 MQ 消费者拿到消息体之后直接打印整条消息,里面手机号明文。
很多脱敏方案只覆盖 Web,忽略 MQ、定时任务、内部 RPC 调用。企业落地必须单独对 MQ 消息体做递归 JSON 脱敏。
案例 7:脱敏规则不一致,团队每个人掩码格式不一样
A 开发:1385678;B 开发:1381234;C 开发:138*5678。给运维和客服造成混乱。解决方案:统一一份脱敏工具类,所有人共用,不允许自己手写字符串替换。
六、日志传输、存储、权限、生命周期安全规范
脱敏只是日志安全的第一关,就算日志内容脱敏做好了,存储和权限失控依然会出事。
6.1 日志传输安全
- Filebeat、采集器到 Kafka、SLS/CLS,传输链路必须开启 TLS 加密,禁止明文 HTTP 传输;
- 内网不代表安全,内网抓包同样可以拿到日志数据;
- 采集配置禁止把日志转发到不受控的第三方地址。
6.2 日志存储安全
- 日志存储和业务数据库分开独立部署;
- 日志库账号最小权限原则:采集账号只有写入权限,查询账号分开;
- 日志平台开启登录二次验证;
- 禁止日志集群公网直接暴露;如果必须公网访问,增加 WAF、IP 白名单;
- 日志库禁止弱口令,不要使用 admin/admin。
6.3 日志访问权限控制(最小权限)
很多公司日志平台权限是全员开放,测试、实习、外包人员都可以查全量日志。
权限模型建议:
- 开发:只能查询自己负责服务的日志;
- 运维:只允许查看运维相关运行日志;
- 安全人员:审计日志查看权限;
- 普通业务人员:禁止访问日志平台;
- 所有日志查询、导出操作,保留访问审计日志:谁、什么时间、查询了哪个索引、导出操作。
日志导出是高危动作,导出操作必须单独审批、留痕。
6.4 日志留存周期(等保 + 个保要求)
分两类设置 TTL 自动过期:
- 普通业务运行日志:30~90 天,自动删除;满足故障排查即可,不需要永久保存;
- 安全审计日志:最低 6 个月,等保三级一般要求 6 个月以上;审计日志到期之后,如果不需要归档,安全评估之后删除;
不要所有日志统一无限期保存。日志存越久,泄露之后损失越大。云日志平台 SLS/CLS 都支持设置索引生命周期自动删除。
6.5 日志防篡改(审计日志重点)
普通业务日志不需要防篡改;安全审计日志要求:
- 审计日志单独索引、单独 Topic,不和业务日志混在一起;
- 审计日志一旦写入,业务侧不能修改、删除;
- 重要场景可以做审计日志异地归档,不可变存储。防止攻击者入侵之后删除日志抹除痕迹。
七、安全审计日志规范:哪些操作必须留审计日志,字段标准
很多团队走向另一个极端:为了防止泄露,什么都不打印,出事之后没有溯源日志。这里明确审计日志标准。
7.1 必须生成安全审计日志的操作清单
- 用户登录、登出、登录失败(密码错误、验证码错误);
- 密码修改、重置密码、手机号换绑;
- 权限变更:角色新增、权限授予、权限回收;
- 管理员后台登录、管理员查询 / 导出用户敏感数据;
- 接口鉴权失败、签名校验失败;
- IP 异地登录、异常设备登录;
- 密钥配置变更、加密策略变更;
- 批量数据导出操作;
- 配置中心修改、白名单变更。
7.2 审计日志标准字段(缺一不可)
审计日志推荐结构化 JSON 输出,方便检索:
{
"traceId": "xxxx",
"eventTime": "2026-10-22 10:00:00",
"eventType": "USER_LOGIN",
"operatorId": "10001",
"operatorIp": "127.0.0.1",
"userAgent": "Mozilla/xxx",
"targetId": "10002",
"result": "success",
"remark": "异地登录"
}
字段说明:
- traceId:链路 ID;
- eventTime:操作时间;
- operatorId:操作人账号 ID;
- operatorIp:操作来源 IP(审计日志 IP 必须完整,不能脱敏!溯源靠 IP);
- userAgent:客户端 UA;
- eventType:事件类型;
- targetId:操作对象 ID;
- result:成功 / 失败;
- remark:描述信息。
审计日志里面依然禁止存放明文密码、验证码。登录日志记录【登录成功】,不要记录登录密码。
7.3 审计日志和业务日志隔离
建议单独封装 AuditLogUtil 工具类,专门输出审计日志,使用独立的 logger name,单独输出到单独文件、单独 Kafka topic,方便采集到独立审计索引。
// 审计日志logger,独立配置
private static final Logger auditLogger = LoggerFactory.getLogger("AUDIT-LOG");
八、SAST 扫描规则、代码评审检查清单
8.1 Semgrep 扫描规则关键词(可以直接加到 SAST)
用来自动扫描代码里面危险日志打印:
log.info.*passwordlog.info.*verifyCodelog.error.*getPasswordlog.info.*getPhone直接打印request.getHeader("Authorization")- 循环打印全量 header map
- 打印 request.getParameterMap () 全量参数
扫描发现命中,标记为代码缺陷,走评审拦截。
8.2 代码评审日志安全检查清单(评审直接勾选)
□ 是否存在打印密码、验证码、token、密钥的日志;
□ 接口统一日志拦截器是否做了脱敏,是否覆盖嵌套 JSON、Map;
□ 异常 catch 块打印参数是否脱敏;
□ MQ、定时任务、RPC 入参日志是否脱敏;
□ DTO 使用注解脱敏的,确认没有自定义 toString 绕过脱敏;
□ debug 调试日志是否使用 log.debug,生产环境关闭 debug 级别;
□ 解密后的明文敏感数据没有打印日志;
□ 日志采集源头已经脱敏,不是只做前端展示脱敏;
□ 安全审计日志独立输出,必要溯源字段完整(IP、操作人 ID);
□ 日志设置 TTL 自动过期,不是永久保存;
□ 日志平台访问有最小权限控制,导出操作留审计;
□ 没有在日志中打印完整 Cookie、Authorization 头。
九、SDL 落地全流程,如何推动团队日志脱敏治理
日志安全治理难点不在于技术,而在于存量代码太多,开发习惯很难改。给一套落地路线:
- 第一阶段:制定统一规范和工具类
统一脱敏工具、注解、黑名单字段、审计日志组件,打包成公共 jar 包,所有业务服务引入。不允许各个项目自己写一套脱敏。 - 第二阶段:存量代码扫描
SAST 批量扫描危险日志打印语句,SRC 自查、内部安全审计批量抓泄露点,分批修复高危泄露。优先修复验证码、密钥、明文密码打印。 - 第三阶段:门禁卡点
代码提交流水线增加检查:新增代码禁止新增明文打印敏感字段;发现新增危险日志,卡点阻断合并。 - 第四阶段:日志侧兜底
Logback 正则脱敏作为兜底第二防线,就算业务代码漏掉,框架层再拦一层;兜底只做辅助,不能替代业务层。 - 第五阶段:定期抽查
安全团队定期抽样检索日志平台,搜索手机号、身份证正则,检查是否还有明文泄露,持续运营。 - 培训:纠正开发习惯
很多开发习惯 “先打印全量参数方便排查”,需要培训最小必要原则:排查问题优先依赖 traceId 链路追踪,而不是打印整包明文。
十、总结
日志安全是典型的 “低优先级漏洞,高量级风险”。单条日志泄露一条手机号看起来危害不大,但是日志是长期累积、批量存储的数据池,一旦失守就是大规模个人信息泄露。
核心要点整理:
- 日志分为业务日志、调试日志、安全审计日志三类,安全要求完全不同;调试敏感日志生产禁止开启;审计日志保证溯源能力,但是同样禁止打印验证码、密钥;
- 敏感信息分等级:验证码、密码、AK、Token 优先直接过滤不打印;手机号身份证等个人信息采用掩码脱敏;统计场景可以使用 SHA256 哈希;
- 脱敏优先方案:DTO 注解 + Jackson 序列化,一处注解全局生效;兜底方案使用日志框架正则拦截;Web 拦截器只能覆盖 HTTP 接口,MQ、定时任务很容易漏掉;
- 脱敏必须在日志源头完成,不能只做日志平台前端展示脱敏;toString 重写、异常分支、MQ 消息是脱敏失效最高发坑点;
- 脱敏完成不等于万事大吉,日志传输 TLS 加密、最小权限访问、TTL 自动过期、审计日志独立存储防篡改,整套链路缺一不可;
- 治理思路:统一组件先行、SAST 扫描存量、代码门禁防新增、定期抽样巡检,持续运营。
日志安全本质是最小必要原则在可观测领域的落地:我们需要日志用来排错、溯源,但是我们不需要把用户所有隐私,一股脑全部交给日志系统。合格的日志开发,是保留解决问题需要的信息,去掉所有不必要的敏感明文。
免责声明:本文代码、规范仅用于企业内部安全开发学习、代码评审,禁止用于未授权系统的信息探测。敏感信息处理需要遵守《个人信息保护法》等法律法规。
最后
关于网络安全技术储备
网络安全是当今信息时代中非常重要的一环。无论是找工作还是感兴趣(黑客),都是未来职业选择中上上之选,为了保护自己的网络安全,学习网络安全知识是必不可少的。
如果你是准备学习网络安全(黑客)或者正在学习,下面这些你应该能用得上:
①网络安全学习路线
②20份渗透测试电子书
③安全攻防357页笔记
④50份安全攻防面试指南
⑤安全红队渗透工具包
⑥网络安全必备书籍
⑦100个漏洞实战案例
⑧安全大厂内部视频资源
⑨历年CTF夺旗赛题解析
一、网络安全(黑客)学习路线
网络安全(黑客)学习路线,形成网络安全领域所有的知识点汇总,它的用处就在于,你可以按照上面的知识点去找对应的学习资源,保证自己学得较为全面。

二、网络安全教程视频
我们在看视频学习的时候,不能光动眼动脑不动手,比较科学的学习方法是在理解之后运用它们,这时候练手项目就很适合了。

三、网络安全CTF实战案例
光学理论是没用的,要学会跟着一起敲,要动手实操,才能将自己的所学运用到实际当中去,这里带来的是CTF&SRC资料&HW资料,毕竟实战是检验真理的唯一标准嘛~

四、网络安全面试题
最后,我们所有的作为都是为就业服务的,所以关键的临门一脚就是咱们的面试题内容,所以面试题板块是咱们不可或缺的部分,这里我给大家准备的就是我在面试期间准备的资料。

网安其实不难,难的是坚持和相信自己,我的经验是既然已经选定网安你就要相信它,相信它能成为你日后进阶的高效渠道,这样自己才会更有信念去学习,才能在碰到困难的时候坚持下去。
机会属于有准备的人,这是一个实力的时代。人和人之间的差距不在于智商,而在于如何利用业余时间,只要你想学习,什么时候开始都不晚,不要担心这担心那,你只需努力,剩下的交给时间!
这份完整版的网络安全学习资料已经上传优快云,朋友们如果需要可以微信扫描下方优快云官方认证二维码免费领取【保证100%免费】

本文系统阐述业务日志、调试日志和安全审计日志三类日志的安全要求,明确敏感信息分级清单(如手机号、身份证、Token、密钥等),提出掩码脱敏、哈希脱敏、丢弃不打印、占位符替换四类脱敏方案选型原则。重点介绍Java生态中基于注解+Jackson序列化、Logback/Log4j2 Converter拦截、全局请求拦截器及递归JSON脱敏的落地实践,并覆盖传输TLS加密、最小权限访问、TTL自动过期、审计日志防篡改等全链路安全规范。
3318

被折叠的 条评论
为什么被折叠?



