gerrit/Documentation/pgm-index.txt
Edwin Kempin b3b0d29467 Enable case insensitive login to Gerrit WebUI for LDAP authentication
Gerrit treats user names as case sensitive, while some LDAP servers
don't. On first login to Gerrit the user enters his user name and
Gerrit queries LDAP for it. Since LDAP is case-insensitive with regards
to  the username, the LDAP authentication succeeds regardless in
which case the user typed in his user name. The username is stored in
Gerrit exactly as entered by the user. For further logins the user
always has to use the same case. If the user specifies his user name in
a different case Gerrit tries to create a new account which fails with
"Cannot assign user name ... to account ...; name already in use.".
This error occurs because the LDAP query resolves to the same LDAP
user and storing the username for SSH (which is by default always
lower case) fails because such an entry exists already for the first
account that the user created.

This change introduces a new configuration parameter that converts the
user name always to lower case before doing the LDAP authentication.
By this the login to the Gerrit WebUI gets case insensitive. If this
configuration parameter is set, the user names for all existing
accounts have to be converted to lower case. This change includes a
server program to do this conversion.

Change-Id: I2d9099509b9438eaf88506c99e4dd3cc82a9140f
Signed-off-by: Edwin Kempin <edwin.kempin@sap.com>
2011-10-26 23:01:57 +02:00

45 lines
1.1 KiB
Plaintext

Gerrit Code Review - Server Programs
====================================
Server side programs can be started by executing the WAR file
through the Java command line. For example:
$ java -jar gerrit.war program [options]
[[programs]]Programs
--------------------
link:pgm-init.html[init]::
Initialize a new Gerrit server installation.
link:pgm-daemon.html[daemon]::
Gerrit HTTP, SSH network server.
link:pgm-gsql.html[gsql]::
Administrative interface to idle database.
link:pgm-prolog-shell.html[prolog-shell]::
Simple interactive Prolog interpreter.
link:pgm-rulec.html[rulec]::
Compile project-specific Prolog rules to JARs.
version::
Display the release version of Gerrit Code Review.
Transition Utilities
--------------------
link:pgm-ExportReviewNotes.html[ExportReviewNotes]::
Export submitted review information to refs/notes/review.
link:pgm-ScanTrackingIds.html[ScanTrackingIds]::
Rescan all changes after configuring trackingids.
link:pgm-LocalUsernamesToLowerCase.html[LocalUsernamesToLowerCase]::
Convert the local username of every account to lower case.
GERRIT
------
Part of link:index.html[Gerrit Code Review]