TheHive-Project / TheHive-Project/Cortex-Analyzers

[FR] New analyzer and responder: Mimecast

Open
#862 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

category:feature-request
Dominant language
Python
Stars
490
Forks
405
Avg merge
2d 43m
Merged PRs (30d)
8

Description

Feature description
Mimecast is a company that provides email security as a service. Several of their features can be usefully used in response to phish messages:

  • Their URL Protect feature can rewrite URLs in email messages received through Mimecast. When users click the link, various checks can take place before redirection to the original URL. But threat responders need to know what the original URL was. Mimecast provides an API service to do this decoding.
  • When a phish is received by a user from some address, and the user reports it, threat responders need to know who else inside the organization also received the phish. Mimecast provides an API service to find messages sent by a given email address within given time bounds.
  • Mimecast provides an API service that will place a URL or domain on a block list, such that when a user clicks on a link in an email that points to that URL or domain and has been rewritten by Mimecast's URL Protect feature, the user will not be redirected to the blocked page; instead, warnings will issue, to the user and to IT staff.

A mimecast_api module has been released that makes these actions easy from Python, given appropriate Mimecast credentials, which can be generated if one is a Mimecast customer.

Describe the solution you'd like

  • An analyzer that decodes an observed URL which has been rewritten by URL Protect, and provides the original URL as an artifact.
  • An analyzer that finds who has received messages from an observed email, and provides recipient email addresses as artifacts.
  • A responder that allows blocking URLs or domains using Mimecast's Managed URL feature - but avoids creating duplicate blocklist entries.

Contributor guide

No contributing guide indexed for this repository

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

No repository files or tests are named in the issue; start by reviewing existing analyzer and responder entry points and the mimecast_api module documentation. Done means providing the three requested Mimecast capabilities: URL decoding, recipient discovery, and duplicate-safe URL or domain blocking.

Written by the indexing model from the issue text.

Assessment

Tech stack
python
Domain
security
Issue type
Feature
Difficulty
5/5
Estimated time
Over a week
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
30/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.