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 RHEL/CentOS/SL 6.
1.2. Install the Yum priorities plug-in
Install the Yum Priorities plugin to enable repository priority management:
For more information on the
yum-plugin-prioritiespackage, please see https://wiki.centos.org/PackageManagement/Yum/Priorities
Check that the
yum-prioritiesplugin is enabled in your yum configuration:
If the plugin is not enabled, change the
1.3. Add the Moonshot OpenSSH Repository
We've moved the OpenSSH packages from the main Moonshot repository into their own, so add the Moonshot RedHat OpenSSH repository to your system by creating a new file at
/etc/yum.repos.d/moonshot-ssh.repowith 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 the relevant line in
/etc/sysconfig/network to make it so.
2. Installation Instructions
Install the Moonshot-enabled pre-compiled OpenSSH packages using yum. This will replace the system-provided OpenSSH:
If you have already installed the latest version of OpenSSH from the CentOS updates repository and its version is either the same or is newer than the version in our repository, you must use the yum
downgradecommand to switch the packages to our version:
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.