Install the ISA App on Linux (GUI)

Prerequisites for Installation:

1. Users must have sudo access to the system in order to install the ISA App

2. During installation, the system should have access to the InstaSafe libraries and Linux repositories/mirrors so that the relevant packages could be downloaded over the internet

3. It is recommended to carry out an 'apt update' or 'yum check-update' depending on the Linux distro used, in order to download and update package information from all configured sources 

Note:
1. The Linux installation file of the ISA App is unique to every user profile, unlike Windows, Android or iOS where the installer is common across all users of the organization

2. This Article provides guidance on how to install the ISA App on Linux GUI. The guide on installing the ISA App on Linux CLI could be found here

3. The ISA Linux GUI App is presently available only for Ubuntu, CentOS, and RHEL

Step 1: Login to the ISA Portal

Once the Administrators of your organization provision your User Profile in the InstaSafe Secure Access (ISA) Management Console, a Welcome Email would be sent on your registered email ID. Click on ‘Company Signin’.

 

The ISA portal (https://<<company>>.instasafe.com) specific to your organization would open up. You could make use of the credentials provided by your organization's Admins to login to the portal.

In case Two Factor Authentication has been configured, an OTP will be sent to your registered email ID and mobile number which would need to be entered in order to proceed.

Depending on the type of deployment setup opted for by the organization, these credentials may either be the Domain Credentials (synced with the corporate IAM) or created locally in the ISA Management Console by the Admins. In some cases, the Admins might even allow users to set their own ISA passwords. In this case, users would receive an email through which they could set their own passwords, in addition to the regular 'welcome email'. 

It is expected that the Admins convey this information to all users of the organization that would be making use of the ISA solution.

Users that are locally provisioned can change their passwords within the ISA portal once logged in.

Step 2: Download the ISA App

Once logged in, you can download the respective installation file depending on your device OS. This guide focuses on the Linux GUI Installation of the ISA App.

Click on 'Linux' to download the Linux executable file (shell script) of the ISA App.

The installation file for Linux is unique to every user, and tied to the user profile. The installer downloaded for one user must not be used for installation by another user.

Step 3: Install the ISA App

Locate the downloaded Linux shell script in File Manager.

Right Click anywhere in the open File Manager window and click 'Open in Terminal'.

In the Terminal window that opens up, type in the command "sudo sh <filename>.sh" without the inverted commas and replace <filename> with the name of the downloaded shell script file

Then hit 'Enter'. You may be prompted for sudo credentials in order to proceed with the installation.

Once completed, you should receive the message 'Installation Complete'.

Step 4: Connect the ISA App

Go to Applications and double click 'InstaSafe Agent' to launch the ISA App.

In the UI that opens up, click on 'Connect.

Depending on the Authentication Type configured for your profile in the InstaSafe Management Console by your organization's Admins, you may or may not be prompted for Authentication. This guide focuses on the 'Password + Certs' Authentication Type that would prompt for Authentication in order to connect the ISA App

Enter your credentials (same as the one used to login to the ISA portal) in the window that pops-up.

In case Two Factor Authentication has been configured, an OTP received on your registered email ID and mobile number would need to be entered.

Once the Authentication is successfully completed, the ISA App will Connect.

The InstaSafe logs can be viewed by entering the command "sudo cat /var/log/instasafe*" without the inverted commas in Terminal. These logs indicate the connection status and are useful for troubleshooting any issues that might crop up.

The InstaSafe IP assigned can be checked by using the "ifconfig" command in Terminal.

With the ISA App connected, you should now be able to access your organization's internal applications as per the Access Policies defined.

It is expected that the Admins of the organization provide all users a list of their individual network entitlements, the respective FQDNs/IP Addresses of the application servers and their login details.

In case you are unable to install the ISA App by following these steps, please contact your organization's IT Team

If you are an Admin of the organization's ISA Account and need assistance, contact InstaSafe Support

• Related Articles

• Install the ISA App on Linux (CLI)

  Prerequisites for Installation (Users): 1. The User must have sudo access to the system in order to install the ISA App 2. During installation, the system should have access to the InstaSafe libraries and Linux repositories/mirrors so that the ...

• Reconfigure the ISA App on Linux (GUI)

  The ISA App must always be associated with a User Profile in order to connect successfully. This Article provides guidance on how to configure a new User Profile on a device where the ISA App is already configured for another user. Such a need would ...

• Install the ISA App on Linux (CLI) - MyInstaSafe

  Prerequisites for Installation (Users): The User must have sudo access to the system in order to install the ISA App Step 1: Login to the ISA Portal URL: https://my.instasafe.net If you are unsure about the credentials to login, please contact your ...

• Uninstall the ISA App from Linux (GUI)

  This Article provides guidance on how to uninstall the ISA App from Linux GUI. The User must have sudo access to the system in order to uninstall the ISA App. Step 1: Stop the InstaSafe Service Open Terminal and run the command 'sudo service ...

• Reconfigure the ISA App on Linux (CLI)

  The ISA App must always be associated with a User Profile in order to connect successfully. This Article provides guidance on how to configure a new User Profile on a device where the ISA App is already configured for another user. Such a need would ...