2.2. Ubuntu Packages¶
There are ready made packages for Ubuntu. Up to privacyIDEA 2.23 packages are available for Ubuntu 14.04 LTS and 16.04 LTS [4]. These are available via a public ppa repository [1].
Starting with privacyIDEA 3.0 packages are available for Ubuntu 16.04LTS and 18.04LTS [5].
2.2.1. Installing privacyIDEA 3.0 or higher¶
Before installing privacyIDEA 3.0 or upgrading to 3.0 you need to add the repository.
2.2.1.1. Add repository¶
Create a new file /etc/apt/sources.list.d/privacyidea-community.list
with the
following contents:
deb http://lancelot.netknights.it/community/xenial/stable xenial main
“xenial” is for Ubuntu 16.04LTS. If you are running Ubuntu 18.04LTS, replase “xenial” with “bionic”:
deb http://lancelot.netknights.it/community/bionic/stable bionic main
Download the signing key:
wget https://lancelot.netknights.it/NetKnights-Release.asc
On Ubuntu 16.04 check the fingerprint of the key:
gpg --with-fingerprint NetKnights-Release.asc
On 18.04 you need to run:
gpg --dry-run --import --with-fingerprint NetKnights-Release.asc
The fingerprint of the key is:
pub 4096R/AE250082 2017-05-16 NetKnights GmbH <release@netknights.it>
Key fingerprint = 0940 4ABB EDB3 586D EDE4 AD22 00F7 0D62 AE25 0082
Now add the signing key to your system:
apt-key add NetKnights-Release.asc
2.2.1.3. Upgrading privacyIDEA to 3.0¶
If you want to upgrade your privacyIDEA on Ubuntu to privacyIDEA 3.0, you need to add a new repository configuration as described in Add repository.
Now you can simply run:
apt update
apt dist-upgrade
After this it is a good idea to remove old, unused packages by running:
apt autoremove
2.2.2. Installing privacyIDEA 2.23¶
If you want to for any reason install the old version 2.23.x, this is still available in a public ppa repository [1]. Install it like this:
add-apt-repository ppa:privacyidea/privacyidea
apt-get update
There are the base packages python-privacyidea
and the administrator
tool privacyideaadm
.
But we recommend installing the meta package:
apt-get install privacyidea-apache2
which will install the code, the webserver and the database and configure
everything accordingly. If you do not like the Apache2 webserver you could
alternatively use the meta package privacyidea-nginx
.
After installing with Apache2 or Nginx you only need to create your first administrator and you are done:
pi-manage admin add admin -e admin@localhost
Now you may proceed to First Steps.
Note
The packages privacyidea-apache2 and privacyidea-nginx assume that you want to run a privacyIDEA system. These packages deactivate all other (default) websites. You can install the package privacyidea-mysql to install the privacyIDEA application and setup the database. After this, you need to configure the webserver on your own.
Note
To get the latest development snapshots, you can use the repository ppa:privacyidea/privacyidea-dev. But these packages might be broken sometimes!
2.2.3. FreeRADIUS¶
privacyIDEA has a perl module to “translate” RADIUS requests to the API of the privacyIDEA server. This module plugs into FreeRADIUS. The FreeRADIUS does not have to run on the same machine like privacyIDEA. To install this module run:
apt-get install privacyidea-radius
For further details see RADIUS plugin.
2.2.4. SimpleSAMLphp¶
Starting with 1.4 privacyIDEA also supports SAML via a plugin for simpleSAMLphp [2]. The simpleSAMLphp service does not need to run on the same machine like the privacyIDEA server.
To install it on a Ubuntu 14.04 system please run:
apt-get install privacyidea-simplesamlphp
For further details see simpleSAMLphp Plugin.
2.2.5. PAM¶
privacyIDEA also comes with a PAM library to add two factor authentication to any Linux system. You can run one central privacyIDEA server and configure all other systems using the PAM library to authenticate against this privacyIDEA.
To install it on a Ubuntu 14.04 system please run:
apt-get install privacyidea-pam
For further details see Pluggable Authentication Module.
2.2.6. OTRS¶
OTRS is an important Open Source Ticket Request System. It is written in Perl and privacyIDEA provides an authentication plugin to authenticate at OTRS with two factors.
To install it on Ubuntu 14.04 please run:
apt-get install privacyidea-otrs
For further details and configuration see OTRS.
Footnotes
[1] | (1, 2) https://launchpad.net/~privacyidea |
[2] | https://github.com/privacyidea/privacyidea/tree/master/authmodules/simpleSAMLphp |
[3] | http://www.otrs.com/ |
[4] | Starting with privacyIDEA 2.15 Ubuntu 16.04 packages are provided |
[5] | Starting with privacyIDEA 3.0 Ubuntu 16.04 and 18.04 packages are provided, Ubuntu 14.04 packages are dropped. |