Home

Awesome

<p align="center"> <img src="https://pac4j.github.io/pac4j/img/logo-spring-security.png" width="300" /> </p>

The spring-security-pac4j project is a bridge from pac4j to Spring Security (reactive) to push the pac4j security context into the Spring Security security (reactive) context.
It's based on the pac4j security engine. It's available under the Apache 2 license.

spring-security-pac4jJDKpac4jSpring securityOperating philosophyUsage of LombokStatus
version >= 1017v6v6Bridge onlyYesProduction ready
version >= 917v5v6Bridge onlyNoProduction ready
version >= 811v5v5Standalone security libraryNoProduction ready
version >= 611v5v5Standalone security libraryNoProduction ready
version >= 58v4v5Standalone security libraryNoProduction ready

Since version 8 (working as a bridge only), it must be used with a pac4j security library:

While it is always better to directly use a pac4j security library alone, this bridge can be used to keep legacy software and avoid full migration.

Usage

1) Add the required dependencies

2) The bridge is automatically installed

3) Install, configure and use the pac4j security library

You must refer to the documentation of the pac4j security library you use: jakartaee-pac4j or spring-webmvc-pac4j or spring-webflux-pac4j.

Demos

Spring security boot demo with pac4j JEE filters: spring-security-pac4j + jakartaee-pac4j: spring-security-jee-pac4j-boot-demo.

Spring Security boot demo with pac4j SpringMVC: spring-security-pac4j + spring-webmvc-pac4j: spring-security-webmvc-pac4j-boot-demo.

Spring Security reactive boot demo with pac4j Spring Webflux: spring-security-pac4j + spring-webflux-pac4j: spring-security-webflux-pac4j-boot-demo.

Versions

The latest released version is the Maven Central, available in the Maven central repository. The next version is under development.

See the release notes. Learn more by browsing the pac4j documentation and the spring-security-pac4j Javadoc.

See the migration guide as well.

Need help?

You can use the mailing lists or the commercial support.