How to Install the Linux Authenticator *

Refer to the appropriate section for information on distributing and installing the Linux Authenticator package. The Linux Authenticator currently supports the following Linux packages:

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

To quickly set up the repository automatically:

1 2 3 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:

1 2 3 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

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

1 2 3 4 5 6 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

To install the Authenticator, issue the following command:

1 sudo apt install beyond-identity

Updating the Linux Authenticator

To update the Authenticator, issue the following command:

1 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.

1 2 3 4 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:

1 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

To quickly set up the repository automatically:

1 2 3 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:

1 2 3 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

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

1 2 3 4 5 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:

1 sudo yum install beyond-identity

Updating the Linux Authenticator

To update the Authenticator, issue the following command:

1 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.

1 2 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:

1 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:

1 beyond-identity help

The following table provides a list of common commands:

Command Function

Command

Command Function

Command

View the installed authenticator version

beyond-identity --version

Import existing credential

beyond-identity credential import <IMPORT-CODE>

View registered/imported credentials 

beyond-identity credentials

Export credential

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

Delete credential

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