Added explanation for "Permission denied" error
Added a documentation page that explains the "Permission denied (publickey)" error in details and what can be done to solve the problem. Signed-off-by: Edwin Kempin <edwin.kempin@gmail.com> Change-Id: I790a22e8c451bb1adc031cc24a077b7e9ccbf9c4
This commit is contained in:
parent
26b9e72bbd
commit
014de30871
Documentation
@ -14,6 +14,7 @@ Error Messages
|
||||
* link:error-missing-changeid.html[missing Change-Id in commit message]
|
||||
* link:error-multiple-changeid-lines.html[multiple Change-Id lines in commit message]
|
||||
* link:error-no-new-changes.html[no new changes]
|
||||
* link:error-permission-denied.html[Permission denied (publickey)]
|
||||
* link:error-squash-commits-first.html[squash commits first]
|
||||
* link:error-you-are-not-author.html[you are not author ...]
|
||||
* link:error-you-are-not-committer.html[you are not committer ...]
|
||||
|
61
Documentation/error-permission-denied.txt
Normal file
61
Documentation/error-permission-denied.txt
Normal file
@ -0,0 +1,61 @@
|
||||
Permission denied (publickey)
|
||||
=============================
|
||||
|
||||
With this error message a SSH command to Gerrit is rejected if the
|
||||
SSH authentication is not successful.
|
||||
|
||||
The link:http://en.wikipedia.org/wiki/Secure_Shell[SSH] protocol uses link:http://en.wikipedia.org/wiki/Public-key_cryptography[Public-key Cryptography] for authentication.
|
||||
This means for a successful SSH authentication you need your private
|
||||
SSH key and the corresponding public SSH key must be known to Gerrit.
|
||||
|
||||
If you are facing this problem, do the following:
|
||||
1. Verify that you are using the correct username for the SSH command
|
||||
and that it is typed correctly (case sensitive). You can look up
|
||||
your username in the Gerrit WebUI under 'Settings' -> 'Profile'.
|
||||
2. Verify that you have uploaded your public SSH key for your Gerrit
|
||||
account. To do this go in the Gerrit WebUI to 'Settings' ->
|
||||
'SSH Public Keys' and check that your public SSH key is there. If
|
||||
your public SSH key is not there you have to upload it.
|
||||
3. Verify that you are using the correct private SSH key. To find out
|
||||
which private SSH key is used test the SSH authentication as
|
||||
described below. From the trace you should see which private SSH
|
||||
key is used.
|
||||
|
||||
|
||||
Test SSH authentication
|
||||
-----------------------
|
||||
|
||||
To test the SSH authentication you can run the following SSH command.
|
||||
This command will print out a detailed trace which is helpful to
|
||||
analyze problems with the SSH authentication:
|
||||
|
||||
----
|
||||
$ ssh -vv -p 29418 john.doe@git.example.com
|
||||
----
|
||||
|
||||
If the SSH authentication is successful you should find the following
|
||||
lines in the output:
|
||||
|
||||
----
|
||||
...
|
||||
|
||||
debug1: Authentication succeeded (publickey).
|
||||
|
||||
...
|
||||
|
||||
**** Welcome to Gerrit Code Review ****
|
||||
|
||||
Hi John Doe, you have successfully connected over SSH.
|
||||
|
||||
Unfortunately, interactive shells are disabled.
|
||||
To clone a hosted Git repository, use:
|
||||
|
||||
git clone ssh://john.doe@git.example.com:29418/REPOSITORY_NAME.git
|
||||
|
||||
...
|
||||
----
|
||||
|
||||
|
||||
GERRIT
|
||||
------
|
||||
Part of link:error-messages.html[Gerrit Error Messages]
|
Loading…
x
Reference in New Issue
Block a user