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 typically arise in cases where company-owned devices are re-assigned.
In order for a new User Profile to be configured on the device, the earlier installation and User Profile must first be removed.
Prerequisites for Installation (Users):
1. The User must have sudo access to the system in order to install the ISA App
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
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
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
Step 1: Stop the InstaSafe Service
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 /var/log/instasafe*.log'
Step 4: Login to the ISA Portal
Login to the ISA portal (https://<<company>>.instasafe.com) specific to your organization. You can 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 5: Download the ISA App
Once logged in, you can download the ISA App Linux installer
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 6: 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 7: 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 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 (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)
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 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 ...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 ...