Installing the IDex Client on Your macOS-Based Devices

Supported Configuration

  • Remote connected workstations should use Connect Filter for mac OS instead of IDex Client.
  • Connect Filter for macOS and IDex Client can't be installed together on the same device.
  • Browser: All browser types are supported.
  • Operating Systems: macOS 10.10 and higher.

Prerequisites

  1. If you use a load balancer, you can use the virtual IP address assigned to the Smoothwall Filter and Firewall service as an IDex Client interface, see our help topic, Configuring the web proxy.
  2. Add the nominated interface and TCP port combination for the IDex client to the Smoothwall Filter and Firewall, see our help topic, Adding interfaces for IDex Client. Select only internal (Basic) interfaces, because the IDex Client should only be used in trusted networks. Make a note of:
    • IP address or host name.
    • Port number.
  3. If you use groups to filter your users' traffic, you must use the IDex Directory to map the domain groups to the local Smoothwall Filter and Firewall user groups, see our help topic, Adding an IDex directory.

Procedures

Installing unattended

This method automates IDex Client Installer for your device without needing to open the installer and going through the user interface.

  1. Go to the Download Your Smoothwall Software page and under the IDex Client section, download the installation package by clicking MacOS. and save it to a shared network location.
  2. Open TextEdit and change the format to make it a plain text file.
  3. Replacing the values with the interface details you created in your Smoothwall Filter and Firewall, type:
    • SmoothwallIpAddr={IP address or host name}
    • SmoothwallPort={Port number}
      • For example:
        • SmoothwallIpAddr=192.168.110.1
        • SmoothwallPort=12345
  4. In the shared network location where you saved the installation package, save the file with the name: idexclient.settings.
  5. Open Terminal and type the command: sudo installer -pkg smb://my-fileshare/IDexClient_macOS.pkg -target /

Installing with installer user interface

This method requires you to run the installation on each individual network device.

  1. Log onto the macOS device that you want to install the IDex client on and go to the Download Your Smoothwall Software page. Under the IDex Client section, download the installation package by clicking MacOS.
  2. After the package has downloaded, to run the installer, double-click the installation package:
    Note: The installation package doesn't have a signed certificate so you might need to adjust your security settings to open the package anway.
    1. On the Introduction page, to begin the installation process, click Continue.
    2. On the Software License page, click Continue and on the dialog box that opens, click Agree to the terms and conditions.
    3. On the Installation Type page, to begin software installation on the selected disk, click Install.
    4. In the dialog box, type your administrator password and click Install Software.
      • You might be required to allow the install additional access, in the dialog box, click OK.
    5. In each of the two dialog boxes that open, type the interface connection details that you added for the IDex client in the Smoothwall Filter and Firewall and click OK:
      • IP address or host name
      • Port number
    6. Once installation has completed, on the Summary page, click Close.

You do not need to restart the device to complete the installation.

Users won't see an icon in the system menu bar for the IDex client.

Installing using a mobile device management (MDM) solution

You can also use a MDM to deploy to your managed devices. For example Jamf Pro, see the official Jamf documentation, Jamf Pro Administrator's Guide.

Follow-Up Tasks

  • To redirect web traffic from the browser to the IDex client, make sure that the proxy settings of your network devices are set to: localhost:8080