You are viewing the development documentation for the Apereo CAS server. The functionality presented here is not officially released yet. This is a work in progress and will be continually updated as development moves forward. You are most encouraged to test the changes presented.To view the documentation for a specific Apereo CAS server release, please choose an appropriate version. The release schedule is available here.
RC1 Release Notes
We strongly recommend that you take advantage of the release candidates as they come out. Waiting for a
GA release is only going to set
you up for unpleasant surprises. A
is a tag and nothing more. Note that CAS releases are strictly time-based
releases; they are not scheduled or based on specific benchmarks, statistics or completion of features. To gain confidence in a particular
release, it is strongly recommended that you start early by experimenting with release candidates and/or follow-up snapshots.
If you benefit from Apereo CAS as free and open-source software, we invite you to join the Apereo Foundation and financially support the project at a capacity that best suits your deployment. Note that all development activity is performed almost exclusively on a voluntary basis with no expectations, commitments or strings attached. Having the financial means to better sustain engineering activities will allow the developer community to allocate dedicated and committed time for long-term support, maintenance and release planning, especially when it comes to addressing critical and security issues in a timely manner. Funding will ensure support for the software you rely on and you gain an advantage and say in the way Apereo, and the CAS project at that, runs and operates. If you consider your CAS deployment to be a critical part of the identity and access management ecosystem, this is a viable option to consider.
- Start your CAS deployment today. Try out features and share feedback.
- Better yet, contribute patches.
- Suggest and apply documentation improvements.
gradle.properties of the CAS WAR Overlay, adjust the following setting:
There are no changes to the minimum system/platform requirements for this release.
New & Noteworthy
The following items are new improvements and enhancements presented in this release.
The construction of Spring beans (as defined by the
@Bean annotation) managed via auto-configuration classes has been enhanced to support configuration refresh requests specially when beans are activated conditionally using a property value via the likes of
@ConditionalOnProperty. This allows a bean to remain in a disabled state using a JDK dynamic proxy so that it can later on be replaced with a real implementation when/if configuration is refreshed.
Modest support for feature toggles is now available to allow multiple competing modules to be present the same web application where they can be toggled on and off va dedicated flags and settings. This could previously be handled via excluding specific CAS
@Configuration classes which was risky and prone to breakage during upgrades as such classes are always considered an implementation detail. Starting with this release candidate, a specific feature can be enabled or disabled via a dedicated setting allowing all configuration modules and components to react accordingly without one having to know the internal details.
Please note that feature toggles are not yet supported by all CAS modules; this is a large effort and will likely require several more releases before this capability is finalized. Also, remember that feature toggles do require a restart.
OpenID Connect - JMeter Performance Testing
JMeter scripts used to run performance tests for CAS running as an OpenID Connect Provider are now integrated with the CAS CI system to ensure the test script and the functionality under test continues to run smoothly.
Several Docker images used for integration tests are now updated to their latest versions. These include:
- AWS Localstack
- Apache Cassandra
- Apache Couchbase
- AWS DynamoDb
- Apereo CAS
- Microsoft SQL Server
- Spring Data
- Amazon SDK
- Apache Log4j
Actuator endpoints exposed to or controlled by CAS can now be observed and managed via the HAL Explorer:
As part of this change, CAS allows one to use version agnostic URLs for webjars. Using jQuery as an example,
/webjars/jquery/jquery.min.js results in
x.y.z is the webjar version.
The collection of end-to-end browser tests based on Puppeteer continue to grow to add additional scenarios. At this point, there are approximately
255 test scenarios and we’ll continue to add more in the coming releases. Test coverage has also slightly improved and now stands at
Static Attribute Release Policy
A special attribute release policy is now available to authorize the release of static attributes to applications. Using this policy, static attribute values no longer need to be constructed at the attribute repository level, and their definition can be confined within the context of the application bound to receive attributes.
- Minor fixes to how
localechanges are remembered and tracked across different browser sessions.
- System properties and environment variables can now override properties that are found in CAS configuration files.
- Internal rewiring of CAS components, bean processors and event listeners to improve support for building native images.
- CAS Initializr is slightly reorganized to move Gradle tasks into a separate file.
- Server-side automatic redirects used for delegated authentication can now correctly recognize an existing SSO session.
- Internal improvements to the Gradle build to remove deprecated elements, in early preparation for Gradle 9.
- CAS Initializr is now able to produce WAR Overlay projects that take advantage of Gradle’s support for BOMs, making it more predictable to handle dependency management issues and conflicts.
- OpenID Connect support for handling signed authentication requests using the
requestparameter is now included.
- Signing OpenID Connect ID tokens or profile payloads can now correctly filter signing algorithms based on CAS configuration.
- Spring Boot
- Spring Data CosmosDb
- Spring Cloud AWS
- MongoDb Driver
- Spring Security
- Nimbus OIDC
- Thymeleaf Dialect
- Apache Tomcat