Installing the Authenticator on Linux

This article provides instructions for installing, updating, and managing the Beyond Identity Authenticator on Linux devices, covering Debian/Ubuntu and RPM-based distributions, repository setup methods, package installation and removal, and common CLI commands.

Refer to the appropriate section for information on distributing and installing the Linux Authenticator package. The Linux Authenticator is officially supported on the following Linux packages:

• Debian (Ubuntu)

The Linux Authenticator is unofficially supported on the following Linux packages:

• RPM (RHEL/CentOS)

For a detailed list of supported versions, see Supported Platforms and System Requirements.

Debian Distribution Methods

Distribution of the packages can be done using one of the following methods:

• Automatically (recommended)

• Specific distribution, release/version, or architecture

• Manually

Automatic Repository Setup

To quickly set up the repository automatically:

curl -1sLf \
'https://packages.beyondidentity.com/public/linux-authenticator/setup.deb.sh' \
| sudo -E bash

Specific Distribution, Release/Version, or Architecture

If your system is compatible but not identical, you can force a specific distribution, release/version, or architecture, use the following method:

curl -1sLf \
'https://packages.beyondidentity.com/public/linux-authenticator/setup.deb.sh' \
| sudo -E distro=some-distro codename=some-codename arch=some-arch bash

Manual Repository Setup

To provide more control of the distribution, use the following method before installing packages:

apt-get install -y debian-keyring # debian only
apt-get install -y debian-archive-keyring # debian only
apt-get install -y apt-transport-https
curl -1sLf 'https://packages.beyondidentity.com/public/linux-authenticator/gpg.878C21C541554254.key' | apt-key add -
curl -1sLf 'https://packages.beyondidentity.com/public/linux-authenticator/config.deb.txt?distro=ubuntu&codename=focal' > /etc/apt/sources.list.d/beyond-identity-linux-authenticator.list
apt-get update

Note: Replace ubuntu and focal above with your actual operating system (distribution and distribution release/version).

Installing the Linux Authenticator

Once the repo is setup, to install the Authenticator, issue the following command:

sudo apt install beyond-identity

Updating the Linux Authenticator

To update the Authenticator, issue the following command:

sudo apt update && sudo apt upgrade beyond-identity

Removing the Repository

To remove the repository, issue the following commands. Once the repository is removed you will no longer receive updates.

sudo apt rm /etc/apt/sources.list.d/beyond-identity-linux-authenticator.list
apt-get clean
rm -rf /var/lib/apt/lists/*
apt-get update

Uninstalling the Linux Authenticator Package

To uninstall the Authenticator package, issue the following command:

sudo apt remove beyond-identity

RPM Distribution Methods

Distribution of the packages can be done using one of the following methods:

• Automatically (recommended)

• Specific distribution, release/version, or architecture

• Manually

Automatic Repository Installation

To quickly set up the repository automatically:

curl -1sLf \
'https://packages.beyondidentity.com/public/linux-authenticator/setup.rpm.sh' \
| sudo -E bash

Specific Distribution, Release/Version, or Architecture

If your system is compatible but not identical, you can force a specific distribution, release/version, or architecture, use the following method:

curl -1sLf \
'https://packages.beyondidentity.com/public/linux-authenticator/setup.rpm.sh' \
| sudo -E distro=some-distro codename=some-codename arch=some-arch bash

Manual Repository Setup

To provide more control of the distribution, use the following method before installing packages:

yum install yum-utils pygpgme
rpm --import 'https://packages.beyondidentity.com/public/linux-authenticator/gpg.878C21C541554254.key'
curl -1sLf 'https://packages.beyondidentity.com/public/linux-authenticator/config.rpm.txt?distro=el&codename=7' > /tmp/beyond-identity-linux-authenticator.repo
yum-config-manager --add-repo '/tmp/beyond-identity-linux-authenticator.repo'
yum -q makecache -y --disablerepo='*' --enablerepo='beyond-identity-linux-authenticator'

Note: Replace el and 7 above with your actual distribution/version and use Wildcards when enabling multiple repos.

Installing the Linux Authenticator

To install the Authentication, issue the following command:

sudo yum install beyond-identity

Updating the Linux Authenticator

To update the Authenticator, issue the following command:

yum update beyond-identity

Removing the Repository

To remove the repository, issue the following commands. Once the repository is removed you will no longer receive updates.

rm /etc/yum.repos.d/beyond-identity-linux-authenticator.repo
rm /etc/yum.repos.d/beyond-identity-linux-authenticator-source.repo

Uninstalling the Linux Authenticator Package

To uninstall the Authenticator, issue the following command:

sudo yum remove beyond-identity

CLI Commands

Various CLI commands are available for use with the Linux Authenticator. To view all available command operations, issue the following command:

beyond-identity help

The following table provides a list of common commands:

beyond-identity --version

beyond-identity credential import <IMPORT-CODE>

beyond-identity credentials

beyond-identity credential export <HANDLE (tenant name)>

beyond-identity credential delete <HANDLE (tenant name)>