Timus Connect App for macOS® User Guide

This document is a guide explaining the use of the Timus Connect for macOS® application.

This application secures your connection by establishing an encrypted tunnel to the Timus Platform.

Timus Connect App supports macOS Monterey or higher versions.

Login

When installing Timus Connect App for the first time, the account must have administrator permission in order to install the application onto the device.

If Timus Connect App's background service is completely stopped for any reason, administrator permission will be required to access the application.

Administrator permission is not required for version updates.

  • Launch the application. You will see the End User License Agreement on the screen.

  • After reading the EULA by scrolling down, you will see I have read and agre to the EULA at the bottom of the agreement. Once you click on it, you will see the email field to sign in the Timus Connect Application on macOS

  • The login screen will appear. Enter the e-mail address of your Timus account.

  • In the next screen, Select a Network and enter your Password to login. If there is only one network, that network will be selected automatically.

If this account is synchronized from a directory service like Microsoft Entra ID(Azure AD), Okta, or Google Workspace, at this moment the login screen will be forwarded to the login screen of that directory service.

  • If you check the Keep me logged in option on this screen, the app keeps your login information for your next login.

If you trigger a user sign-in policy of Timus Manager with a behavior when you try to login, you may encounter a different authentication method like two-factor authentication.

The screen that opens is the application's main screen, you will see the following menu items:

  • Connection

  • Account

  • Settings

  • Support

Connection

Follow the steps below to establish a connection by using the Timus Connect Windows application:

  • Enter the login information provided by your company to connect you to the screen.

  • The Gateway/Connection screen will appear.

  • Here, you will need to select the Gateway. In the gateway selection list, the active sites to which the user is allowed to access will be available.

The round-trip traffic duration to each active gateway will be displayed next to the gateway. The lower the duration, the faster the connection.

  • If you want the application to select the gateway for the fastest connection by default, choose Select Fastest.

  • If you want to connect via a specific gateway, select this gateway from the drop-down list.

  • Click Connect and wait for the connection to be established. Connection information will be updated when Connected.

  • On the connection status screen, you can see the connection status, Private IP Address, and Public IP Address information.

  • To disconnect click on Disconnect.

Account

On the Account menu, you can

  • View your account name,

  • Manage Account to change your password and send a request to the admin regarding Always-on VPN disconnection,

  • Sign Out to end your login session.

Settings

On the Settings menu,

  • The Start on Boot feature allows the application to start when the operating system boots,

  • Connect on application start feature allows you to connect to your gateway automatically when you turn on your macOS,

  • With the Change tunnel mode feature, you can change the tunnel mode of VPNs such as WireGuard and OpenVPN.

If you are unable to modify or turn features on or off, it indicates that the administrator has closed that feature to user selection based on their preference.

Split tunnel configuration works on macOS when the tunnel protocol is WireGuard.

On the Support menu, you can

  • Install certificate,

  • Give feedback,

  • Collect logs: When you click this button, a file containing application and system logs will be created in the file patch you specified. This file will mainly be used for support purposes when necessary.

Once you have any isues with the Timus Connect Application, you click on Collect log. it will want you to select a folder to create a log file, which will have all the .log files needed for troubleshooting. You can send the file to one of our technical support specialists to have it analyzed.

You will get a notification message as shown in the image below once you click on Collect log. This process can take up to 10 seconds.

Once the log file has been successfully created, you will see the pop-up message as shown in the image below.

To install an SSL Certificate, follow these steps:

The SSL Certificate can be installed by clicking "Install Certificate" on the Support menu. However, in order for the SSL Certificate to function properly, its trust settings must be configured as follows.

  1. Navigate to the 'Applications' folder on your Mac. You can use Finder to find 'Application'.

  2. Inside the 'Applications' folder, find and open the 'Utilities' folder.

  3. In the 'Utilities' folder, select 'Keychain Access'.

  4. Once 'Keychain Access' is open, locate the search box at the top right corner.

  5. In the search box, enter the name of your SDN. In this example, our SDN name, which is the company name, is TimusNetworks. Please make sure that you enter your SDN name correctly into the search box.

  6. The corresponding certificate will appear in the search results. Select it.

  7. After opening the certificate, find and select the 'Trust' option. The detail page will be opened automatically. Please make sure that you have chosen the Trust on the dropmenu.

  8. In the 'Trust' settings, change the status to 'Always Trust'.

Please note that altering the trust settings of any certificate should be done with caution. Always ensure that the certificate is from a reliable source.

Last updated