java.lang.Object
com.jcraft.jsch.JSch
-
Constructor Summary
-
Method Summary
Modifier and TypeMethodDescriptionvoid
addIdentity(Identity identity, byte[] passphrase)
Sets the private key, which will be referred in the public key authentication.void
addIdentity(String prvkey)
Sets the private key, which will be referred in the public key authentication.void
addIdentity(String prvkey, byte[] passphrase)
Sets the private key, which will be referred in the public key authentication.void
addIdentity(String name, byte[] prvkey, byte[] pubkey, byte[] passphrase)
Sets the private key, which will be referred in the public key authentication.void
addIdentity(String prvkey, String passphrase)
Sets the private key, which will be referred in the public key authentication.void
addIdentity(String prvkey, String pubkey, byte[] passphrase)
Sets the private key, which will be referred in the public key authentication.protected void
addSession(Session session)
static String
Returns the config value for the specified key.Returns the current hostkey repository.Lists names of identities included in the identityRepository.getSession(String host)
Instantiates theSession
object withhost
.getSession(String username, String host)
Instantiates theSession
object withusername
andhost
.getSession(String username, String host, int port)
Instantiates theSession
object with givenusername
,host
andport
.void
Removes all identities from identityRepository.void
removeIdentity(Identity identity)
Removes the identity from identityRepository.void
removeIdentity(String name)
Deprecated.use #removeIdentity(Identity identity)protected boolean
removeSession(Session session)
static void
Sets or Overrides the configuration.static void
Sets or Overrides the configuration.void
setConfigRepository(ConfigRepository configRepository)
void
setHostKeyRepository(HostKeyRepository hkrepo)
Sets the hostkey repository.void
setIdentityRepository(IdentityRepository identityRepository)
Sets theidentityRepository
, which will be referred in the public key authentication.void
setKnownHosts(InputStream stream)
Sets the instance ofKnownHosts
generated withstream
.void
setKnownHosts(String filename)
Sets the instance ofKnownHosts
, which refers tofilename
.static void
Sets the logger
-
Constructor Details
-
JSch
public JSch()
-
-
Method Details
-
setIdentityRepository
Sets theidentityRepository
, which will be referred in the public key authentication.- Parameters:
identityRepository
- ifnull
is given, the default repository, which usually refers to ~/.ssh/, will be used.- See Also:
getIdentityRepository()
-
getIdentityRepository
-
getConfigRepository
-
setConfigRepository
-
getSession
Instantiates theSession
object withhost
. The user name and port number will be retrieved from ConfigRepository. If user name is not given, the system property "user.name" will be referred.- Parameters:
host
- hostname- Returns:
- the instance of
Session
class. - Throws:
JSchException
- ifusername
orhost
are invalid.- See Also:
getSession(String username, String host, int port)
,Session
,ConfigRepository
-
getSession
Instantiates theSession
object withusername
andhost
. The TCP port 22 will be used in making the connection. Note that the TCP connection must not be established until Session#connect().- Parameters:
username
- user namehost
- hostname- Returns:
- the instance of
Session
class. - Throws:
JSchException
- ifusername
orhost
are invalid.- See Also:
getSession(String username, String host, int port)
,Session
-
getSession
Instantiates theSession
object with givenusername
,host
andport
. Note that the TCP connection must not be established until Session#connect().- Parameters:
username
- user namehost
- hostnameport
- port number- Returns:
- the instance of
Session
class. - Throws:
JSchException
- ifusername
orhost
are invalid.- See Also:
getSession(String username, String host, int port)
,Session
-
addSession
-
removeSession
-
setHostKeyRepository
Sets the hostkey repository.- Parameters:
hkrepo
-- See Also:
HostKeyRepository
,KnownHosts
-
setKnownHosts
Sets the instance ofKnownHosts
, which refers tofilename
.- Parameters:
filename
- filename of known_hosts file.- Throws:
JSchException
- if the given filename is invalid.- See Also:
KnownHosts
-
setKnownHosts
Sets the instance ofKnownHosts
generated withstream
.- Parameters:
stream
- the instance of InputStream from known_hosts file.- Throws:
JSchException
- if an I/O error occurs.- See Also:
KnownHosts
-
getHostKeyRepository
Returns the current hostkey repository. By the default, this method will the instance ofKnownHosts
.- Returns:
- current hostkey repository.
- See Also:
HostKeyRepository
,KnownHosts
-
addIdentity
Sets the private key, which will be referred in the public key authentication.- Parameters:
prvkey
- filename of the private key.- Throws:
JSchException
- ifprvkey
is invalid.- See Also:
addIdentity(String prvkey, String passphrase)
-
addIdentity
Sets the private key, which will be referred in the public key authentication. Before registering it into identityRepository, it will be deciphered withpassphrase
.- Parameters:
prvkey
- filename of the private key.passphrase
- passphrase forprvkey
.- Throws:
JSchException
- ifpassphrase
is not right.- See Also:
addIdentity(String prvkey, byte[] passphrase)
-
addIdentity
Sets the private key, which will be referred in the public key authentication. Before registering it into identityRepository, it will be deciphered withpassphrase
.- Parameters:
prvkey
- filename of the private key.passphrase
- passphrase forprvkey
.- Throws:
JSchException
- ifpassphrase
is not right.- See Also:
addIdentity(String prvkey, String pubkey, byte[] passphrase)
-
addIdentity
Sets the private key, which will be referred in the public key authentication. Before registering it into identityRepository, it will be deciphered withpassphrase
.- Parameters:
prvkey
- filename of the private key.pubkey
- filename of the public key.passphrase
- passphrase forprvkey
.- Throws:
JSchException
- ifpassphrase
is not right.
-
addIdentity
public void addIdentity(String name, byte[] prvkey, byte[] pubkey, byte[] passphrase) throws JSchExceptionSets the private key, which will be referred in the public key authentication. Before registering it into identityRepository, it will be deciphered withpassphrase
.- Parameters:
name
- name of the identity to be used to retrieve it in the identityRepository.prvkey
- private key in byte array.pubkey
- public key in byte array.passphrase
- passphrase forprvkey
.- Throws:
JSchException
-
addIdentity
Sets the private key, which will be referred in the public key authentication. Before registering it into identityRepository, it will be deciphered withpassphrase
.- Parameters:
identity
- private key.passphrase
- passphrase foridentity
.- Throws:
JSchException
- ifpassphrase
is not right.
-
removeIdentity
Deprecated.use #removeIdentity(Identity identity)- Throws:
JSchException
-
removeIdentity
Removes the identity from identityRepository.- Parameters:
identity
- the indentity to be removed.- Throws:
JSchException
- ifidentity
is invalid.
-
getIdentityNames
Lists names of identities included in the identityRepository.- Returns:
- names of identities
- Throws:
JSchException
- if identityReposory has problems.
-
removeAllIdentity
Removes all identities from identityRepository.- Throws:
JSchException
- if identityReposory has problems.
-
getConfig
Returns the config value for the specified key.- Parameters:
key
- key for the configuration.- Returns:
- config value
-
setConfig
Sets or Overrides the configuration.- Parameters:
newconf
- configurations
-
setConfig
Sets or Overrides the configuration.- Parameters:
key
- key for the configurationvalue
- value for the configuration
-
setLogger
Sets the logger- Parameters:
logger
- logger- See Also:
Logger
-