Add warning that LocalUsernamesToLowerCase doesn't convert 'username' external IDs
The local username is the username that is used to login into the Gerrit Web UI and is stored as external ID with the 'gerrit' scheme. Usernames for SSH are stored as external IDs with the 'username' scheme. Those are not touched by the LocalUsernamesToLowerCase program and Gerrit doesn't provide any tool convert them to lower case. Clarify this since in the past some users wrongly thought they could set `auth.userNameToLowerCase` to true when they run the LocalUsernamesToLowerCase program. This is not true since `auth.userNameToLowerCase` is about external IDs in scheme 'username' and LocalUsernamesToLowerCase is about external IDs in scheme 'gerrit'. Change-Id: I862f55101039db55e927fd8c6487447c69f67a9a Signed-off-by: Edwin Kempin <ekempin@google.com>
This commit is contained in:
parent
04c987347d
commit
e7ae45c2b3
@ -616,7 +616,10 @@ set to `${sAMAccountName.toLowerCase}`). It is important that for all
|
||||
existing accounts this username is already in lower case. It is not
|
||||
possible to convert the usernames of the existing accounts to lower
|
||||
case because this would break the access to existing per-user
|
||||
branches.
|
||||
branches and Gerrit provides no tool to do such a conversion.
|
||||
+
|
||||
Setting this parameter to `true` will prevent all users from login that
|
||||
have a non-lower-case username.
|
||||
+
|
||||
This parameter only affects git over http and git over SSH traffic.
|
||||
+
|
||||
|
@ -14,7 +14,11 @@ _java_ -jar gerrit.war _LocalUsernamesToLowerCase_
|
||||
== DESCRIPTION
|
||||
Converts the local username for every account to lower case. The
|
||||
local username is the username that is used to login into the Gerrit
|
||||
Web UI.
|
||||
Web UI. The local username is stored a external ID with scheme
|
||||
`gerrit`.
|
||||
|
||||
[IMPORTANT]
|
||||
This program does not modify usernames in the `username` scheme.
|
||||
|
||||
This task is only intended to be run if the configuration parameter
|
||||
link:config-gerrit.html#ldap.localUsernameToLowerCase[ldap.localUsernameToLowerCase]
|
||||
|
Loading…
Reference in New Issue
Block a user