= Infinispan marshalling changes Marshalling is the process of converting Java objects into bytes to send them across the network between {project_name} servers. With {project_name} 26, the marshalling library has changed from JBoss Marshalling to Infinispan Protostream. The libraries are not compatible between each other and, it requires some steps to ensure the session data is not lost. WARNING: JBoss Marshalling and Infinispan Protostream are not compatible with each other and incorrect usage may lead to data loss. Consequently, all caches are cleared when upgrading to this version. To prevent losing user sessions upgrade to Keycloak 25 first and enable the persistent sessions feature as outlined in the migration guide for {project_name} 25. = Operator no longer defaults to proxy=passthrough The Operator will no longer default to the hostname v1 setting of proxy=passthrough. This allows deployments using hostname v2 for a fixed edge hostname to work as desired without additional options. = New method in `ClusterProvider` API The following method was added to `org.keycloak.cluster.ClusterProvider`: * `void notify(String taskKey, Collection events, boolean ignoreSender, DCNotify dcNotify)` When multiple events are sent to the same `taskKey`, this method batches events and just perform a single network call. This is an optimization to reduce traffic and network related resources. In {project_name} 26, the new method has a default implementation to keep backward compatibility with custom implementation. The default implementation performs a single network call per an event, and it will be removed in a future version of {project_name}. = Group-related events no longer fired when removing a realm With the goal of improving the scalability of groups, they are now removed directly from the database when removing a realm. As a consequence, group-related events like the `GroupRemovedEvent` are no longer fired when removing a realm. If you have extensions handling any group-related event when a realm is removed, make sure to use the `RealmRemovedEvent` instead to perform any cleanup or custom processing when a realm, and their groups, are removed. The `GroupProvider` interface is also updated with a new `preRemove(RealmModel)` method to force implementations to properly handle the removal of groups when a realm is removed. = Operator scheduling defaults Keycloak Pods will now have default affinities to prevent multiple instances from the same CR from being deployed on the same node, and all Pods from the same CR will prefer to be in the same zone to prevent stretch cache clusters. = Operator's default CPU and memory limits/requests In order to follow the best practices, the default CPU and memory limits/requests for the Operator were introduced. It affects both non-OLM and OLM installs. To override the default values for the OLM install, edit the `resources` section in the operator's https://github.com/operator-framework/operator-lifecycle-manager/blob/master/doc/design/subscription-config.md#resources[subscription]. = Deprecations in `keycloak-common` module The following items have been deprecated for removal in upcoming {project_name} versions with no replacement: - `org.keycloak.common.util.reflections.Reflections.newInstance(java.lang.Class)` - `org.keycloak.common.util.reflections.Reflections.newInstance(java.lang.Class, java.lang.String)` - `org.keycloak.common.util.reflections.SetAccessiblePrivilegedAction` - `org.keycloak.common.util.reflections.UnSetAccessiblePrivilegedAction` = Consistent usage of UTF-8 charset for URL encoding `org.keycloak.common.util.Encode` now always uses the `UTF-8` charset for URL encoding instead relying implicitly on the `file.encoding` system property. = Configuring the LDAP Connection Pool In this release, the LDAP connection pool configuration relies solely on system properties. The main reason is that the LDAP connection pool configuration is a JVM-level configuration rather than specific to an individual realm or LDAP provider instance. Compared to previous releases, any realm configuration related to the LDAP connection pool will be ignored. If you are migrating from previous versions where any of the following settings are set to your LDAP provider(s), consider using system properties instead: * `connectionPoolingAuthentication` * `connectionPoolingInitSize` * `connectionPoolingMaxSize` * `connectionPoolingPrefSize` * `connectionPoolingTimeout` * `connectionPoolingProtocol` * `connectionPoolingDebug` For more details, see link:{adminguide_link}#_ldap_connection_pool[Configuring the connection pool]. = Custom Footer in Login Theme This release introduced the capability to easily add a custom footer to the login pages for the `base/login` and `keycloak.v2/login` theme. In order to use a custom footer, create a `footer.ftl` file in your custom login theme with the desired content. For more details, see link:{developerguide_link}#_theme_custom_footer[Adding a custom footer to a login theme]. = Persisting revoked access tokens across restarts In this release, revoked access tokens are written to the database and reloaded when the cluster is restarted by default when using the embedded caches. To disable this behavior, use the SPI option `spi-single-use-object-infinispan-persist-revoked-tokens` as outlined in the https://www.keycloak.org/server/all-provider-config[All provider configuration] {section}. The SPI behavior of `SingleUseObjectProvider` has changed that for revoked tokens only the methods `put` and `contains` must be used. This is enforced by default, and can be disabled using the SPI option `spi-single-use-object-infinispan-persist-revoked-tokens`. = Admin Bootstrapping and Recovery It used to be difficult to regain access to a {project_name} instance when all admin users were locked out. The process required multiple advanced steps, including direct database access and manual changes. In an effort to improve the user experience, {project_name} now provides multiple ways to bootstrap a new admin account, which can be used to recover from such situations. Consequently, the environment variables `KEYCLOAK_ADMIN` and `KEYCLOAK_ADMIN_PASSWORD` have been deprecated. You should use `KC_BOOTSTRAP_ADMIN_USERNAME` and `KC_BOOTSTRAP_ADMIN_PASSWORD` instead. These are also general options, so they may be specified via the cli or other config sources, for example `--bootstrap-admin-username=admin`. For more information, see the new https://www.keycloak.org/server/bootstrap-admin-recovery[Bootstrap admin and recovery] guide.