Skip to content

A Small Script for Email Security DNS Advanced Record Checking

Notifications You must be signed in to change notification settings

CarIos-Matos/ESDAR-Checker

Repository files navigation

ESDAR-Checker (Email Security DNS Advanced Records Checker)

How to use ESDAR-Checker

Prerequisites:

  • Python3
  • you have to be able to run Scripts via Powershell or at least to run the following command in Powershell: Set-ExecutionPolicy Unrestricted -Scope Process (Stackoverflow)
  1. Clone Github Repository to your local machine
  2. Unpack the Github Repository
  3. run Powershell in the ESDAR-Checker Directory
  4. Create virtual enviroment according to the following documentation (use python -m venv . to create the virtualenv in the current directory)
  5. Activate the virtualenv with .\Scripts\activate, if you need help you can look into the following article
  6. When you succesfully activatet the virtual enviroment you can install the missing 'checkdmarc, validators and colorama' modules with the following Commands python -m pip install checkdmarc==4.1.1, python -m pip install validators, python -m pip install colorama
  7. Open the python file 'config.py' in the ESDAR-Checker directory
  8. and enter the FULL path to the ouptut directory which you can find in the resources folder.
  9. you have to escape every \ with \ so for example 'C:\Users\[USERNAME]\Downloads\ESDAR-Checker-1.0.0-beta\resources\output' or 'C:/Users/[USERNAME]/Downloads/ESDAR-Checker-1.0.0-beta/resources/output'
  10. Now your ready to run the ESDAR-Checker!

How to run ESDAR-Checker (Powershell)

python .\ESDAR-Checker.py --domain "google.com"

python .\ESDAR-Checker.py --domains_file "[ABSOLUTE_PATH_TO_CSV_FILE]" Optional Parameters:

  • --selector [SELECTOR] (default is no selector)
  • --append [yes/] (default is not append)

e.g: python .\ESDAR-Checker.py --domain "google.com" --selector "EXAMPLE" --append "yes"


Use Case

Diese Skript soll dem Benutzer helfen eine beliebige anzahl an Domains respektive URL's auf folgende Punkte zu ueberpruefen

  • DMARC
  • SPF
  • DKIM
  • MX Records

Das Skript prüft dabei ob für die oben genannten Punkte ein DNS TXT record vorhanden ist, wenn dem so ist wird dieser fuer die weitere verwendung zwischengespeihcert. Im Anschluss kann der Record eintrag auf dem Terminal ausgegeben werden oder in ein csv file geschrieben werden.

Aktueller Status

In Entwicklung. Das Skript funktioniert für einzelne Domains sowie mit einem File welches mehrere Domains beinhaltet. Das Error Handling ist jedoch noch nicht ausreichend umgesetzt.

Probleme

  • csv files geben aktuell noch probleme bei der verarbeitung
  • es können nicht mehrere selectoren eingegeben werden
  • einzelne Errors führen zu einem ungewollten absturz
  • das aktuelle skript benötigt die checkdmarc version 4.4.1 und publicsuffix2. Muss noch geändert werden

About

A Small Script for Email Security DNS Advanced Record Checking

Resources

Code of conduct

Security policy

Stars

Watchers

Forks

Packages

No packages published

Languages