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
- The User must have sudo access to the system in order to install the ISA App
- 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
- 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
- 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
- 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
- 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://<
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
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
- Users must have sudo access to the system in order to install the ISA App
- 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
- 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
- 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
- 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://<
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
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://<
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://<
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 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 ‘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
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'
'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
The ISA App will now attempt to connect
Once successfully connected, a message 'Connection Secured!' 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