Test-sshdng NPM

test-sshdng

A library that allows you to start a local sshd daemon that you can test against. It is based off of Patrick Debois' original test-sshd library.

Because there is nothing like the real thing

Way too many codebases that uses ssh/sftp aren't being tested because mocking and stubbing sshd servers is hard.

How

It starts an ssh server on the localhost such that:

you can login as the current user (process.env.USER)
using the test key provided (included in the package at config/keys/id_rsa)
on a port you specify
with one of three modes:
- (mode: echo) if login succeeds it uses ForceCommand to echo the command in $SSH_ORIGINAL_COMMAND
- (mode: exec) if login succeeds it executes the command
- (mode: transfer) if login succeeds it allows for sftp transfers
it does NOT do password authentication. You must use a private key

Usage

import { TestSSHD } from 'test-sshdng';

const sshd = TestSSHD({port: 4000};
const connectParams = sshd.connectParams();

sshd.on('ready', () => {
  console.log('ready to login');
});

sshd.on('error', (error) => {
  // When sshd has an error
});

sshd.on('stdout', (data) => {
  // receive sshd stdout
});

sshd.on('stderr', (data) => {
  // receive sshd stderr
});

sshd.on('exit', () => {
  // when daemon exit
});

sshd.start();

// Make sure to stop the ssh server when the process exits
// This prevents orphaned processes
process.on('exit', function() {
  if(sshd.status === 'started') {
    sshd.stop(); // this returns a promise if you want to wait for it to resolve
  }
});