SAML documentation bug

  • SonarQube version 7.9.1, SAML 2.0 Authentication for SonarQube version 1.1.0, Keycloak version 7.0.0

Under https://docs.sonarqube.org/latest/instance-administration/delegated-auth/#header-5, the documentation says things like:

Create a mapper for the name:
Name: Name
Mapper Type: User Property
User Attribute: Username (It can also be another attribute you would previously have specified for the users)
SAML Attribute Name: name

The error is that the SAML Attribute Name seems to be case-sensitive and, in all of the attributes specified in the documentation, the name must start with a capital letter otherwise the SonarQube server reports an error like this:

WARN  web[AW0+yoi1nu9oOKC6AAD3][o.s.s.a.AuthenticationError] Fail to callback authentication with 'saml'
java.lang.NullPointerException: Name is missing