Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/cyberdefenders/email-header-analyzer
E-Mail Header Analyzer
https://github.com/cyberdefenders/email-header-analyzer
analysis analyzer docker email-forensics email-header email-header-forensics email-parsing email-sender headers headers-mime mha outlook
Last synced: 3 days ago
JSON representation
E-Mail Header Analyzer
- Host: GitHub
- URL: https://github.com/cyberdefenders/email-header-analyzer
- Owner: cyberdefenders
- License: other
- Created: 2016-04-25T09:52:15.000Z (over 8 years ago)
- Default Branch: master
- Last Pushed: 2023-04-11T16:38:38.000Z (almost 2 years ago)
- Last Synced: 2025-01-01T15:05:04.217Z (10 days ago)
- Topics: analysis, analyzer, docker, email-forensics, email-header, email-header-forensics, email-parsing, email-sender, headers, headers-mime, mha, outlook
- Language: HTML
- Homepage: https://mailheaderanalyzer.herokuapp.com/
- Size: 10.9 MB
- Stars: 657
- Watchers: 32
- Forks: 165
- Open Issues: 19
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
Awesome Lists containing this project
- Awesome - E-Mail Header Analyzer (MHA) - E-Mail header analyzer is a tool written in flask for parsing email headers and converting them to a human readable format and it also can: Identify hop delays, Identify the source of the email, Identify hop country. (Communication and Collaboration Tools / E-mail)
- awesome-opensource-email - E-Mail Header Analyzer - E-Mail Header Analyzer (Security / Security Check)
- jimsghstars - cyberdefenders/email-header-analyzer - E-Mail Header Analyzer (HTML)
README
## E-Mail Header Analyzer (MHA)
## What is E-Mail header analyzer (MHA):
E-Mail header analyzer is a tool written in [flask](http://flask.pocoo.org/) for parsing email headers and converting them to a human readable format and it also can:
* Identify hop delays.
* Identify the source of the email.
* Identify hop country.
## MHA is an alternative for the following:
| Name | Dev | Issues |
| ---- | --- | ----- |
| [MessageHeader](https://toolbox.googleapps.com/apps/messageheader/) | Google | Not showing all the hops. |
| [EmailHeaders](https://mxtoolbox.com/Public/Tools/EmailHeaders.aspx) | Mxtoolbox | Not accurate and slow. |
| [Message Header Analyzer](https://testconnectivity.microsoft.com/MHA/Pages/mha.aspx) | Microsoft | Broken UI. |
## Installation
Install system dependencies:
```
sudo apt-get update
sudo apt-get install python3-pip
sudo pip3 install virtualenv
```
Create a Python3 virtual environment and activate it:
```
virtualenv virt
source virt/bin/activate
```
Clone the GitHub repo:
```
git clone https://github.com/lnxg33k/email-header-analyzer.git
```
Install Python dependencies:
```
cd MHA
pip3 install -r requirements.txt
```
Run the development server:
`python3 server.py -d`
You can change the bind address or port by specifying the appropriate options:
`python3 server.py -b 0.0.0.0 -p 8080`
Everything should go well, now visit [http://localhost:8080](http://localhost:8080).
## Docker
A `Dockerfile` is provided if you wish to build a docker image.
```
docker build -t mha:latest .
```
You can then run a container with:
```
docker run -d -p 8080:8080 mha:latest
```
### Docker-Compose
A `docker-compose` file is provided if you wish to use docker-compose.
Clone the GitHub repo:
```
git clone https://github.com/lnxg33k/email-header-analyzer.git
cd email-header-analyzer
```
Let docker-compose do the work.
```
docker-compose up -d
```
Stop the container.
```
docker-compose down
```
HowTo enable debugging. Add in the docker `docker-compose.yml` file the line
```yaml
command: --debug
```