UDS Core 1.10
UDS Core 1.10 removes the implicit Keycloak preview feature group from the default startup configuration. Deployments that depend on preview features must enable them explicitly through keycloak.keycloak.features.additional. This release also improves classification banner compatibility with single-page and full-viewport applications.
Notable features
Section titled “Notable features”- Explicit Keycloak feature selection: UDS Core no longer passes the generic
previewfeature group to Keycloak by default. Use the newkeycloak.keycloak.features.additionalvalue to enable individual optional features alongside the requiredfipsfeature. See the identity and authorization configuration reference (#2838). - Classification banner application compatibility: Classification banners now support single-page and full-viewport applications. The updated response handling supports buffered and streamed HTML while preserving space for the banner above application content. See Enable the classification banner (#2710).
Dependency updates
Section titled “Dependency updates”| Package | Previous | Updated |
|---|---|---|
| Authservice | 1.1.5 | 1.1.8 |
| Envoy Gateway | v1.8.2 | v1.8.3 |
| Envoy Proxy | v1.38.3 | v1.39.0 |
| Gateway API CRDs | v1.5.1 | v1.6.1 |
| Istio | 1.29.3 | 1.30.3 |
| Loki | 3.7.3 | 3.7.4 |
| Loki Helm chart | 18.5.1 | 18.7.0 |
| k8s-sidecar | 2.8.1 | 2.10.0 |
| Pepr | 1.2.2 | 1.3.0 |
| Prometheus | v3.13.1 | v3.13.2 |
| Prometheus Operator | v0.92.1 | v0.93.0 |
| kube-prometheus-stack Helm chart | 87.16.1 | 88.1.4 |
| Prometheus Blackbox Exporter Helm chart | 11.15.1 | 11.16.0 |
| prometheus-operator-crds Helm chart | 30.0.1 | 31.0.0 |
Upgrade considerations
Section titled “Upgrade considerations”Keycloak session behavior
Section titled “Keycloak session behavior”Keycloak stores regular user sessions in the database independently of stateless mode, so established SSO sessions remain available during the upgrade. In-progress authentication sessions and action tokens created while stateless mode is enabled may not carry over after UDS Core disables it. Affected users may need to restart an in-progress sign-in or account action.
Istio 1.30 compatibility changes
Section titled “Istio 1.30 compatibility changes”UDS Core 1.10 upgrades Istio from 1.29.3 to 1.30.3. Most deployments require no additional action, but review these changes if your deployment uses custom mesh tooling or configuration (#2724):
- XDS debug endpoint authentication: Istio now requires authentication for the
synczandconfig_dumpendpoints on port15010. Review custom tooling andistioctlworkflows that use plaintext XDS connections. - CNI configuration permissions: Istio changes the default permissions for CNI configuration files from
0644to0600. Review tooling that reads these files as a non-root group member. - Excluded ambient namespaces: The Istio CNI agent now honors
excludeNamespaces. Istio removes existing ambient workloads in excluded namespaces from the mesh and does not enroll new workloads in those namespaces. - Sidecar service selection: Istio changes how sidecar proxies select a service when the same hostname exists in multiple namespaces. Review deployments that use the same hostname for Kubernetes
Serviceresources and non-Kubernetes services.
UDS Core packages Gateway API CRDs v1.6.1 as part of this upgrade, so you do not need to install them separately. Review the Istio 1.30 upgrade notes for complete compatibility details.
Pre-upgrade steps
Section titled “Pre-upgrade steps”-
Review Keycloak feature dependencies
If your deployment relies on a Keycloak feature that UDS Core previously enabled through the generic
previewgroup, add that feature to thekeycloak.keycloak.features.additionallist before upgrading. Prefer the specific feature name overpreviewso unrelated preview features do not activate.
Post-upgrade verification
Section titled “Post-upgrade verification”-
Verify Keycloak startup and SSO flows
Confirm that the Keycloak
StatefulSetbecomes ready and test the SSO flows used by your deployment. If you enabled an additional feature, verify its expected behavior separately.
Related documentation
Section titled “Related documentation”- Upgrade Overview - general upgrade procedures and checklists
- Identity and authorization configuration - configure Keycloak features
- Enable the classification banner - configure and verify classification banners
- Zarf values reference - configure UDS Core packages with native Zarf values
- UDS Core 1.10.0 Changelog - full changelog
- Full diff (1.9.0…1.10.0) - all changes between versions
- Keycloak server features - upstream feature status and configuration