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)
- Clone Github Repository to your local machine
- Unpack the Github Repository
- run Powershell in the ESDAR-Checker Directory
- Create virtual enviroment according to the following documentation (use
python -m venv .
to create the virtualenv in the current directory) - Activate the virtualenv with
.\Scripts\activate
, if you need help you can look into the following article - 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
- Open the python file 'config.py' in the ESDAR-Checker directory
- and enter the FULL path to the ouptut directory which you can find in the resources folder.
- 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'
- Now your ready to run the ESDAR-Checker!
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"
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.
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.
- 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