We use cookies on our website to ensure we provide you with the best experience on our website. By using our website, you agree to the use of cookies for analytics and personalized content.This website uses cookies. More Information
It seems like your browser didn't download the required fonts. Please revise your security settings and try again.
Barracuda Email Security Gateway

Barracuda Outlook Add-In Deployment Guide 6.1.2 and Above

  • Last updated on

If you are running version 6.0.0.028 of the Barracuda Email Security Gateway firmware, you must upgrade your Barracuda Outlook Add-in to version 6.0.21 or later (see the USERS > User Features page).

If you want end-users to use Bayesian classification via this add-in, you must enable Per-User Quarantine on the Barracuda Spam Firewall from BASIC > Quarantine page in the Inbound Quarantine Type section. See also Bayesian Analysis Inbound. This guide applies to the Barracuda Spam Firewall 300 and above, version 6.0 and above.

If the SMTP option Remove Barracuda Headers is turned off in the ADVANCED > Email Protocol page, any custom X-headers that the Barracuda Spam Firewall has applied before the message leaves the appliance will be removed. Important: If these headers are removed, the Barracuda Outlook add-in or other add-in will not function.

Note that the language for add-in options is determined by your Microsoft Office installation locale. Supported languages for the add-in include:

  • English
  • Spanish (continental)
  • French
  • Japanese
  • Dutch
  • Italian
  • Chinese
  • Polish
  • German

Step 1: Install the Outlook Add-In Deployment Kit

  1. Log into your Barracuda Spam Firewall as an administrator.
  2. Navigate to USERS > User Features and download the Outlook Add-In Deployment Kit (a .zip file) to the local system running Windows Vista or above.
  3. Extract the contents somewhere easily accessible. The deployment kit should contain the following:
    • Barracuda Spam Firewall Outlook Add-in installer for Outlook 2010 64-bit or for Outlook 2013 64-bit (BsfOutlookAddIn-version_x64.msi)
    • Barracuda Spam Firewall Outlook Add-in installer for all other versions of Outlook (BsfOutlookAddIn-version_x86.msi).
    • Barracuda Spam Firewall Outlook Add-in Administrator module (Barracuda Spam Firewall Outlook Add-In version.admx 

Step 2. Optional: Configure the Outlook Add-In

If you want to use GPO:

  1. Create a directory on your PC/Server from which you are going to install the add-in. Put the MSI, ADMX and ADML files from the Barracuda Outlook Add-in ZIP file in that directory. Note that the ADML files are in the language folders in the ZIP file.

  2. Copy the ADMX and ADML locale directories to the PolicyDefinitions folder on your system, for example:
    %systemroot%\sysvol\domain\policies\PolicyDefinitions

    This procedure applies to domain controllers running Windows Server 2008 or higher; to edit local policy or domain policies on a domain controller running Windows Server 2003 or earlier, consult Microsoft's documentation.

  3. Start the Group Policy (GPO) Editor for the domain where you will be installing the Add-In. You can edit the default policy or create a new policy object and link it to the desired container, for example, the particular OU containing the computers of users that will be using the Add-In.

    In order to create and edit domain-based GPOs with the latest Group Policy settings using ADMX files, you must have a Windows Server 2008 domain name resolvable through a DNS Server, and a Windows Vista system to view policy settings from ADMX files while editing the domain-based GPO.

    In the GPO, expand User Configuration > Administrative Templates > Barracuda > Spam Firewall > Outlook Add-In:  

    ModifyPolicies.jpg

     Configure any policies as needed. You will need to recreate any policies you previously configured, and then remove the old ADM template.

Step 3. Deploy the MSI File

  1. Open the GPO Editor for the organization that is to use the Barracuda Spam Firewall Outlook Add-in, e.g., the default domain policy.
  2. Either edit the default policy, or create a new policy object, then link it to the desired container. For example, the particular OU containing the computers on which the add-in is to be installed.
  3. In the GPO, navigate to Computer Configuration > Policies > Software Settings > Software Installation :
    GPOEditor.png
  4. Right-click Software Installation, point to New, and click Package:
    GPOSoftwareInstall.png
    Enter the UNC path to the .msi file located in the shared folder. For example, enter: \\fileserver\deploy
    Click Open. In the Deploy Software dialog box, click Assigned:

    Click OK . The policy displays in the GPO Editor window.  
Deploying the Add-In to Machines with 64-bit Windows and 32-bit Outlook

If any of the machines in your environment have a 64-bit version of Windows installed but are using a 32-bit version of Outlook, you will need to deploy the 32-bit MSI to these machines. If you are also deploying the 64-bit MSI for machines with both 64-bit Windows and 64-bit Outlook, then both software deployment policies will apply to the machines with 32-bit Outlook, which will result in both MSIs being installed on these machines. Since Outlook will only load the Add-In that matches its bitness, this should not cause any problems.

  1. In the GPO Editor, navigate toComputer Configuration > Policies > Software Settings , and clickSoftware Installation.
  2. Right-click the 32-bitBarracuda Spam Firewall Outlook Add‑In, and clickProperties.
  3. Click the Deployment tab, and click Advanced. In the Advanced deployment options section, select Make this 32-bit X86 application available to Win64 machines.

    ADvDeployOptionsAddin.png
  4. Click OK. In the Properties dialog box, click Apply, and click OK to to save your settings and close the dialog box.

Finishing the Configuration

After the Barracuda Spam Firewall Outlook Add‑In is installed (either manually or through GPO), there is no initial configured identification with your Barracuda Spam Firewall. This identification happens automatically as the add-in scans the user's inbox for recent messages and inspects each message’s headers for a Barracuda Spam Firewall URI. If none is found, the add-in will monitor the user's inbox for new messages and scan each new message header for a Barracuda Spam Firewall URI. When a Barracuda Spam Firewall URI is found, an authentication probe will be initiated with that Barracuda Spam Firewall. The Barracuda Spam Firewall then sends an authentication probe via email to the user’s email address, and the add-in will intercept the probe, extract the required authentication information contained in the probe, and then delete it. This process is transparent to the user. Once the probe is received, the user is authenticated, and all of the add-in features are available for use. Typically, this process should take no more than a few minutes.

Testing

 Complete the following steps to test the Barracuda Spam Firewall Outlook Add-in deployment.

Group Policy updates can take several minutes to post; run gpupdate /force to perform an immediate update.

  1. Restart a computer that is joined to the domain.
  2. Verify that the Outlook Add-In is installed when you log in, and that the configured policies are applied.

Notify Users

Once the MSI file is successfully deployed, send the Outlook Add-In access details to your users. For additional resources, see the Barracuda Spam Firewall User 's Guide 6.x.

Troubleshooting

  1. A common cause of failure is the user and/or the user's computer does not have adequate access to the share location. Verify that that all access and network privileges have been configured appropriately.
  2. Additional error messages may be found in the Event Log on the domain computer.
  3. If the Event Log has no useful information, consider enabling verbose logging and restarting the computer.

Configure the Add-In from the MS Outlook Client

For Microsoft Outlook 2003 and 2007:

  1. Click Tools > Options.
  2. Click the Barracuda Networks tab.
  3. Click Configure to set whitelist options and configure actions for clicking the Spam and Not Spam buttons in the client.

For Microsoft Outlook 2010 and 2013:

  1. In the MS Outlook client, click File > Barracuda Networks (Note that the UI graphics may look different between the versions, but the actions you take are the same).

    Figure 2: The File menu has a Barracuda Networks menu option.

    AddInFileMenu.png
  2. Click the Configure button and configure whitelist and spam settings as described above.

    Figure 3: The Barracuda Networks menu shows the Configure button to configure the add-in.

AddInFileConfigure.png


Last updated on