org.eclipse.jgit.junit.ssh

Class SshTestGitServer

java.lang.Object

org.eclipse.jgit.junit.ssh.SshTestGitServer

public class SshTestGitServer
extends Object

A simple ssh/sftp git test server based on Apache MINA sshd.

Supports only a single repository. Authenticates only the given test user against his given test public key. Supports fetch and push.

Since:

5.2

Field Summary

Fields

Modifier and Type	Field and Description
protected List<KeyPair>	hostKeys
protected Repository	repository
protected org.apache.sshd.server.SshServer	server
protected PublicKey	testKey
protected String	testUser

Constructor Summary

Constructors

Constructor and Description
SshTestGitServer(String testUser, Path testKey, Repository repository, byte[] hostKey) Creates a ssh git test server.

Method Summary

Modifier and Type	Method and Description
void	addHostKey(Path key, boolean inFront) Adds an additional host key to the server.
protected void	configureAuthentication() Configures the authentication mechanisms of this test server.
protected void	configureShell() Configures shell access for the test server.
protected List<org.apache.sshd.common.NamedFactory<org.apache.sshd.server.command.Command>>	configureSubsystems() Configures the test server's subsystems (sftp, scp).
void	enableKeyboardInteractiveAuthentication() Enable keyboard-interactive authentication.
void	enablePasswordAuthentication() Enable password authentication.
void	setPreamble(String... lines) Sets the lines the server sends before its server identification in the initial protocol version exchange.
void	setTestUserPublicKey(Path key) Sets the test user's public key on the server.
int	start() Starts the test server, listening on a random port.
void	stop() Stops the test server.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

testUser

@NonNull
protected final String testUser

repository

@NonNull
protected final Repository repository

hostKeys

@NonNull
protected final List<KeyPair> hostKeys

server

protected final org.apache.sshd.server.SshServer server

testKey

@NonNull
protected PublicKey testKey

Constructor Detail

SshTestGitServer

public SshTestGitServer(@NonNull
                        String testUser,
                        @NonNull
                        Path testKey,
                        @NonNull
                        Repository repository,
                        @NonNull
                        byte[] hostKey)
                 throws IOException,
                        GeneralSecurityException

Creates a ssh git test server. It serves one single repository, and accepts public-key authentication for exactly one test user.

Parameters:

testUser - user name of the test user

testKey - private key file of the test user; the server will only user the public key from it

repository - to serve

hostKey - the unencrypted private key to use as host key

Throws:

IOException

GeneralSecurityException

Method Detail

configureAuthentication

protected void configureAuthentication()

Configures the authentication mechanisms of this test server. Invoked from the constructor. The default sets up public key authentication for the test user, and a gssapi-with-mic authenticator that pretends to support this mechanism, but that then refuses to authenticate anyone.

configureSubsystems

@NonNull
protected List<org.apache.sshd.common.NamedFactory<org.apache.sshd.server.command.Command>> configureSubsystems()

Configures the test server's subsystems (sftp, scp). Invoked from the constructor. The default provides a simple SFTP setup with the root directory as the given repository's .git directory's parent. (I.e., at the directory containing the .git directory.)

Returns:

A possibly empty collection of subsystems.

configureShell

protected void configureShell()

Configures shell access for the test server. The default provides no shell at all.

addHostKey

public void addHostKey(@NonNull
                       Path key,
                       boolean inFront)
                throws IOException,
                       GeneralSecurityException

Adds an additional host key to the server.

Parameters:

key - path to the private key file; should not be encrypted

inFront - whether to add the new key before other existing keys

Throws:

IOException - if the file denoted by the Path key cannot be read

GeneralSecurityException - if the key contained in the file cannot be read

enablePasswordAuthentication

public void enablePasswordAuthentication()

Enable password authentication. The server will accept the test user's name, converted to all upper-case, as password.

enableKeyboardInteractiveAuthentication

public void enableKeyboardInteractiveAuthentication()

Enable keyboard-interactive authentication. The server will accept the test user's name, converted to all upper-case, as password.

start

public int start()
          throws IOException

Starts the test server, listening on a random port.

Returns:

the port the server listens on; test clients should connect to that port

Throws:

IOException

stop

public void stop()
          throws IOException

Stops the test server.

Throws:

IOException

setTestUserPublicKey

public void setTestUserPublicKey(Path key)
                          throws IOException,
                                 GeneralSecurityException

Sets the test user's public key on the server.

Parameters:

key - to set

Throws:

IOException - if the file cannot be read

GeneralSecurityException - if the public key cannot be extracted from the file

setPreamble

public void setPreamble(String... lines)

Sets the lines the server sends before its server identification in the initial protocol version exchange.

Parameters:

lines - to send

Since:

5.5