Skip to content

End User Guide

ISA Agent Installation

Install the ISA Agent (MSI) on Microsoft Windows

This Article provides guidance on how to install the ISA Agent (MSI) on Windows.

Step 1: Install the ISA Agent

The Administrators of organization's InstaSafe Secure Access (ISA) account will provide you with the MSI package to install the ISA App along with the appropriate credentials to be used. Run the ‘InstaSafe-Agent.msi’ file by simply double-clicking it.

Step 2: Configure the ISA Agent

Once the installation is complete, locate the InstaSafe Folder. Windows 64 Bit path: C:\Program Files (x86)\InstaSafe\ Windows 32 Bit path: C:\ProgramFiles\InstaSafe\ Navigate to the ‘bin’ folder. Right click the file ‘clientconfig.exe’, and select 'Run as Administrator'

You would now be prompted to enter the Login URL unique to your company. This would typically be <>.instasafe.com where <> would be replaced by organization's name as provisioned in the ISA portal. In case of any clarifications needed with regards to this, please reach out to the Admins of your organization.

Enter your credentials in the window that pops-up to configure the ISA App with your profile.

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 (https://<>.instasafe.com).

Once the credentials have been correctly entered, the below confirmation message will show up. Click on 'OK' to proceed.

Step 3: Connect the ISA Agent

A shortcut named 'InstaSafe Agent' should be created on the desktop.

Double click and run, to launch the UI of the ISA App.

Depending on the 'Authentication Type' selected by the Admins, users might be prompted to enter their credentials in order to connect the ISA App. 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. This would need to be repeated each time you wish to connect.

The ISA App would now be launched and an icon bearing the InstaSafe Logo should show up in the notification tray of the task-bar at the bottom right corner of the desktop.

Double click the icon to bring up the real time connection status. The real time connection status displays several logs that are useful for troubleshooting any issues that might crop up.

Once connected, a notification banner should get displayed at the bottom right corner of the desktop. It would also mention the ISA IP assigned.

With the ISA App connected, users would be able to access their 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.

Install the ISA App on Microsoft Windows

The below steps provide guidance on how to install the ISA Agent on Windows.

The ISA App is unique to every organization. The windows installer for an organization would only work for users provisioned in that specific ISA Account. Elevated Admin Privileges along with internet access would be required at the time of installation.

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://<>.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 Windows Installation of the ISA App.

Click on 'Windows' to download the Windows executable file of the ISA App.

In some cases, the Admins might silently deploy and install the ISA App on the end-points using GPOs or an SCCM. In such a scenario, users might only be required to configure the ISA App with their credentials on their respective devices. However, that is out of scope for this guide.

Step 3: Install the ISA App

Run the downloaded executable file (as Administrator)

Click on ‘I Agree’ to accept the License Agreement and begin the installation.

Click on ‘Close’ once the installation is complete.

Step 4: Configure the ISA App

Enter your credentials (same as the one used to login to the ISA portal) in the window that pops-up to configure the ISA App with your User Profile

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.

Once the configuration is complete, this confirmation message will show up.

Click on 'OK' to proceed.

Step 5: Connect the ISA App

A shortcut named 'InstaSafe Agent' would get created on the desktop.

Double click and run, to launch the UI of the ISA App.

Depending on the 'Authentication Type' selected by the Admins, users might be prompted to enter their credentials in order to connect the ISA App. 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. This would need to be repeated each time you wish to connect. The ISA App would now be launched and an icon bearing the InstaSafe Logo should show up in the notification tray of the task-bar at the bottom right corner of the desktop.

Double click the icon to bring up the real time connection status. The real time connection status display several logs that are useful for troubleshooting any issues that might crop up.

Once connected, a notification banner should get displayed at the bottom right corner of the desktop. It would also mention the ISA IP assigned.

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.

Install the ISA Agent on macOS

The below steps provide guidance on how to install the ISA App on macOS.

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://<>.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 macOS Installation of the ISA App.

Click on 'MacOS' to download the shell script installer of the ISA App.

The installation file for macOS 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

Once the installation file has been downloaded, head over to the ‘Downloads’ folder.

Right-click the downloaded file,InstaSafe-Agent-user name.sh, click ‘Open With’ and select ‘Other’.

Select the application ‘Terminal’ and click ‘Open’

Click on 'Agree’ to accept the License Agreement and begin the installation

Double click the file InstaSafe.dmg in the new window that opens up and enter your local system administrator account credentials if prompted.

The ISA Agent 'Instasafe' will now show up under 'Applications'.

This could be copy-pasted to the desktop for easy access.

Step 4: Connect the ISA App

Double click and launch the ISA App. 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.

Install the ISA App on Linux (CLI) - MyInstaSafe

Prerequisites for Installation

  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
  4. The 'Authentication Type' for the user profile must be set to 'Certificate' in the Admin Management Console in order for the ISA App to connect as expected

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

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://<>.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 .sh" without the inverted commas and replace 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.

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

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://<>.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 .sh" without the inverted commas and replace 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.

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

Installing the ISA iOS App

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://<>.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 ISA User Agent depending on your device OS. This guide focuses on the installation of the ISA iOS App.

Clicking on 'iOS' will direct you to the Apple App Store page of the ISA App. The link for this is

In some cases, the Admins might silently deploy the ISA App across company owned devices with the help of a Mobile Device Management solution and we can skip directly to Step 4.

Step 3: Install the ISA App

Click on ‘Get’ to begin installation of the ISA App

Launch the App once installed

Step 4: Configure the ISA App

In order to configure the ISA App with a particular user profile, the following details need to be entered

  • Company: <> which is part of the ISA portal URL for you organization
  • Username: same as the username used to login to the ISA portal
  • Password: same as the password used to login to the ISA portal

Click on 'Login'

'Comapany' and 'Username' fields are case sensitive. Kindly contact the Admin of your organization's ISA account in case the credentials provided don't work.

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.

Step 5: Connect the ISA App

Once logged in, you can connect the ISA App

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

Depending on the 'Authentication Type' selected by the Admins, you might be prompted to enter your credentials in order to connect the ISA App during subsequent connection attempts.

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.

This would need to be repeated each time you wish to connect.

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

Installing the ISA Android App

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://<>.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 ISA App depending on your device OS. This guide focuses on the installation of the ISA Android App.

Clicking on 'Android' will direct you to the Google Playstore page of the ISA Android App. The link to download the app fron Playstore Android App

In some cases, the Admins might silently deploy the ISA App across company owned devices with the help of a Mobile Device Management solution and we can skip directly to Step 4.

Step 3: Install the ISA App

Click on ‘Install’ to begin installation of the ISA App.

Once the ISA App is Installed and launched, click on "Allow' to grant the required permissions.

Without granting these permissions, the app may not function normally. In case this step is missed for some reason, you can always grant these permissions at a later stage from within the App settings.

Step 4: Configure the ISA App

  • Enter the <> which is part of the ISA portal URL for you organization

Click on 'Login'

Enter the username and password

  • Username: same as the username used to login to the ISA portal

  • Password: same as the password used to login to the ISA portal

'Company' and 'Username' fields are case sensitive. Kindly contact the Admin of your organization's ISA account in case the credentials provided don't work.

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.

Step 5: Connect the ISA App

Once the authentication has been successfully completed, you will be taken to the connect page.

Click on the 'Connect' option. Android Security throws up a routine warning message whenever a VPN App tries to connect.

Click on 'OK' to allow the connection

Once successfully connected, 'Connected!' will be displayed.

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

Depending on the 'Authentication Type' selected by the Admins, you might be prompted to enter your credentials in order to connect the ISA App during subsequent connection attempts.

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.

This would need to be repeated each time you wish to connect.

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

Comments