A (still WIP) tool to populate and browse a SQL database with records from incoming DMARC aggregate reports. The idea is to make detecting misconfigured mail hosts, malicious mail servers, and monitoring outgoing mail traffic easier through constantly monitoring reported mail traffic from DMARC aggregate reports (as described in RFC 7489 section 7.2) in the form of easy-to-run reports and an (optional) interactive web interface.
This tool was built based on requirements needed or requested by West Virginia University's Information Security Services. This project is open-source licensed by the GNU General Public License (v3) found in the LICENSE file in this directory.
Configuration: A single
config-example.yml) or similar static configuration file named
config.toml, etc.) is required for basic runtime configuration in the same directory as the dmarcdb binary (i.e. "beside" the binary).
For stable configuration, logging, and accessibility purposes, it'd be best to just have a singular folder for dmarcdb and it's accompanying files alone (i.e.
For each command listed below (and also without any commands) on startup, if
web is set in the config to
true, it will also begin to serve a web browseable interface (data read-only) over the configured
./dmarcdb build- Begins the process of building the database with records populated from the mail folder configured as
./dmarcdb logs- Prints any error logs received while attempting to processed malformed DMARC aggregate reports or malformed emails
./dmarcdb flush <fails|hosts>- Without parameters, deletes both logged errors and cached hostname lookups. With either extra parameter
hosts, will only flush respective option.
The following (nonexhaustive) list of third-party technolgies were used in this project:
- PostgreSQL / MSSQL
- Go (>= 1.8)
- Bolt - "A fast key/value store inspired by Howard Chu's LMDB project."
- Viper - A library to make accepting client configurations in Go easier.
- Uses the Win32 API (via go-ole) to browse mail items from a Microsoft Outlook folder. In future versions it should probably just use IMAP to read mail for cross-platform purposes. However, only Windows compatibility was initially required by the requesting party and reading cached emails from an already functioning desktop mail client seemed less resource intensive.
- and a handful of others
- MaxMind's GeoIP