Timus Connect App for macOS® User Guide

The Timus Connect for macOS application allows your users to establish a secure, encrypted tunnel between their devices and your corporate network. It supports posture validation, policy enforcement, and ensures seamless access to protected resources across distributed environments.

Timus Connect is compatible with macOS Monterey (12.0) and later versions.

You can download the installer from Manager → Settings → Agent Deployment → Downloads screen. Alternatively, users can access the same version from Timus My → Downloads screen.

When installing Timus Connect for the first time, the user account on the macOS device must have administrator privileges. Administrator rights are not required for future updates.

Installation & Sign-In Flow

To install Timus Connect on a user’s macOS device:

  1. Download the Installer

    Navigate to the Downloads in Timus My and select the latest macOS version.

  2. Launch the Application

    After installation, launch Timus Connect. The user must read and accept the End User License Agreement (EULA) before proceeding.

  3. Enter Timus Account Email

    The user must enter their Timus account email address to initiate authentication.

  4. Authenticate and Select Network

    • If the account is directory-synced (e.g., Microsoft Entra ID, Okta, Google Workspace), the user will redirect to the corresponding identity provider to complete sign-in.
    • Otherwise, the user will be prompted to select a network and enter their password.

Establishing a Connection

Once signed in, the user is directed to the Connect screen.

  1. Select a Gateway

    All gateways associated with the user’s authorized sites are listed here. Each gateway includes a real-time round-trip latency metric to assist in selecting the most optimal connection point.

  2. Use the “Select Fastest” Option

    Automatically selects and connects to the gateway with the lowest latency.

  3. Connect

    Clicking Connect establishes the secure tunnel between the user’s device and the selected gateway.

Agent Settings

The Settings tab in the Timus Connect application allows to configure how the agent behaves on the user’s device. These configurations are managed through Agent Profiles in the Manager portal and can be optionally exposed for user-level control.

You can define and assign custom Agent Profiles to your users through the Manager portal.

Go to Agent Profile Guide

  1. VPN Protocol Selection

    Choose the tunnel protocol used to establish the connection:

    • WireGuard
    • OpenVPN

    If Smart Tunnel Protocol Fallback is enabled, the application will automatically attempt the alternative protocol if the selected one fails.

  2. Startup Behavior

    • Start on boot: Automatically launches the Timus Connect application when the user’s device starts.
    • Connect on application start: Automatically initiates a connection to the last used or default gateway upon launch.
  3. Network Optimization

    • Smart tunnel protocol fallback: Maintains high availability by switching protocols in case of failure.
    • Adaptive MTU adjustment: Dynamically adjusts the MTU to prevent packet fragmentation and optimize throughput.
    • Automatic update: Keeps the agent up-to-date by silently applying the latest versions in the background.

    *Users can modify these settings if the “Users can modify“ ***setting is enabled in their assigned Agent Profile.

Support Tools

The Support tab in the Timus Connect application provides essential tools for troubleshooting, diagnostics, and SSL certificate management.

  1. Install certificate

    Installs the required Timus SSL Root Certificate to the device. This enables:

    • Trusted communication with internal systems and gateways
    • Full functionality of features such as traffic inspection and secure tunnel setup
  2. Give feedback

    Users can submit feedback or suggestions directly to the Timus team. Submissions include device metadata to provide helpful diagnostic context.

  3. Collect logs

    Generates a compressed ZIP file containing system and agent logs. The user is prompted to select a location for saving the file. This file can then be sent to you or the Timus support team for investigation.

  4. About:

    Displays application version and device metadata useful for technical troubleshooting.

Manual Certificate Installation (If Needed)

If SSL certificate installation fails or users encounter trust-related warnings:

  1. Open Keychain Access from Applications → Utilities.
  2. In the search bar, type the name of your SDN.
  3. Locate and double-click the corresponding certificate.
  4. Expand the Trust section and set When using this certificate to Always Trust.
  5. Close the window and enter your macOS password to confirm the changes.

If the issue persists, contact the Timus support team for assistance.

Silent Deployment (Optional)

To deploy the Windows app silently using an RMM or scripting tool, refer to:

Go to Timus Connect for MacOS - Silent Deployment Script

Related to

Updated

Was this article helpful?

0 out of 0 found this helpful

Have more questions? Submit a request

Comments

0 comments

Please sign in to leave a comment.