SSH Credentials Plugin

Skip to end of metadata
Go to start of metadata

Plugin Information

Plugin ID ssh-credentials Changes In Latest Release
Since Latest Release
Latest Release
Latest Release Date
Required Core
Dependencies
1.10 (archives)
Oct 17, 2014
1.532.2
credentials (version:1.16.1)
Source Code
Issue Tracking
Maintainer(s)
GitHub
Open Issues
Stephen Connolly (id: stephenconnolly)
Usage Installations 2014-Feb 65327
2014-Mar 69923
2014-Apr 71898
2014-May 74406
2014-Jun 76276
2014-Jul 81904
2014-Aug 82808
2014-Sep 87537
2014-Oct 91269
2014-Nov 91697
2014-Dec 91996
2015-Jan 96563

SSH Credentials Plugin

This plugin allows you to store SSH credentials in Jenkins.

For Developers

Using with Trilead SSH client library

Get the authenticator after you have opened the connection and let it handle authentication for you

StandardUsernameCredentials user = ...
Connection connection = ...


SSHAuthenticator authenticator = SSHAuthenticator.newInstance(connection, user);
if (\!authenticator.authenticate()) throw new RuntimeException("Couldn't authenticate"); 

Using with JSch SSH client library

Get the authenticator before you have opened the connection (using the JSchConnector, needed because of the strange dichotomy with JSch between public key authentication and user/password authentication) and let feed in authentication for you:

StandardUsernameCredentials user = ...
JSchConnector connector = new JSchConnector(user.getUsername(), hostName, port);


SSHAuthenticator authenticator = SSHAuthenticator.newInstance(connector, user);
authenticator.authenticate(); 
Session session = connector.getSession(); 
session.setConfig(...); 
session.connect(timeout);

Version History

Version 1.10 (Oct 17, 2014)

  • Code to let slaves load private keys from files on the master did not work as intended.
  • Deprecating SSHUserListBoxModel.

Version 1.9 (Aug 15, 2014)

  • Add safety to the Trilead SSH Authentication provider so that unknown key types do not cause authentication to bail (JENKINS-24273)

Version 1.8 (Aug 11, 2014)

  • Add (experimental) support for ECDSA keys

Version 1.7.1 (Jun 16, 2014)

  • Re-release of 1.7 (which failed to upload)

Version 1.7 (Jun 16, 2014)

  • Update credentials plugin dependency to 1.14
  • Add support for snapshotting SSH credentials

Version 1.6.1 (Feb 5, 2014)

  • Update credentials plugin dependency to 1.9.4

Version 1.6 (Nov 8, 2013)

  • UI bugfix and update credentials plugin dependency to 1.9.2

Version 1.5.1 (Oct 4, 2013)

  • Fix some annoying UI glitches that fell through the cracks

Version 1.5 (Oct 4, 2013)

  • Add a readResolve to FileOnMasterPrivateKeySource that heals any borked upgrades where the key contents were set as the filename.

Version 1.4 (Aug 30, 2013)

  • Add alternative API to allow overriding the username from SSHAuthenticator.newInstance(connector, user, username) - needed to support e.g. git@github.com SSH connections via JGit

Version 1.3 (Aug 8, 2013)

  • Another binary incompatibility known to affect CloudBees DEV@cloud servers.

Version 1.2 (Aug 8, 2013)

  • Binary incompatibility affecting older versions of the SSH Slaves plugin. (issue #19104)

Version 1.1 (Aug 7, 2013)

Version 1.0 (Aug 7, 2013)

  • Upgrade to Credentials Plugin 1.0 and migrate to new data types.
  • Any existing plugins that request credentials of type SSHUserPrivateKey explicitly will be unaffected.
  • If an existing plugin requests credentials of type BasicSSHUserPassword the resolution mechanism will handle the mapping to a concrete StandardUsernamePasswordCredentials transparently
  • If an existing plugin requests credentials of the base interface type SSHUser it will not be able to locate and StandardUsernamePasswordCredentials implementations and will need to be adapted to integrate correctly with the new class tree.
  • SSHAuthenticator.matcher() and SSHAuthenticator.matcher(Class< Connection type>) can be used to retrieve a CredentialsMatcher to narrow the search for appropriate credentials. 
  • NOTE: This version requires the SSH Slaves plugin be upgraded to at least version 1.0 or it will break the installed SSH Slaves plugin.
  • NOTE: This version modifies the configuration data format from a format that can be read by version 0.4 to a format that can only be read by 1.0 or newer. It will not be possible to downgrade from 1.0 to a previous release without risking configuration data loss. 

Version 0.4 (Jul 1, 2013)

  • Made the authentication usable on slaves.

Version 0.2 (Oct 25, 2012)

  • Add support for the JSch client library

Version 0.1 (Feb 28, 2012)

  • Initial release 

Labels

Edit
credentials-provider credentials-provider Delete
Enter labels to add to this page:
Please wait 
Looking for a label? Just start typing.