Skip to content

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.

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:

  1. Go to Realm settings > Events.
  2. Add jsonlog-event-listener.
  3. Remove the built-in jboss-logging event listener.
  4. Click Save.

To update the renamed registration event listener in the uds realm:

  1. Go to Realm settings > Events.
  2. Add registration-event-listener.
  3. Remove custom-registration-listener.
  4. Click Save.

To add the bare-groups client scope:

  1. Go to Client scopes > Create client scope.
  2. Set Name to bare-groups.
  3. Set Type to Optional.
  4. Set Include in token scope to On.
  5. Click Save.
  6. Open Mappers and click Create a new mapper.
  7. Select Custom Group Path Mapper.
  8. Set Name to bare groups.
  9. To allow clients to use this scope as a default client scope, go to Clients > Client registration > Allowed client scopes.
  10. Add bare-groups.
  11. Click Save.