An Outlook Email Reporting Tool Sample
Clone or download
Latest commit cd2c005 Feb 12, 2018
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
assets First Commit Feb 12, 2018
node_modules First Commit Feb 12, 2018
README.md First Commit Feb 12, 2018
bsconfig.json First Commit Feb 12, 2018
index.html First Commit Feb 12, 2018
index.js First Commit Feb 12, 2018
outlook-report-addin-manifest.xml First Commit Feb 12, 2018
package.json First Commit Feb 12, 2018

README.md

Outlook Report Suspicious Email Addin

This add-in is a fully functional sample that demonstrates how an organization can use the new OfficeJS API in to create and deploy and Outlook add-in to help user report suspicious emails they recieve to the proper security team.

Applies to

  • Exchange Online
  • Office 365
  • Outlook.com

Prerequisites

This add-in is for demonstration purposes. It uses the easyEws library and was developed in Visual Studio Code. It was created from an Outlook Yeoman template. For the best experience you will want to use VSCode and configure it for Office development, per this blog post.

Once VSCode is installed and configured you will need to run "npm init" from the Terminal Window (CTRL+`) to initialize the node_modules folder. This will use the package.json included to pull down the following prerequisite libraries:

  • core-js v2.4.1
  • office-ui-fabric-js v1.3.0
  • jquery v3.1.1
  • office-addin-validator v1.0.1
  • easyews v1.0.8

Once the prohect is initialized, you will likely want to publish this sample on a web server as a web app once you have downloaded it, do do this you can use Azure.

However, before you publish this, you will want to modify the manifest with the proper URLS and email address where you want the secuirty email's to be sent by the users. For example, if you publish to the server http://azuretenant.contoso.com/webapp/ and the email to be securityteam@contoso.com, you will want to modify these lines:

  <IconUrl DefaultValue="https://localhost:3000/assets/icon-80.png" />
  <HighResolutionIconUrl DefaultValue="https://localhost:3000/assets/logo-filled.png" />

to

  <IconUrl DefaultValue="http://azuretenant.contoso.com/webapp/assets/icon-80.png" />
  <HighResolutionIconUrl DefaultValue="http://azuretenant.contoso.com/webapp/assets/logo-filled.png" />

And then, in the FORMS SETTINGS change the SOURCE LOCATION:

    <SourceLocation DefaultValue="https://localhost:3000/index.html"/>

to

    <SourceLocation DefaultValue="http://azuretenant.contoso.com/webapp/index.html"/>

And then the icons in RESOURCES:

        <bt:Image id="icon16" DefaultValue="https://localhost:3000/assets/icon-16.png"/>
        <bt:Image id="icon32" DefaultValue="https://localhost:3000/assets/icon-32.png"/>
        <bt:Image id="icon80" DefaultValue="https://localhost:3000/assets/icon-80.png"/>

to

        <bt:Image id="icon16" DefaultValue="http://azuretenant.contoso.com/assets/icon-16.png"/>
        <bt:Image id="icon32" DefaultValue="http://azuretenant.contoso.com/assets/icon-32.png"/>
        <bt:Image id="icon80" DefaultValue="http://azuretenant.contoso.com/assets/icon-80.png"/>

And finally, in the RESOURCES section of the manifest you will need to update the bt:URL:

        <!--Set the email=(value) for the security emails address -->
        <bt:Url id="messageReadTaskPaneUrl" DefaultValue="https://localhost:3000/index.html?email=admin@contoso.com.com"/>

to

        <!--Set the email=(value) for the security emails address -->
        <bt:Url id="messageReadTaskPaneUrl" DefaultValue="http://azuretenant.contoso.com//index.html?email=securityteam@contoso.com.com"/>

Version History

Version Date Comments
1.0 2/5/2018 Initial release

Disclaimer

THIS CODE IS PROVIDED AS IS WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING ANY IMPLIED WARRANTIES OF FITNESS FOR A PARTICULAR PURPOSE, MERCHANTABILITY, OR NON-INFRINGEMENT.