The steps below describe a command-line installation of WebTitan OTG for Mac on a single machine. You need admin privileges for a machine to complete these steps.

During installation, you will be required to:

  • Run two separate commands:

    1. An install command to deploy the .PKG file.

    2. A WebTitan configuration command that you must edit with your own parameters. The steps below provide a sample script that you can edit with your own parameters.

  • Allow a WebTitan system extension under the General tab in Security & Privacy Preferences.

  • Allow the DNS Proxy Configurations pop up. A DNS proxy provider is a network extension that implements DNS proxying. WebTitan OTG for Mac uses the DNS proxy provider to forward DNS requests to the OTG DNS server, which records the DNS requests. For privacy reasons, a user must give consent to enable it.

Step 1: Download and install your WebTitan 4K certificate.

If an SSL certificate has not been installed and a user visits an HTTPS enabled website that is blocked by a policy, their browser will return a certificate error page instead of your WebTitan block page. To avoid this, download and import the WebTitan SSL Certificate.

  1. In WebTitan, go to Settings > Certificates and download a 4K WebTitan SSL certificate.

  2. Install the certificate to your Mac keychain. See https://support.apple.com/en-ie/guide/keychain-access/kyca2431/mac small_external_link.png.

    Ensure When using this certificate is set to Always Trust as shown below:

    OTG-Mac2-cert-keychain.jpg

Step 2: Download and install WebTitan OTG for Mac.

Ensure you have administrative privileges, then follow the steps below to install WebTitan OTG for Mac.

  1. Click here to download the WebTitan OTG for Mac install file (otg_setup.pkg). The current version of OTG for Mac is 2.0.3 (2). You need to know what folder this install file saves to in later steps.

  2. Retrieve the OTG install key from your WebTitan Cloud. Go to Settings > Device Configuration and note the OTG Install Key:

    WT-SL-OTG-install-key.jpg

  3. Create the command script for installation. Base your script on the example shown below, but with parameters edited for your WebTitan.

    /Applications/WebTitanCloud.app/Contents/MacOS/WebTitanCloud RPC_URL="https://your-otg-url.webtitancloud.com" INSTALL_KEY="00000z0z-0zz0-0000-zz0z-0zz000z0zz0z"

    • There are two required parameters described in the table below that must be edited when creating your own script.

    • There is also an optional parameter described that you can use during installation, but it is not necessary.

    • The command must be on a single line with no line breaks.

    Required Parameter

    Description

    Example

    RPC_URL

    Your WebTitan OTG URL and (optional) port number. See WebTitan OTG URLs to determine your OTG URL.

    The RPC port is always port 7771 and is automatically added if not included in the RPC_URL parameter. The example(s) show the accepted formats.

    https://your-otg-url.webtitancloud.com

    INSTALL_KEY

    This is the OTG install key used to register an OTG device on WebTitan. You can get this in WebTitan from Settings > Device Configuration and noting the OTG Install Key.

    00000z0z-0zz0-0000-zz0z-0zz000z0zz0z

    Optional Parameter(s)

    Description

    Example

    LOCATION_NAME

    When OTG 2 is installed, a virtual location is automatically created for a device on WebTitan and given a default name. However, you can specify a location name to use with the LOCATION_NAME parameter on install.

    A virtual location can either be created on WebTitan before installation and then the name can be used in this parameter, or, if not already created, the virtual location is created and assigned the name given in this parameter on install.

    LOCATION_NAME=Training-PC

  4. Open a terminal and change directory to the same directory as the install file you downloaded in Step 1. To change directory, type cd followed by the file path you want to change to. For example:

    cd ~/Downloads

  5. Run the following command script to initiate installation: sudo installer -pkg otg_setup.pkg -target /

  6. Enter your admin password if prompted.

  7. You need to allow WebTitan in your System Preferences:

    • If prompted, click Open Security Preferences:

      OTG-Mac2-install-extension-blocked-popup.jpg

    • If not prompted, open manually from System Preferences > Security & Privacy.

    • Click the lock OTG-Mac2-lock-icon.jpg icon in the bottom left of the Security & Privacy window to unlock settings.

    • Enter your admin password if prompted.

    • Click Allow to unblock WebTitan.

    • Click the lock icon again to re-lock settings.

  8. Copy and paste the install script you created in Step 3 into the terminal window and press Enter.

  9. Click Allow to allow DNS proxy configurations if prompted:

    OTG-Mac2-add-proxy-configurations.jpg

  10. When installation has successfully completed, a WebTitan WTC-OTG-Mac-icon.jpg icon displays in your top menu bar showing Status: Connected.

Once the steps above are complete, the best way to verify the installation is to check that a device and the associated user and location have been added to WebTitan.