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

Installation Instructions - Microsoft Outlook Button

  • Last updated on

The Microsoft Outlook Button will no longer be supported starting October 2023. The Microsoft Exchange Button is recommended.

Note

Note that beginning with the Security Awareness Training Microsoft Outlook button version 1.5.0.0, you must install the .NET 4.6.1 Framework before installing and configuring the Microsoft Outlook button.

Client Requirements

The Microsoft Outlook button can be installed for Outlook 2013, 2016, and 2019 for Windows. There is no Mac client. Use the Exchange Button if you need Mac or Web buttons.

Important

Make sure to choose the installer that corresponds to your version of Office/Outlook. This is essential for proper functioning of the phishing button.

  • You must use the 32-bit installer for 32-bit versions of Office/Outlook, regardless of your version of Windows.
  • You must use the 64-bit installer for 64-bit versions of Office/Outlook, regardless of your version of Windows.

If you are installing on 64-bit Windows, but have 32-bit Office/Outlook, you must use the 32-bit installer.


How to Install

  1. Finish all configuration on the Button Configuration Manager page for your Microsoft Outlook button, as described in Customization Options - Microsoft Outlook Button, then click Save.
  2. On the Button Configuration Manager page for your Outlook button, scroll down to the Instructions section. Download the InstallPhishLineOutlookPlugin.zip file.
  3. Unzip the file.
    Note that previewing the unzipped file by clicking on it is not sufficient. You must click Extract All or use other method to completely extract all files.

  4. Open a command prompt using the Run as administrator option.

  5. Navigate to the directory where you extracted the files.

  6. Run install.bat from the command line.

For large installations: Execute the command line through Group Policy for mass installations.

Installation Notes

  • The current configuration has requested a 'Quiet Install'. This adds the /quiet parameter to the install.bat.
  • The system is configured not to automatically restart during install/uninstall. This adds the /norestart to the install.bat and uninstall.bat.
  • The Enable Auto Sync option is selected by default. Every time an Outlook client starts, it will attempt to download new versions of the configuration file from your instance. For example, https://phishline.com/phishline_demo_cudacampus/api.bof?mode=button&u=976eaf620b&t=json&s=1118
    If a client is unable to download an updated configuration for any reason, it will attempt to use the locally installed configuration, stored in %localappdata%\PhishLine\config.json.
  • You are not required to host the configuration file or the custom images on the Security Awareness Training platform. The CONFIGURL=  option is designed to work with any web server that can distribute the JSON configuration.
  • Installation logs are created in %TEMP% as PhishLine_TIMESTAMP.log, where TIMESTAMP is an actual time stamp.
  • For debug purposes after installation, look at the %localappdata%\PhishLine\phishline.log.
  • Outlook must be restarted to trigger the initial download of the configuration JSON and the button image, regardless of whether Outlook was open during installation.

How to Uninstall

Use the uninstall.bat file, which includes information on how to uninstall using the /uninstall parameter.

Previous Article Next Article