It seems like your browser didn't download the required fonts. Please revise your security settings and try again.
Barracuda Content Shield

How to Download and Install the Barracuda Content Shield Agent for macOS

  • Last updated on

The Barracuda Content Shield Agent for macOS supports High Sierra 10.13.4, Mojave 10.14.6, Catalina, and Big Sur. For endpoint computers that use Firefox, Barracuda Content Shield Agent requires Firefox 68.0 or later.  

The Barracuda Content Shield Agent for macOS includes the Web Filtering Component (WFC), which applies policies you create on the Advanced Filtering page to endpoint web traffic. The agent is installed manually on endpoint machines as described below. For endpoint computers that use Firefox, Barracuda Content Shield Agent requires Firefox 68.0 or later.

Installation

  1. From the endpoint machine, log into your Barracuda Content Shield account.
  2. Go to the Downloads page. You will need to download two files from this page in order to perform the BCS installation, and Barracuda Networks recommends saving both files in the same folder/location on your computer (though the browser will probably store both files in the Downloads folder).
  3. First, click Account Configuration File to download the key file. Click Save File if you are prompted by your browser to do so. This file is named bcs.key, and the installer wizard will prompt you to locate this file during the installation process.
  4. Next, click Download for the macOS Agent installer. Click Save File if you are prompted by your browser to do so. The file is named BarracudaContentShieldSetup-[version].dmg. 
    Open the BarracudaContentShieldSetup-[version].dmg file, which loads a popup with the Barracuda Content Shield Installer.pkg and the WFC Uninstaller. Run the Barracuda Content Shield Installer.pkgIf you are running macOS Big Sur, you will first be prompted to click Allow for the installer to verify that the software can be installed. Accept the license agreement, and follow the prompts in the wizard to install. 

  5. On the Account Settings screen of the wizard, click Select account file to browse for the bcs.key file.

    Installer - 1 Key.png
      

  6. Click Continue, then click Install. You will be prompted for the Mac administrator password.

    Installer - 3 Admin.png

     

  7. Proceed based on your macOS version: 

    • If you are running High Sierra 10.13.4, Mojave 10.14.6, or Catalina: The Barracuda Content Shield Agent installation is now complete. Skip to Step 12 below.

    • If you are running Big Sur: You will be prompted to approve additional configuration changes. Continue to Step 8.

     

  8. For Big Sur installations, the  Barracuda Content Shield installer registers a system extension, which the system blocks until an administrator approves it. Click Open Security Preferences to open the Security & Privacy panel.

    SystemExtensionBlocked.png

    Note that the installer does not complete until you either approve  the extension or dismiss the dialog. If you dismiss the dialog, the install will succeed, but the proxy application will be launched automatically and prompt you to finish configuring the software.


  9.  In the Security & Privacy panel shown below, you must click the lock button in the lower left and then enter an administrator password.

    Installer - 5 Security Panel.png

     

  10. After unlocking the Security & Privacy panel, the Allow button is enabled and the software can be approved. Once allowed, the message will disappear and the system knows that BCS is trusted.

    SecPrivacyUNLOCKED.png

  11. Next you will be prompted to add a VPN network configuration. Click Allow to finish the installation. 

    Installer - 7 Network Config.png

  12. The final installer window displays. If you did not complete configuration of the proxy extension and network, you must finish those steps before the Barracuda Content Shield agent becomes active. Launch the proxy application and complete configuration as described in the next section.  

    Installer - 8 Installer Success.png

    Important:
    When the installation is complete, the installer will prompt you to either Keep or Move the installer file to the Trash, as shown below.
    If you move the installer file to the Trash, you will not be able to uninstall the agent without downloading the installer again. Barracuda Networks recommends keeping the installer file in case you want to uninstall the agent in the future.
    If you need to find the uninstaller, it is usually stored here: /Library/Application Support/Barracuda/Content Shield/wca/BCS Uninstaller.app

    KeepOrTrash.png

Proxy Application Prompts

If you do not complete the configuration during the install, you can launch the Barracuda Content Shield.app that has been installed and follow the prompts to finish the process at any time. When launched the first time, the proxy application shows the current status and a number of steps that must be completed to finishing configuring the BCS agent.

The screenshot below shows what you will see if nothing has been configured. If the software is completely configured, then each step will be checked and the buttons dimmed. 

BCS Unapproved 0.png

To finish the configuration:

  1. Click Load System Extension to register the system within the application bundle.
    The proxy application tries to load (register) the proxy extension, and the system blocks the attempt. You are prompted to manually allow the extension. Click Open Security Preferences to open the appropriate panel. If, instead, you click OK, you must click Approve System Extension  to complete the next step.

    BCS - 2 Load Dialog.png

     

  2. From the Security & Privacy panel, you must first click the unlock button. You are then prompted to enter administrator credentials so you can change the system settings. Note the system message at the bottom of the Security & Privacy panel.


    Installer - 5 Security Panel.png

  3. Once unlocked, click Allow to complete this step of the approval process.

    SecPrivacyUNLOCKED.png

  4. Returning to the Barracuda Content Shield application, you must click Add VPN configuration.

    BCS Unapproved 2.png

  5. You will be prompted with a dialog to add this configuration, and must click Allow to complete this step. The new network configuration then appears in the Network panel of the System Preferences, and is called Barracuda Content Shield.


    Installer - 7 Network Config.png

  6. After each task completes, the corresponding step is checked and dimmed out as shown below. The software is now configured and active. Next, quit the Barracuda Content Shield application. 

    Note that the proxy application does not need to be running in order for BCS to perform traffic filtering. The launch agent and the proxy extension are automatically launched at startup, and run silently in the background.

    BCS - Approved.png

Verify that the BCS Web Filtering Component (WFC) is Running 

To verify that the BCS WFC is installed and running, you can launch the Mac Activity Monitor and search for wca_proxy. Ensure that you are viewing All Processes; otherwise, the agent process will not be displayed.

activity_monitor.png

Best Practice: If you are using the BCS agent with a DNS proxy solution, do the following:

In the DEFINE ALL LOCAL DOMAINS section of the Agent Settings page, enter local domains in the LOCAL DOMAINS text box. The BCS agent will resolve the domains configured here using the DNS Server configured on the endpoints.

Uninstalling the Agent

  1. Open the BarracudaContentShieldSetup-[version].dmg file, and then double click on the WFC Uninstaller. You will be prompted for the Mac admin password. Clicking cancel will abort the uninstall process entirely and jump to the last screen.
  2. Next, the uninstaller will try to remove the proxy application. This operation may be blocked by the system, because of the hosted system extension, and you need to again enter a password to continue.
    Uninstaller - 3 Remove App.png
  3. Finally, the uninstaller needs to remove the rest of the BCS components, such as the launch agent. Clicking Cancel aborts the uninstall process.


    Uninstaller - 4 Run Script.png

  4. If the uninstaller completes, you will see this dialog:

    Uninstaller - 5 Success.png

    If you clicked Cancel, you will see this dialog:

    Uninstaller - 6 Cancelled.png