https://github.com/xdev-software/spring-security-advanced-authentication-ui
Modernizes the default Spring Web Authentication/Login UI and makes it easier customizable
https://github.com/xdev-software/spring-security-advanced-authentication-ui
authentication login spring spring-authentication-ui spring-boot spring-security spring-web ui
Last synced: 10 months ago
JSON representation
Modernizes the default Spring Web Authentication/Login UI and makes it easier customizable
- Host: GitHub
- URL: https://github.com/xdev-software/spring-security-advanced-authentication-ui
- Owner: xdev-software
- License: apache-2.0
- Created: 2024-03-28T14:25:03.000Z (almost 2 years ago)
- Default Branch: develop
- Last Pushed: 2024-11-08T02:32:20.000Z (over 1 year ago)
- Last Synced: 2024-11-08T03:29:12.765Z (over 1 year ago)
- Topics: authentication, login, spring, spring-authentication-ui, spring-boot, spring-security, spring-web, ui
- Language: Java
- Homepage:
- Size: 935 KB
- Stars: 4
- Watchers: 1
- Forks: 0
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Security: SECURITY.md
Awesome Lists containing this project
README
[](https://mvnrepository.com/artifact/software.xdev/spring-security-advanced-authentication-ui)
[](https://github.com/xdev-software/spring-security-advanced-authentication-ui/actions/workflows/check-build.yml?query=branch%3Adevelop)
[](https://sonarcloud.io/dashboard?id=xdev-software_spring-security-advanced-authentication-ui)
# Advanced authentication UI for Spring Security
Modernizes the default Spring Web Authentication/Login UI and makes it easier customizable.
Show demo
## Usage
The library provides an adapter that can be used like this:
```java
public SecurityFilterChain configure(final HttpSecurity http) throws Exception
{
// Changing the text "Login with" to "Sign in with"
http.with(new AdvancedLoginPageAdapter<>(http), c -> c
.customizeLoginPage(p -> p.ssoLoginHeaderText("Sign in with")))
.oauth2Login(c ->
// ...
)
// ...
}
```
A more detailed scenario is available in the [demo](./spring-security-advanced-authentication-ui-demo/).
> [!NOTE]
> By default [Bootstrap](https://github.com/twbs/bootstrap) is loaded from ``cdn.jsdelivr.net``.
> Due to privacy and stability reasons you should ship your own version!
> An example how this can be done is shown in the [demo](https://github.com/xdev-software/spring-security-advanced-authentication-ui/blob/4117d471e036de4dc2a58b2b484f2631afe7af50/spring-security-advanced-authentication-ui-demo/src/main/java/software/xdev/security/MainWebSecurity.java#L44-L51).
> [!NOTE]
> The ``Advanced``-subsystem uses the pre-``Spring Security 6.4`` / ``Spring Boot 3.4`` templating system (without Regex).
> * In contrast to Spring's new Regex based system not all values are escaped by default
> * Usually they don't need to be escaped in the first place as they are set on the server side and can't be modified by a user
> * This is A LOT FASTER (in tests around 50x) than Spring's new Regex based system
## Installation
[Installation guide for the latest release](https://github.com/xdev-software/spring-security-advanced-authentication-ui/releases/latest#Installation)
> [!NOTE]
> To minimize the risk of dependency conflicts all Spring (Boot) dependencies are declared as provided and are not shipped by default.
## Support
If you need support as soon as possible and you can't wait for any pull request, feel free to use [our support](https://xdev.software/en/services/support).
## Contributing
See the [contributing guide](./CONTRIBUTING.md) for detailed instructions on how to get started with our project.
## Dependencies and Licenses
View the [license of the current project](LICENSE) or the [summary including all dependencies](https://xdev-software.github.io/spring-security-advanced-authentication-ui/dependencies)