Safous Agent is needed to be downloaded and installed in users local PC/Laptop/Desktop for accessing Network-based application in your environment. In short, the functionality of Safous Agent is like Client based VPN Agent that will connected local machine to the specific network but with more control.
Requirements
To download the agent and use it, you need ensure these things:
- User that is already created by admin, please refer to here
- User already enrolled the MFA and can login properly, please refer to here
- Your favorite web browser to open User Portal and downloads the agent
Also please note this OS requirement to download and install the Agent:
- MacOS : version 10.14 or newer
- Windows : version 7 SP1 or newer
- Ubuntu/Debian : version 18.04 or newer
Agent Installation
Once the user login to the user portal, they can download it y clicking "Download Agent"
There are several types of Agent:
- Windows Portable Agent (x86 & amd64)
- Windows Agent Installer (MSI)
- MacOS Agent
- Linux Agent (amd64 & arm64)
Windows Portable Agent (x86 & amd64)
This is an executable files, which won't be installed in your local machine, but like a portable files that needed to be run whenever you want to connect to your Network application.
When you click the executable files it will asked User Account Control verification to execute it.
Choose "Yes"
It will open new browser tab to access to you Safous tenant user portal
When you successfully verified your account and MFA, the "Device Connected" page will be shown
Windows will asked your permission to allow access in the firewall to make same changes, click "Allow Access"
Click on your windows tray icon and checked whether the agent already running or not
Click on the agent Icon and, then check the status of the agent already logged in using the correct username & MFA or not
To ensure the connection already established, please also check the routing tables in the windows like using "route print" command in windows command prompt
This is would be the condition before the agent connected and after:
-
- Before Connected ==> Only have 2 interfaces and the routing is normal
- After Connected ==> An additional interface and the routing being added 1 destination
- Before Connected ==> Only have 2 interfaces and the routing is normal
Windows Agent Installer (MSI)
This is a full fat installation package which will be installed in your local machine. This agent will start and stop with your windows machine, but you still need to login to your account before you can connected to your Network application.
When you click the *.msi installer, windows will give security warning.
Choose "Run" to proceed
The installer window will show and run, click “Next”
Please input your Safous tenant URL like https://demo.ztna.safous.com, then click “Next”
Confirmation page will be shown, just click “Next” to start installation process
Next the UAC windows will pop-up for confirmation, click “Yes”
Once the installation process finished, close the installer and you could find the “Cyolo” icon in your desktop
Double click the “Cyolo” icon on your desktop and the agent will open you taskbar icon tray
Right click on “Cyolo” taskbar icon tray and choose “Sign-in with browser”, which will open your browser and redirect you into Safous user portal which you need to authenticate
It will open new browser tab to access to your Safous tenant user portal
When you successfully verified your account and MFA, the "Device Connected" page will be shown
Click on the agent Icon and, then check the status of the agent already logged in using the correct username & MFA or not
To ensure the connection already established properly, please also check the routing tables in the windows like using "route print" command in windows command prompt
This is would be the condition before the agent connected and after:
-
- Before Connected ==> Only have 2 interfaces and the routing is normal
- After Connected ==> An additional interface and the routing being added 1 destination
- Before Connected ==> Only have 2 interfaces and the routing is normal
MacOS Agent & Linux Agent
The installation process of MacOS Agent and Linux Agent is not much different with installation of Windows agent, thus you can follow the same instruction.