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

Prerequisites for Admins:

1. The 'Authentication Type' for the user profile must be set to 'Certificate' in the Admin Management Console

2. Please contact InstaSafe Support if you wish to set the 'Authentication Type' as 'Password + Certificate' for the ISA App on Linux CLI systems

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. It would not be possible to login to the ISA Portal from the Linux CLI, even via a command-line web browsing tool like 'link' or 'lynx'. The end-user would need to login to the ISA Portal from a computer with a graphical interface, download the Linux installation file and transfer it to the Linux CLI system

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

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 CLI Installation of the ISA App.

Click on 'Linux' to download the Linux executable file (shell script) of the ISA App. Once downloaded, the installation file could be transferred to the target Linux CLI system.

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 Linux installation file (shell script) of the ISA App 

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

The ISA App will connect automatically. 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 'Certificate' Authentication Type would permit the ISA App to connect automatically every time the system boots up

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

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

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

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

• Uninstall the ISA App from Linux (CLI)

  This Article provides guidance on how to uninstall the ISA App from Linux CLI. The User must have sudo access to the system in order to uninstall the ISA App. Step 1: Stop the InstaSafe Service Run the command 'sudo service instasafe stop' Step 2: ...

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