Linux – Banyan Security

The Banyan Linux Desktop App allows you to register your Linux device so it can start accessing Banyan-secured Services.

The Banyan Desktop App can be downloaded at https://www.getbanyan.app

For Ubuntu 20.04+ users, download the Debian package - DEB
For Fedora 34+ users, download the Red Hat Package Manager - RPM

Prerequisites

Before proceeding through the steps below, please ensure that you have administrative privileges on your Linux device in order to install the Banyan Linux Desktop App.

Ensure the following prerequisites are met:

You must have Chrome installed, set as your default browser, and used for registering your device and connecting to services.
If not already installed, Ubuntu users need to have certutil installed. To install certutil, launch your terminal and run the command sudo apt-get install libnss3-tools

If not already installed, Fedora users need to have nss-tools installed. To install nss-tools, launch your terminal and run the command sudo dnf install nss-tools

Install the Banyan Linux Desktop App

NOTE: If your device is corporate-owned and -managed (using a Device Manager), then these installation and registration steps may be preconfigured and omitted.

To install the Banyan Linux Desktop App:

1. Run the banyanapp .deb or .rpm installer.

2. Click Install and allow the installation to finish.

3. Launch the Banyan Linux Desktop App.

4. Enter your organization's Invitation Code. This Invitation Code is provided offline by your Admin. Then, click Continue.

5. Authenticating with an IDP (such as Okta, G Suite, OneLogin, or other SAML IDP) launches a new browser window. The example below shows an organization using Okta to authenticate its users.

A success message displays.

6. Select the ownership type of the device you are registering.

7. Now that you're authenticated, you can install your organizations' certificates to register your device and access Banyan-secured applications and services.

You can now access Banyan-secured applications and services from your Linux device.

NOTE: Once you have installed the Banyan Linux Desktop App, you can access it at any time via the menu bar.

Comments

3 comments

Fabrizio Cirelli

June 03, 2022 08:29
For Fedora I think it's needed:
```
sudo dnf install nss-tools 
```
Instead of libnss3-tools
1
Tanner Kelley

June 16, 2022 21:02
We will be updating our docs for Fedora specifically tomorrow!
0

Fabrizio Cirelli

August 29, 2022 14:53

I had some unsolvable problems with version 3.2:

[2022-08-29 16:43:52.274] [info]  Installing client certificate
[2022-08-29 16:43:52.408] [info]  Client certificate installed
[2022-08-29 16:43:53.833] [error] Error: Trying to write tokens without secrets.
[2022-08-29 16:43:53.833] [error] Unable to finalize registration There was an error registering your device. Please try again.

I had to rollback to 3.0.
Fedora 36

Please sign in to leave a comment.

Prerequisites

Install the Banyan Linux Desktop App

Related articles