All of the instructions below assume that you have root access, and will work as the root user (either directly or using sudo).
The instructions on this page will replace the system provided OpenSSH packages with the Moonshot enabled ones (don't worry, standard SSH things will still work!)
Following the instructions on this page will give you a Moonshot-enabled OpenSSH Server only.
1. System Preparation
1.1. Add the Moonshot libraries.
If you have not already done so, you first need to follow the instructions on how to install the Moonshot Libraries on Debian 7.
1.2. Add the Moonshot OpenSSH Repository
We've moved the OpenSSH packages from the main Moonshot repository into their own, so add the Moonshot Debian OpenSSH repository to your system. To do this, run the following command (as root, or using sudo):
1.3. Configure APT
Debian 7 currently ships with OpenSSH 6.0p1, whereas our Moonshot-enabled OpenSSH is 5.9p1. So that you can install our OpenSSH, and not have it reverted back to the non-Moonshot-enabled system provided OpenSSH next time you do an
apt-get upgrade, we must tell
apt that the Moonshot repository has precedence over the official Debian repositories.
Create a file called
/etc/apt/preferences.d/moonshot, with the following content:
1.4. Ensure that your hostname is correct
The channel bindings check requires that the hostname of your SSH server match the hostname people are SSHing to. That is, the output of the "hostname" and "hostname -f" commands should match the FQDN of the server. If it doesn't, change
/etc/hostname to make it so.
2. Installation Instructions
Install the Moonshot-enabled pre-compiled OpenSSH packages using apt. This will replace the system provided OpenSSH.
3. Configuration Instructions
This version of OpenSSH does not support the use of privilege separation when using Moonshot authentication. Please follow the
UsePrivilegeSeparation instructions in the configuration.
Once installed, the Moonshot-enabled OpenSSH server will still need a few quick tweaks in order to turn on the Moonshot support.
Follow the configuration instructions on the OpenSSH Server page to configure the server.