Maverick Synergy is the third generation Java SSH API developed by JADAPTIVE Limited (previously known as SSHTOOLS Limited). It is a pure Java implementation of the SSH2 protocol enabling you to create both client and server solutions under the open source and commercial friendly LGPL license.
:grey_exclamation: Maverick Synergy is open-source software that is developed by a commercial organization. Whilst we strive to provide support to the open-source edition whenever we can; if you require immediate help, please consider purchasing a support subscription from Jadaptive Limited. Subscriptions include access to security hotfixes and new features in advance of their open-source release.
Community developers should raise issues or Pull Requests directly in Github. Please ensure you have read our Contribution Agreement before submitting any PR requests.
Built upon the Java NIO framework, this third generation of the API for the first time provides a unified framework for developing both client and server solutions.
The following solutions utilize the Maverick Synergy API in some form. If you would like your own project adding here, please get in touch or create a PR with the necersary changes to this page.
From the API Developers, JADAPTIVE Limited
Third-party Solutions
Here are just some of the notable features of the APIs
The core API has no third-party dependencies other than a Java 8 Runtime and the Java Cryptography Extensions. The project has been structured so that developers can choose the components they need without being forced to distribute third party libraries for features they do not require.
In the first instance, for a no dependency Java SSH client API simply use the maven dependency
<dependency>
<groupId>com.sshtools</groupId>
<artifactId>maverick-synergy-client</artifactId>
<version>3.1.0</version>
</dependency>
<!-- You may also need this repository if the version is a SNAPSHOT -->
<repository>
<id>oss-snapshots</id>
<url>https://oss.sonatype.org/content/repositories/snapshots</url>
<snapshots>
<enabled>true</enabled>
</snapshots>
<releases>
<enabled>false</enabled>
</releases>
</repository>We have created a high level API that makes it easy to make calls to SSH servers and perform common tasks. For example, downloading a file over SFTP is as simple as:
try(SshClient ssh = SshClientBuilder.create()
.withHostname("localhost")
.withPort(2222)
.withUsername("root")
.withPassword("xxxxx")
.build()) {
ssh.putFile(new File("package.deb"));
ssh.executeCommand("dpkg -i package.deb");
} catch (IOException | SshException e) {
e.printStackTrace();
}Include the server module to develop your own SSH/SFTP server.
<dependency>
<groupId>com.sshtools</groupId>
<artifactId>maverick-synergy-server</artifactId>
<version>3.1.0</version>
</dependency>
<!-- You may also need this repository if the version is a SNAPSHOT -->
<repository>
<id>oss-snapshots</id>
<url>https://oss.sonatype.org/content/repositories/snapshots</url>
<snapshots>
<enabled>true</enabled>
</snapshots>
<releases>
<enabled>false</enabled>
</releases>
</repository>We also have done a lot of the hard work for you implementing a virtual file system that simply enables you to mount folders and remote file locations into a single file system.
<dependency>
<groupId>com.sshtools</groupId>
<artifactId>maverick-virtual-filesystem</artifactId>
<version>3.1.0</version>
</dependency>Creating a server is made equally as easy as the client API. You just need to make a few desisions about how users authenticate and what they can do, for example, the code below creates a simple SFTP server that provides users with their own home folder. To the user, all they see is their own sandboxed home directoy.
SshServer server = new SshServer(2222);
Runtime.getRuntime().addShutdownHook(new Thread() {
public void run() {
server.close();
}
});
server.addAuthenticator(new InMemoryPasswordAuthenticator()
.addUser("admin", "admin".toCharArray()));
server.setFileFactory(new VirtualFileFactory(
new VirtualMountTemplate("/", "tmp/${username}",
new VFSFileFactory())));
server.start();Try running the above and connecting to port 2222 using and SFTP client
ssh -oPort=2222 admin@localhostFor more documentation on either the client or server API please visit our Manpage.
If you cannot find the documentation for something you want to do with the API, it's hightly likely that it can already be done but we have just not got around to documenting it yet. If you cannot find what you are looking for please Contact Us with the details and we'll try our best to point you in the right direction.
SSH is a registered trademark and Secure Shell is a trademark of SSH Communications Security Corp (www.ssh.com)