Skip to main content

Install the Microsoft Outlook Add-in for Email Security

You can use Microsoft Outlook Add-in for Email Security to report messages as spam or phishing attacks directly from your inbox. Once reported, the message will be sent to Bitdefender and analyzed.

Note

Version 1 of the add-in is not currently compatible with Outlook Professional Plus or iPadOS. For further information on mimimum requirements please see this Microsoft KB article.

Requirements

  • The add-in is only accessible from a primary mailbox. You cannot use the add-in on a shared mailbox.

  • Compatible outlook versions:

    • Outlook 2013 or later for Windows

    • Outlook 2016 or later for Mac

    • Outlook on the web for Exchange 2013 on-premises and later versions

    • Outlook on iOS

    • Outlook on Android

    • Outlook on the web in Office 365 and outlook.com

Installing the plugin

  1. Copy the this add-in manifest URL :

  2. Go to the Office 365 admin center Add-in page and sign in.

  3. Click Deploy Add-in.

  4. Click Next.

  5. Select Upload custom apps.

  6. Select the I have a URL for the manifest file option and paste in this URL:

    https://download.bitdefender.com/business/EmailSecurity/OutlookAdd-in/emsaddinmanifest.xml
  7. Select Upload.

    169781_1.png
  8. Select the users you want to assign the add-in:

    • Everyone - all users in your company will have access to the add-in.

    • Specific users / groups - only the selected users will have access to the add-in.

    • Just me - only you will access to the add-in.

  9. Select the deployment method:

    • Fixed - the add-in will deploy automatically to all assigned users. Only you will be able to remove the add-in.

    • Available - users will have access to the add-in but will need to deploy it manually. All users will be able to remove the add-in.

    • Optional - the add-in will deploy automatically to all assigned users. All users will be able to remove the add-in.

  10. Click Deploy.

    169781_2.png

If successful, the following message will appear:

169781_3.png

The add-in should now appear in the list:

169781_4.png
  1. In Outlook, go to File > Manage Add-ins.

  2. Go to My add-ins.

  3. Under Custom Add-ins click Add a custom add-in and select Add from URL....

  4. Enter this URL:

    https://download.bitdefender.com/business/EmailSecurity/OutlookAdd-in/emsaddinmanifest.xml
  5. Click OK.

If successful, the Add-in will appear under My add-ins > Custom Addins

169781_5.png

Using the add-in to report an email

Once installed, the a button will appear in your Outlook interface:

  • For web version

    169781_6.png
  • For desktop app

    169781_7.png

To report an email follow the steps below:

  1. Select the email you wish to report.

  2. Click the Bitdefender add-in button.

  3. Select either Report spam or Report phishing.

Version 2.0

Version 2.0 of the add-in allows end-users to access familiar Email Security features from inside Outlook, Outlook Web App (OWA) and on mobile devices.

With this version, you can review their personal quarantine area, manage your safe/deny lists and access their SecureMail Inbox, all directly from Outlook.

Note

This version of the add-in is not currently compatible with Outlook Professional Plus or iPadOS

Installing the plugin

  1. Log in to the Office 365 admin center. If prompted, select the new admin center.

  2. In the menu on the left side of the screen, click Settings, and select Integrated apps.

    EMS_outlook_add_in_installation_office365_admin_en_169781.png

    This will redirect you to the Integrated apps page.

  3. Click the Upload custom apps button on the lower side of the page.

    EMS_outlook_add_in_installation_office365_admin_integrated_apps_en_169781.png

    The Deploy New App window is displayed.

  4. Upload the app:

    1. Under Upload custom app, cofigure the following settings:

      1. Under App type, select Office Add-in.

      2. Under Choose how to upload app, select the Provide link to manifest file option.

      3. Paste one of these URLs in the filed below and click Validate.

        • If your GravityZone is provisioned with https://cloudgz.gravityzone.bitdefender.com/, use this URL:

          https://ems-addin.bitdefender.com/prod/Manifest_US.xml
        • If your GravityZone is provisioned with https://cloud.gravityzone.bitdefender.com/ or https://cloudap.gravityzone.bitdefender.com/, use this URL:

          https://ems-addin.bitdefender.com/prod/Manifest_US.xml
      EMS_outlook_add_in_installation_office365_admin_install_app_en_169781.png
    2. Click Next.

    3. Under Users, configure the following settings:

      1. Under Is this a test deployment?, set the toggle to Yes if you'd like to deploy the add-in to a specific group of users. The Microsoft Admin Center also provides the option to filter apps based on whether they were deployed as a test.

      2. Under Assign users, select the users for whom you want to make the add-in available.

      EMS_outlook_add_in_installation_office365_admin_install_app_2_en_169781.png
    4. Click Next.

    5. Under Permissions, read the app permissions and capabilities, click Accept permissions, and confirm grating permissions.

    6. Click Next.

    7. Under Finish, review the configured deployment settings, and click Finish deployment.

    A window will appear showing the progress of the deployment. Once finished, click Done.

    EMS_outlook_add_in_installation_office365_admin_install_app_3_en_169781.png

    Note

    It can take up to 24 hours for the app to appear in Outlook.

    If after this time you are still not seeing the latest add-in version in desktop versions of Outlook, you may need to clear the Outlook cache.

Enabling the Add-in

To enable the add-in and make buttons and interactions visible in Outlook, follow the steps below:

Important

The add-in is only accessible from a primary mailbox. You cannot use the add-in on a shared mailbox.

  1. Select any message in either the online (web) version of Outlook, or the Outlook app, and click the More actions menu button on the right side of the email window.

    EMS_outlook_add_in_outlook_web_view_options_169781.png
  2. Click Customize actions.

    EMS_outlook_add_in_outlook_web_view_options_2_en_169781.png

    The Customize readin page action window is displayed.

  3. Under the Apps column, enable the Bitdefender checkbox, and click Save.

    EMS_outlook_add_in_outlook_web_view_options_3_en_169781.png

The button to access the add-in is now visible in the upper right side of the window, when viewing an email message:

EMS_outlook_add_in_view_options_en_169781.png

Using the add-in

To access the add-in options, follow the steps below:

  1. Click to view any email in either the Outlook app or the online (browser version).

  2. Click the Bitdefender icon in the menu from the upper right side of the email window.

    EMS_outlook_add_in_view_options_2_en_169781.png
  3. Select one of the available options:

    • Report as phishing - Sends a message to Bitdefender, reporting this email as a phishing attempt.

    • Report as spam - Sends a message to Bitdefender, reporting this email as a spam message.

    • Quarantine - Access your personal quarantine.

      EMS_outlook_add_in_personal_quarantine_en_169781.png
    • Safe & Deny Lists - Access your safe list and deny list in Email Securty. You can add or remove items to both lists.

      EMS_outlook_add_in_safe_and_deny_lists_en_169781.png
    • Secure Mail - Access the Secure Mail dashboard.

      EMS_outlook_add_in_secure_mail_en_169781.png