Requirements
To download and use the agent, you need to ensure the following:
- A user account that has been created by an admin. Please refer to here.
- The user is already enrolled in MFA and can log in properly. Please refer to here.
- Your favorite web browser to open the User Portal and download the agent.
Please also note the OS requirements to download and install the agent:
- Ubuntu/Debian: version 18.04 or newer
Download Agent
- Once the user logs in to the user portal, they can download the agent by clicking "Download Agent."
- Download agent file based on your operating system
Agent Installation
This is a Linux installation package (.deb) that will be installed on your local machine. The agent will start and stop with your linux machine, but you still need to log in to your account before you can connect to your network application.
Check the downloaded *.deb installer to start the installation process.![](https://support.safous.com/hs-fs/hubfs/image-png-Jul-20-2024-07-18-48-0363-AM.png?width=882&height=241&name=image-png-Jul-20-2024-07-18-48-0363-AM.png)
Open terminal and go to the directory where agent file downloaded
![](https://support.safous.com/hs-fs/hubfs/image-png-Jul-20-2024-07-21-07-5155-AM.png?width=890&height=184&name=image-png-Jul-20-2024-07-21-07-5155-AM.png)
Start agent installation using below command and once the installation is complete, output like below will be shown.
:~$ sudo dpkg -i <agent-file-name.deb>
Check and click to open agent in applications menu
To use the Safous Agent, you can simply left-click on the Safous Agent icon in the menu bar and click "Sign-in." It will open a new browser tab to access your Safous tenant user portal.
When you have successfully verified your account and MFA, the "Device Connected" page will be shown. To verify the agent connection status, you can also check it by left-clicking the Safous icon again in the menu bar. Your logged-in user and MFA status will be shown there.
To ensure the connection is properly established, please also check the routing tables in the terminal using the "route" command.
This is the condition before and after the agent is connected:
- Before Connected: Only two interfaces are present, and the routing is normal.
- After Connected: An additional interface "tun0" is present, and the routing has been added to the destination.