Identity Config 0.10.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.
SAML mapper properties
Section titled “SAML mapper properties”UDS Identity Config v0.10.0 upgraded Keycloak to 26.1.0. That release added case sensitivity to Client SAML mappers, which could break SAML authentication flows if identity provider data no longer mapped into applications such as SonarQube or GitLab.
To update affected SAML mappers:
- Go to Client scopes.
- For each affected mapper, select the mapper and open the Mappers tab.
- Select the available mapper.
- Update the Property field to the exact lower-case or camel-case value.
- Click Save after each update.
Use these property mappings:
| Mapper | Previous value | Required value |
|---|---|---|
mapper-saml-email-email | Email | email |
mapper-saml-firstname-first_name | FirstName | firstName |
mapper-saml-lastname-last_name | LastName | lastName |
mapper-saml-username-login | Username | username |
mapper-saml-username-name | Username | username |
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