Skip to content

Utility to manage sets of phishing links making it easier to track their removal progress over time.

License

Notifications You must be signed in to change notification settings

ndejong/phishing-tracker

Repository files navigation

Phishing Tracker

PyPi Python Versions Build Status License

Utility to manage sets of phishing links making it easier to track their removal progress over time.

Project started out of frustration in dealing over-and-over again with phishing threat-actors and wanting an easy tool to handle the tracking of these links over time without needing to roll out a full-fledged CERT stack (eg The Hive)

Captures everything per-run in a single JSON file making it easy to compare and track change over time - and integrate with other tooling if desired.

See examples to get a clear idea on usage and possibilities.

Features

  • Batch mode with .yml configuration file
  • Single shot mode by passing link/hostname/domain in at cli
  • Collects useful reference-information and artifacts per phish link stored in an easy reference json file
  • Create rules to define expected (or desired) analyzers output responses
  • Easy to re-run and hence re-compare the latest status of phish-links over time
  • Debug mode output to STDERR

Analyzers

dig

  • dig-domain - determine domain relative to TLD and collect A, CNAME, NS, MX, TXT records
  • dig-hostname - collect hostname A, AAAA, CNAME, NS, MX, TXT records

http

  • http-get - perform http (clear-text) GET request capturing request/response headers and response content

https

  • https-get - as per http-get using HTTPS

https_certificate

  • https-certificate - obtain the https SSL certificate and parse certificate attributes

smtp

  • smtp-headers - connect to hostname/domain MX records and capture the server header

safe_browsing

whois

  • whois - perform a whois and parse associated attributes

Analyzers - Todo

Install

via PyPi

pip3 install phishing-tracker

via Source

git clone https://github.com/ndejong/phishing-tracker
cd phishing-tracker
python3 -m venv venv
source venv/bin/activate
pip3 install -r requirements.txt
python3 setup.py clean
python3 setup.py test
python3 setup.py install

Project

Analyzer Response Reports

dns_domainname_a_record
dns_domainname_cname_record
dns_domainname_mx_record
dns_domainname_ns_record
dns_domainname_txt_record
dns_domainname_unknown_tld
dns_hostname_aaaa_record
dns_hostname_a_record
dns_hostname_cname_record
dns_hostname_eq_dns_domainname
dns_hostname_mx_record
dns_hostname_ns_record
dns_hostname_txt_record
http_exception
http_hostname_<statuscode>_response
https_certificate_exception
https_certificate_hostname_mismatch
https_exception
https_hostname_<statuscode>_response
safe_browsing_exception
safe_browsing_record
smtp_domainname_active
smtp_exception
smtp_hostname_active
whois_domainname_record
whois_exception

Google Safe Browsing API key

In order to make use of the Google Safe Browsing API lookup, the environment variable GCP_API_KEY needs to be set with an appropriate GCP key that has access to the safe-browsing API - read more here.

Examples

Authors

Nicholas de Jong

License

BSD-2-Clause - see LICENSE file for full details.

About

Utility to manage sets of phishing links making it easier to track their removal progress over time.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages