Microsoft Graph Java SDK修改密码时日志泄露明文敏感信息的处理问询

microsoft-graph v2.3.1 版本敏感日志处理方案 #

针对changePassword接口明文密码被写入日志的问题，SDK本身提供多层细粒度处理能力，无需通过全量抑制日志的方式解决：

1. 启用SDK内置的日志自动脱敏能力 #

v2.3.1版本的Java SDK内置了日志管道的自动脱敏逻辑，无需手动编写规则：

• 初始化GraphServiceClient时，在HTTP日志中间件的配置项中开启redactSensitiveContent开关。该开关开启后，SDK会自动识别请求中的currentPassword、newPassword、Authorization类敏感字段，日志输出时自动将字段值替换为[REDACTED]，不会输出明文。
• 配置代码示例：

// 构建日志配置，开启自动脱敏
HttpLoggingConfiguration loggingConfig = HttpLoggingConfiguration.builder()
    .logLevel(HttpLogDetailLevel.BODY_AND_HEADERS)
    .redactSensitiveContent(true)
    .build();

// 将配置绑定到客户端的HTTP管道
GraphServiceClient graphClient = GraphServiceClient.builder()
    .httpClientConfig(config -> config.loggingConfiguration(loggingConfig))
    .buildClient();

• 该配置的优先级高于自定义日志器的原始输出逻辑，即使将日志级别开到最高的完整报文级，敏感字段的值也不会被明文输出。

2. 适配异常抛出场景的日志拦截 #

多数明文日志的触发点并非常规日志输出流程，而是API请求抛出异常时，SDK会将原始请求对象作为异常上下文的一部分写入日志，这类场景的处理逻辑：

• 无需全量拦截所有请求的日志，仅需针对/me/changePassword路径的请求，挂载自定义日志过滤规则。SDK提供请求路径匹配的过滤器接口，可指定匹配到修改密码接口的请求时，对输出的请求体做全量脱敏处理，其他接口的日志完全保留正常报文内容，不影响问题排查效率。
• 实现自定义日志器时，不要直接将原始HttpRequest对象的toString()结果写入日志，需先调用SDK内置的SensitiveContentSanitizer工具类对待输出字符串做脱敏处理，避免序列化时带出密码字段的明文值。

3. 常见踩坑提醒 #

• 临时调试时不要开启无脱敏规则的全量报文日志，这类配置会绕过SDK的默认脱敏逻辑，直接将密码明文写入日志文件。
• 开启上述原生脱敏配置后，可移除之前实现的全局日志抑制逻辑，恢复正常的日志排查能力，仅保留敏感字段打码的细粒度规则，这也是SDK原生细粒度日志处理能力的设计初衷。

内容的提问来源于stack exchange，提问作者Ash Tappin