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 typically arise in cases where company-owned devices are re-assigned.

The ISA App for Linux GUI does support multiple User Profiles to be configured on a single device, although only one profile would be allowed to connect at a time. However, that is out of scope for this guide.

In order for a new User Profile to be configured on the device, it is recommended to remove the earlier installation and User Profile first.

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. The ISA App GUI for Linux is presently available only for Ubuntu

Step 1: Stop the InstaSafe Service

Open Terminal and run the command 'sudo service instasafe stop'

Step 2: Remove the InstaSafe Folder

Run the command 'sudo rm -rf /etc/instasafe/'

Step 3: Remove the InstaSafe Log File

Run the command 'sudo rm -rf /var/log/instasafe*.log' 

Step 4: Remove the ISA App

Run the command 'sudo unlink /usr/share/applications/InstaSafe.desktop'

and 'sudo rm -rf /opt/instasafe/'

Step 5: Login to the ISA Portal

Login to the ISA portal (https://<<company>>.instasafe.com) specific to your organization. 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 6: Download the ISA App

Once logged in, you can download the ISA App installer for Linux.

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 7: 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 8: 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 reconfigure 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

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

• Reconfigure the ISA App on Windows

  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, without needing to ...

• Reconfigure the ISA App on MacOS

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

  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, without needing to ...