Table of contents

• General info
• Code
• Setup
• Install local
• Install org
• Debugging
• Todo

General info

This plugin makes it easy to report phishing emails for end-users. The reporter will recongize URLs within the email in the standard gophish format and forward these to the gophish report function. Reported emails which do not match the gophish format will be forwarded to an email adress specfied in the settings with any comments and the raw mail with all headers. It works in all outlook clients (android, ios, macos, windows & web outlook) and a demo bellow.

Code

This template is written using TypeScript. For the JavaScript version of this template, go to Office-Addin-TaskPane-React-JS

Setup

1.Clone repo:

$ git clone https://github.com/dwtechnologies/gophish-owa-phishing-reporter.git

2. Make any needed adjustments

2.1 In App.tsx you can for example change the regular expression to match other URLs than the default gophish format "http://phish_server/?rid=1234567"

2.2 Adjust settings in src/settings.json (destination mail etc)

2.3 Do the build.

$ npm run build

3.Upload files to static hosting of your choice (AWS S3 etc).

4.Make changes for you env in manifest.xml

4.1 Take a look and change the IconUrl

4.2 Change the SourceLocaion to match the static hosting

Test the plugin (in outlook web client)

1.Go to an e-mail, select Get Add-ins icon Get Add-ins (see screenshot bellow).

2.Select My add-ins.

3.Go to the bottom of the page to Custom add-ins.

4.Select Add a custom add-in, then add the manifest.xml either by using Add from URL or Add from file.

Deploy to all

1.Go to Office 365 admin.

2.Settings > Integrated apps > upload custom apps (scree screenshot bellow)

3.Add manifest.xml as URL or file.

Debugging

Outlook client

Edit the settings.json in the outlook client folder to set debug to true

        "ShowLog": false, (debug true/false)
        "Headers": ["", ""], (add headers)
        "Contents": [""],    (catch contents)
        "Emails": ["email@email.com"], (Forward Phishing emails to)
        "ApiUrls": ["{url}/report?rid={rid}"] (GoPhish report url)

Outlook OWA

If you use the web version of outlook (OWA), then the browser developer tools / console (F12) is your friend.

Todo

• When reporting "spam/marketing", use office365 junk flagging function
• When reporting suspicious sender or other reason, use following API's before sending raw mail
• • One or several api's from https://zeltser.com/lookup-malicious-websites/
• Before sending a suspicious mail, append information about IP owner and abuse mail and rebuild the mail so it is easy for the support to forward confirmed phishing mails for takedowns