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:
- macOS: version 10.14 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 macOS installation package (.pkg) that will be installed on your local machine. The agent will start and stop with your macOS machine, but you still need to log in to your account before you can connect to your network application.
Double-click the downloaded *.pkg installer to start the installation process.
The installer window will appear and run. Click "Continue."
Choose the disk destination where you want to install the agent software, and click "Continue."
If you want to change the installation location, you can do so in this step. Then click "Continue."
A new dialog will pop up. To allow the installer to install the software on your macOS, enter your credentials and click "Install Software," then click "OK."
Once the installation is complete, a notification for "Background items added" will pop up, and the "Safous Agent" will automatically run and appear in your menu bar.
You can click "Close" in the installer and choose whether you want to keep or remove the package installation file (*.pkg).
To use the Safous Agent, you can simply right-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 right-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 "netstat" 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 "utun*" is present, and the routing has been added to the destination.
