后端认证鉴权单点登录【免费下载链接】casApereo CAS - Identity Single Sign On for all earthlings and beyond.项目地址https://gitcode.com/gh_mirrors/ca/cas点击查看免费下载Apereo CAS 默认以 Slf4j 作为日志门面、以 Log4j2 作为底层引擎详见 Logging.md但同时也原生支持将底层引擎切换为 Logback。本文以仓库文档 Logging-Logback.md 为核心讲解如何在 WAR overlay 中启用cas-server-support-logback模块、如何编写一份可运行的logback.xml并给出与 CAS 日志架构、MDC 上下文、ticket 敏感数据清洗相关的生产级注意事项。读完本文你将能够独立完成 CAS 从 Log4j2 到 Logback 的切换并掌握 Logback 在 CAS 环境下的配置、调优与排障方法。一、Logback 在 CAS 中的定位与总体架构Logback 是由 Log4j 创始人 Ceki Gülcü 维护的日志框架与 Log4j 相比在性能、内存占用与配置热加载方面各有特点。在 CAS 中Logback 是替代 Log4j2 的可选日志引擎二者均通过 Slf4j 门面接入因此切换引擎不需要改动业务代码只需要调整 WAR overlay 中的依赖与日志配置文件。从架构上看Logback 与 Log4j 高度相似核心都围绕三个组件展开Logger日志记录器按org.apereo.cas等包名或类名组织具有继承关系与级别TRACE/DEBUG/INFO/WARN/ERROR/OFF控制Appender日志目的地如控制台、文件、滚动文件、网络等Layout / Encoder日志事件的格式化组件Logback 中通常使用PatternLayout或Encoder。这些组件统一在一个名为logback.xml的配置文件中定义。默认情况下CAS 的日志入口位于cas-server-webapp-resources模块的src/main/resources/log4j2.xml在cas.war内位于cas-server-webapp-resources*.jar根路径而切换 Logback 后你需要自行提供logback.xml并通过logging.config属性或 classpath 方式使其生效。二、启用 LogbackWAR overlay 依赖配置1. 引入 Logback 支持模块Logback 支持由独立的 CAS 模块提供需要在 WAR overlay 中引入implementation org.apereo.cas:cas-server-support-logback仓库中的模块定义位于 support/cas-server-support-logback/build.gradle其描述为 Configures Logback support for CAS logging output and runtime log management依赖springbootloggingSpring Boot 的日志自动配置以及cas-server-core-cookie-api、cas-server-core-util-api、cas-server-core-configuration-api等核心 API 模块。这意味着该模块在启动阶段会接管 CAS 运行时的日志输出与日志管理能力。2. 排除 Log4j2 相关依赖关键步骤引入 Logback 的同时必须把 Log4j2 及其桥接依赖从 overlay 中排除否则 classpath 中会同时存在两套日志实现导致 Slf4j 绑定冲突、日志重复输出或配置互不生效。仓库文档给出的完整排除清单如下configurations.all { exclude(group: org.apache.logging.log4j, module: log4j-api) exclude(group: org.apache.logging.log4j, module: log4j-jakarta-web) exclude(group: org.apache.logging.log4j, module: log4j-web) exclude(group: org.apache.logging.log4j, module: log4j-jcl) exclude(group: org.apache.logging.log4j, module: log4j-slf4j-impl) exclude(group: org.apache.logging.log4j, module: log4j-slf4j2-impl) exclude(group: org.apereo.cas, module: cas-server-core-logging) }各排除项的作用如下log4j-api/log4j-web/log4j-jakarta-webLog4j2 核心 API 与 Web 集成log4j-jclJakarta Commons Logging 到 Log4j2 的桥接log4j-slf4j-impl/log4j-slf4j2-implLog4j2 到 Slf4j 的绑定实现不排除会与 Logback 的logback-classic绑定产生冲突cas-server-core-loggingCAS 内置的 Log4j2 日志装配模块是默认引擎的装配入口切到 Logback 后必须移除以避免双重初始化。提示以上配置写在 overlay 的build.gradle中即可仓库根项目的settings.gradle、gradle/dependencies.gradle等文件仅用于模块组织与版本管理overlay 无需修改它们。三、编写 logback.xml从零到可运行1. 最小可用配置切换引擎后需要提供一份logback.xml。仓库文档给出的示例配置如下?xml version1.0 encodingUTF-8? configuration scantrue scanPeriod30 seconds appender nameconsole classch.qos.logback.core.ConsoleAppender layout classch.qos.logback.classic.PatternLayout Pattern%white(%d{yyyy-MM-dd HH:mm:ss}) %highlight(%-5level) %cyan(%logger{15}) - %msg%n/Pattern /layout /appender logger nameorg.apereo.cas levelinfo additivityfalse appender-ref refconsole / /logger root levelinfo appender-ref refconsole / /root /configuration逐项解读这份配置configuration scantrue scanPeriod30 seconds开启配置热扫描每 30 秒检查一次logback.xml是否变化。修改日志级别或 Appender 后无需重启 JVM这与 Log4j2 的monitorInterval机制见 Logging.md作用一致appender nameconsole classch.qos.logback.core.ConsoleAppender定义控制台输出器默认输出到System.outlayout classch.qos.logback.classic.PatternLayout使用模式布局。%d{yyyy-MM-dd HH:mm:ss}输出时间戳%highlight(%-5level)按级别着色并左对齐 5 个字符宽度%cyan(%logger{15})以青色输出最多 15 个字符的 logger 名称%msg%n输出消息与换行%white(...)使时间戳以白色显示。这些是 Logback 内置的颜色转换需要控制台支持 ANSI 转义如本地终端或配了 Jansilogger nameorg.apereo.cas levelinfo additivityfalse对 CAS 核心包设置INFO级别additivityfalse表示本 logger 的输出不再向上传递给 root避免重复打印同时显式将控制台 appender 绑定到该 loggerroot levelinfo根 logger 兜底同样输出到控制台。2. 仓库内的真实测试配置仓库的 Puppeteer 测试场景logging-with-logback提供了一份实战可用的logback.xml位于 ci/tests/puppeteer/scenarios/logging-with-logback/logback.xml内容如下configuration scantrue scanPeriod15 seconds appender nameCONSOLE classch.qos.logback.core.ConsoleAppender withJansitrue/withJansi encoder pattern[%thread] %highlight(%-5level) %cyan(%logger{15}) - %msg %n/pattern /encoder /appender logger nameorg.apereo.cas levelinfo additivityfalse appender-ref refCONSOLE/ /logger root leveloff appender-ref refCONSOLE/ /root /configuration它与文档示例的差异值得注意使用withJansitrue/withJansi在 Windows/受限终端上启用 Jansi 转义支持使用encoderpattern替代layout这是 Logback 1.x 推荐的现代写法Encoder比Layout有更强的字节流控制能力对ConsoleAppender与FileAppender均适用pattern 中加入了[%thread]线程名便于并发环境下追踪请求root leveloff根 logger 直接关闭仅保留org.apereo.cas这一个 logger 的输出从而最大程度降低无关框架日志的噪音。生产环境中如果你希望同时看到第三方库如 Spring、Hibernate的日志应把 root 级别调回info或warn。四、扩展文件输出、滚动与级别控制控制台日志只适合开发与短时排障。生产环境通常需要把日志落到文件并按大小/时间滚动。在 Logback 中可组合RollingFileAppender、TimeBasedRollingPolicy或SizeAndTimeBasedRollingPolicy实现appender namecasFile classch.qos.logback.core.rolling.RollingFileAppender file${cas.log.dir:-/var/log/cas}/cas.log/file rollingPolicy classch.qos.logback.core.rolling.SizeAndTimeBasedRollingPolicy fileNamePattern${cas.log.dir:-/var/log/cas}/cas.%d{yyyy-MM-dd}.%i.log.gz/fileNamePattern maxFileSize10MB/maxFileSize maxHistory30/maxHistory totalSizeCap1GB/totalSizeCap /rollingPolicy encoder pattern%d{yyyy-MM-dd HH:mm:ss.SSS} %-5level [%thread] %logger{36} - %msg%n/pattern /encoder /appender要点说明maxFileSize单文件达到指定大小即触发滚动示例为 10MBfileNamePattern中的%d与%i按日期和序号生成归档文件名.gz后缀表示滚动后自动压缩maxHistory保留归档文件的天数totalSizeCap所有日志文件总容量上限对 CAS 而言把滚动频率和保留策略与 Logging.md 中 Log4j2 的触发策略启动时、按大小、按时间对齐即可在切换引擎后保持相近的运维行为。日志级别除了在logback.xml中直接写死还可以通过 CAS 的logging.*属性体系动态覆盖。CAS 对第三方日志属性以logging.前缀提供支持例如 Logging.md 中提到的logging.config可用于指定日志配置文件位置默认 overlay 即通过logging.configfile:/etc/cas/config/log4j2.xml引用外部配置切换 Logback 后可将该属性指向外置的logback.xmllogging.level.包名则可在不修改 XML 的前提下调整指定包的级别。生产环境建议遵循仓库文档的通用建议日常运行在WARN级别仅在排查具体问题时临时调高到INFO/DEBUG问题定位后立即降回。五、结合 MDC 输出请求上下文CAS 会为每个请求在 MDCMapped Diagnostic Context中写入丰富的上下文变量这在 Logging-MDC.md 中有完整清单包括remoteAddress、remoteUser、serverName、serverPort、locale、contentType、contextPath、localAddress、localPort、remotePort、pathInfo、protocol、authType、method、queryString、requestUri、scheme、timezone、principal、requestId等此外请求的属性、Header 与参数也会暴露为变量。Logback 的PatternLayout原生支持 MDC 转换符%X输出全部 MDC 变量%X{key}输出指定键的变量。例如在logback.xml的控制台 pattern 中加入请求标识pattern%d{HH:mm:ss.SSS} [%thread] %X{requestId} %-5level %logger{36} - %msg%n/pattern这样每行日志都会带上requestId方便在分布式排查中把同一请求的日志串联起来。需要特别警惕的是MDC 变量可能包含密码等敏感信息如queryString、参数变量如果日志被转发到 Syslog 等外部系统务必先确认输出内容的安全性参见 Logging-MDC.md 中的警告。六、关键注意事项Logback 不提供 ticket 敏感数据清洗这是从 Log4j2 切换到 Logback 时最重要的行为差异仓库文档给出了明确的警告Sanitizing log data to remove sensitive ticket ids such as ticket-granting tickets or proxy-granting tickets is not handled by CAS when Logback is used.即使用 Logback 时CAS 不会自动清洗日志中的 TGTticket-granting ticket与 PGTproxy-granting ticket标识。而在默认的 Log4j2 方案下CAS 内置了CasAppender它会包装普通 Appender 并从日志条目中剥离敏感 ticket 值默认在 ticket id 尾部保留少量字符以辅助排查形如TGT-******************123456-cas01.example.org详见 Logging.md 的 Log Data Sanitation 一节。因此在 Logback 模式下你需要自行承担清洗职责在把日志共享给 Splunk、Syslog 等外部系统前务必在日志管道侧对 ticket id 进行脱敏若仍需要 CAS 侧清洗能力可评估在 Appender 前引入自定义 Filter 或 Encoder 对消息体做替换但这是 overlay 自己的实现职责CAS 官方在 Logback 路径上暂不承担仓库文档明确提示此限制may be worked out in future releases升级 CAS 版本时应留意 release notes 中是否新增了该能力。七、生产建议小结依赖层面overlay 引入cas-server-support-logback同时完整排除所有org.apache.logging.log4j桥接件与cas-server-core-logging避免双引擎冲突配置层面外置logback.xml通过logging.config属性指向文件路径便于升级时保留配置开启scanscanPeriod获得热刷新能力级别策略生产以WARN为基准诊断问题临时上调到INFO/DEBUG并配合logging.level.*属性精准控制目标包输出设计控制台 滚动文件组合按大小与时间滚动并压缩归档pattern 中通过%X{requestId}注入请求上下文安全红线Logback 模式下 CAS 不做 ticket id 清洗对外共享日志前必须自行脱敏。如果需要在不同日志引擎间做更细致的行为对比如 Appender 与 Layout 的完整能力清单、Log4j2 的CasAppender清洗实现、日志消息摘要机制等可进一步阅读仓库文档 Logging.md 与 Logging-MDC.md并参考测试场景 ci/tests/puppeteer/scenarios/logging-with-logback 中可直接复用的完整配置。赞分享后端认证鉴权单点登录【免费下载链接】casApereo CAS - Identity Single Sign On for all earthlings and beyond.项目地址https://gitcode.com/gh_mirrors/ca/cas点击查看免费下载相关推荐Apereo CAS 日志配置实战指南Log4j2、CasAppender 插件、滚动策略与日志脱敏Apereo CAS 日志配置实战指南Log4j2、CasAppender 插件、滚动策略与日志脱敏 导读 日志是排查 Apereo CAS 单点登录问题如后端认证鉴权单点登录JeecgBoot日志管理Logback日志配置与ELK集成JeecgBoot日志管理Logback日志配置与ELK集成 引言企业级应用日志管理的挑战 在企业级应用开发中日志管理是系统可观测性的核心环节。随着微服务低代码后端前端代码生成AI 应用人工智能RAGRuoYi日志系统Logback配置与日志管理策略RuoYi日志系统Logback配置与日志管理策略 引言 在企业级应用开发中完善的日志系统是保障系统稳定运行、快速定位问题的关键基础设施。RuoYi作为一款后端企业应用认证鉴权代码生成上一篇【亲测免费】 win-acme 安装与使用指南下一篇PromiseKit 开源项目教程创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考