Assumptions & Prerequisites
This guide assumes you have root access to the Linux device. This is required as new software needs to be installed system-wide.
Ubuntu 14.04 LTS (Trusty Tahr) is not currently an "officially" supported platform, and Moonshot packages for Trusty are not yet available. However, using a mixture of Moonshot packages from Debian 7 and Moonshot daily packages for Ubuntu 13.04 (Raring Ringtail) Trusty can be made to support Moonshot until such a time as official Trusty packages are available.
1. System Preparation
First, there are a few Ubuntu configuration options that need to be set in advance.
1.1. Add the Moonshot Repository
Add the Moonshot Debian Wheezy repository to your system. To do this, run the following command (as root, or using sudo):
Install the Moonshot GPG key:
Add the Moonshot Daily PPA Raring repository to your system. To do this, run the following command (as root, or using sudo):
Install the Moonshot daily key:
Update the apt cache with the new repository information:
1.2. Configure APT
Since we've added the Debian and Ubuntu Moonshot repositories, we must tell apt that the Ubuntu repository has precedence.
Create a file called
/etc/apt/preferences.d/moonshot, with the following content:
1.3. Install Older Packages
Ubuntu 14.04 LTS ships with some some versions of packages that are too new to work with the Ubuntu 13.04 packages that we're temporarily using on 14.04 LTS. So, we need to install the older versions alongside the newer.
- Download the following two packages:
You will receive several errors about dependencies. Install the dependencies:
1.4. Moonshot GSS Mechanisms
Create a new file at
/usr/etc/gss/mech (you will likely need to create the
/usr/etc/gss directory) with the following content:
In the future we hope for this step to be done automatically on installing the software. For now, however, this is a manual step.
1.5. Install the Moonshot Client libraries
We’re now ready to install the Moonshot software and its required dependencies. Install the software by running the following command:
2. Next steps
At this point, you now have all of the required Moonshot software on your device, including the Moonshot Identity Selector. Depending on what client application you are using and wish to enable Moonshot authentication for, you job may now be done, or you may need to go and install a Moonshot compatible version of the client software or configure your existing client. Check the section on client compatibility if you are unsure.