Skip to content
Browse files
Merge pull request #1202 from Wadeck/JENKINS-27026_CLI_AUTHENTICATION
[JENKINS-27026] Add paragraphs about the CLI authentication
  • Loading branch information
bitwiseman committed Oct 30, 2017
2 parents f62f6fa + fdcee25 commit a84f9fc68a0002e2495c9e2b46229b8338576f1e
Showing with 50 additions and 0 deletions.
  1. +50 −0 content/doc/book/managing/cli.adoc
@@ -345,3 +345,53 @@ No X-Jenkins-CLI2-Port among [X-Jenkins, null, Server, X-Co
at hudson.cli.CLI.<init>(
... 3 more

====== Server key did not validate

You may get the error below and find a log entry just below that concerning `mismatched keys`:

org.apache.sshd.common.SshException: Server key did not validate
at org.apache.sshd.client.session.AbstractClientSession.checkKeys(
at org.apache.sshd.common.session.helpers.AbstractSession.handleKexMessage(

This means your SSH configuration does not recognize the public key presented by the server.
It's often the case when you run Jenkins in dev mode and multiple instances
of the application are run under the same SSH port over time.

In a development context, access your `~/.ssh/known_hosts` (or in `C:/Users/<your_name>/.ssh/known_hosts` for Windows)
and remove the line corresponding to your current SSH port (e.g. `[localhost]:3485`).
In a production context, check with the Jenkins administrator if the public key of the server changed recently.
If so, ask the administrator to do the the steps described above.

====== UsernameNotFoundException

If your client displays a stacktrace that looks like:

org.acegisecurity.userdetails.UsernameNotFoundException: <name_you_used>

This means your SSH keys were recognized and validated against the stored users but the username is not valid for the security realm your application is using at the moment.
This could occur when you were using the Jenkins database initially, configured your users, and then switched to another security realm (like LDAP, etc.) where the defined users do not exist yet.

To solve the problem, ensure your users exist in your configured security realm.

====== Troubleshooting logs

To get more information about the authentication process:

. Go into *Manage Jenkins* > *System Log* > *Add new log recorder*.
. Enter any name you want and click on *Ok*.
. Click on *Add*
. Type `org.jenkinsci.main.modules.sshd.PublicKeyAuthenticatorImpl` (or type `PublicKeyAuth` and then select the full name)
. Set the level to *ALL*.
. Repeat the previous three steps for `hudson.model.User`
. Click on *Save*

When you try to authenticate, you can then refresh the page and see what happen internally.

0 comments on commit a84f9fc

Please sign in to comment.