Identity Config 0.19.0+
These notes preserve manual upgrade steps from older UDS Identity Config versions. Use them when supporting an older UDS Core deployment that may have skipped a historical Keycloak realm change.
ServerInfo permissions
Section titled “ServerInfo permissions”Keycloak 26.4.0 changed the ServerInfo endpoint. Without additional permissions, OpenTofu can fail with a Malformed version error when using the Keycloak Terraform provider. See Keycloak Terraform Provider #1342 for upstream context.
To add the required view-system role:
- Navigate to the
udsrealm. - Go to Clients > realm-management > Client roles > Roles.
- Click Create role.
- Set Role name to
view-system. - Set Description to
Enables displaying SystemInfo through the ServerInfo endpoint. - Click Save.
- Return to the
realm-managementroles by clicking the Client details breadcrumb. - Select the
realm-adminrole. - Open the Associated roles tab.
- Click Assign role > Client roles.
- Select the
view-systemrole. - Click Assign.
Related documentation
Section titled “Related documentation”- Legacy upgrade notes - preserved manual steps for older Identity Config versions
- Upgrade Keycloak realm configuration - current guidance for manual Keycloak realm changes