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.

Customization Options - Microsoft Exchange Button

  • Last updated on

This article describes how to create and customize the Microsoft Exchange button.

To create a new button:

  1. Navigate to System > Button Plugin Config.

  2. On the Button Configuration Manager page, click New.

  3. Enter a Configuration Name, a user-friendly name you will use for this button configuration. This name is not visible to users.

  4. Select a Code Version to specify the type of button you want to create – Microsoft Exchange and the software version used for this configuration. Be sure to select the newest version available. Other configurations are described in other articles. 

  5. Click Save
  6. Specify the configuration based on the descriptions below, then click Save again. 

General
    • Configuration Name – The name you specified above is copied here. You can change it at this point if you choose.

    • Button Is PublishedIf selected, the button is already published to the Barracuda PhishLine servers. This field is not editable.

    • Last Publish Request – If the button is published, displays the last time a Button Publish was requested.

    • Last Publish CompletedIf the button is published, displays the last time a Button Publish request was completed.

Code Version
    • Code VersionVersion of the software code you chose for this configuration in Step 4 above.
    • Button Code TypeDisplays the type of source code for the selected Code Version.
    • Code DescriptionDisplays the description of the selected Code Version.
Button Image
    • Button ImageSelect and upload a graphics file to display on the button.
      Recommendation: Select a GIF or PNG file. If needed, the system will automatically resize the image to approximately 80 x 80 pixels.
    • Button Image File Type – Displays the type of file you uploaded for the Button Image (GIF or PNG).
    • Button Image File SizeDisplays the size of the image file you selected and uploaded.
Instructions

This section includes the ZIP file needed to install the Exchange button. For details, refer to Installation Instructions - Microsoft Exchange Button.

 

Note

This ZIP file is not required if you are deploying the button to Barracuda PhishLine servers, which is the recommended deployment method. The ZIP file is only needed if you are hosting the button on premises.


General Settings
    • Add Header Details to Wrapper Email Body – Recommended. Select this option if you want to have more information about the reported message available in the body of the email wrapper.
      • Selecting this option adds the following to the message:
        • plain text version of the email
        • email headers
        • URLs present in the email
        • reporting button version information
        • reported-from folder
      • If you do not select this option, only the Phishing/Mock/Not Internal or Mock Body Text displays, followed by a base64-encoded version of the original message.
    • Are you sure - Enable – Select this option if you want to prompt users if they really want to report the selected email.
    • Set Are you sure buttons to OK/Cancel instead of Yes/No – Select this option to change the Are you sure button options to OK and Cancel.
    • Are You Sure - Title – Optionally customize the title on the prompt asking if the user wants to report the selected email.
    • Are You Sure - Prompt TextOptionally customize the prompt asking if the user wants to report the selected email.
    • Disable Internal Delete – Select this option if you do not want internal emails to be deleted when they are reported. Emails are considered internal if they originate from a domain name you have listed under the Internal Message section. See the Internal Message section below for more details.
Phishing
    • Phishing Button LabelEnter a text label for the phishing button.

    • Phishing Button Tool Tip TitleEnter text for the title and text of the tool tip that appears when a user hovers over the phishing button.

    • Phishing Body TextEnter text for the body of an email used to report a suspect email that is not a mock phishing test or an internal message.

Internal Message
    • Internal Send ToEnter one or more email addresses to notify of reported emails from the internal domains. Separate multiple email addresses with semicolons or commas.
    • Internal Reporting Success Pop Up Message – Optional. Enter text to appear to users when they report a phishing message from an internal domain.
    • Reported Internal Body TextEnter the body text for the reported phishing email when it is recognized as Internal. Use {0} to insert the matching internal domain.
    • Internal Domains Enter a list of domains that the plugin will use to identify reported emails that came from your internal domains. Enter one domain per line in the format example.com.
Mock Message
    • Mock Send ToEnter one or more email addresses to notify of reported emails recognized as Mock Phishing tests. Separate multiple email addresses with semicolons or commas.
    • Mock Success Pop Up Message – Optional. Enter text to appear to users when they report a mock phishing message.
    • Reported Mock Body TextEnter the body text for the reported email when it is recognized as a mock phishing test. Use {0} to insert header information.
    • Mock Phishing HeadersEnter a list of X-Headers, one per line, to identify mock phishing emails. Configure custom X-Headers in System > Global Settings.
Not Internal Or Mock
    • Phishing Report Send ToEnter one or more email addresses notified when a user clicks the phishing button, but the suspect emails are neither Mock nor Internal. Separate multiple email addresses with semicolons or commas.
2-Step Button

This feature is not available with the Exchange button due to Office 365 system limitations.

Spam

This feature is not available with the Exchange button due to Office 365 system limitations.

Advanced
    • Custom Config URLEnter the URL, if you are hosting your own code.

Regardless of whether you or Barracuda PhishLine is hosting the button code, the server administrator must set AuthAuthentication to true on the Client Access Server EWS directory to enable the makeEwsRequestAsync method to make EWS requests. Refer to https://dev.office.com/reference/add-ins/outlook/1.5/Office.context.mailbox?product=outlook&version=v1.5 for more details.

    • Last ModifiedDisplays the last time this configuration was modified.
Last updated on