Identity Config 0.5.2
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.
Event listeners
Section titled “Event listeners”UDS Identity Config v0.5.2 added a custom JSON Keycloak event logger, renamed the custom registration event listener, and added the bare-groups client scope.
To enable the JSON event logger in the uds realm:
- Go to Realm settings > Events.
- Add
jsonlog-event-listener. - Remove the built-in
jboss-loggingevent listener. - Click Save.
To update the renamed registration event listener in the uds realm:
- Go to Realm settings > Events.
- Add
registration-event-listener. - Remove
custom-registration-listener. - Click Save.
bare-groups client scope
Section titled “bare-groups client scope”To add the bare-groups client scope:
- Go to Client scopes > Create client scope.
- Set Name to
bare-groups. - Set Type to Optional.
- Set Include in token scope to On.
- Click Save.
- Open Mappers and click Create a new mapper.
- Select Custom Group Path Mapper.
- Set Name to
bare groups. - To allow clients to use this scope as a default client scope, go to Clients > Client registration > Allowed client scopes.
- Add
bare-groups. - Click Save.
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