PasteHunter is a python3 application that is designed to query a collection of sites that host publicliy pasted data. For all the pasts it finds it scans the raw contents against a series of yara rules looking for information that can be used by an org or a researcher.
Pastehunter currently has support for the following sites:
- pastebin.com
- dumpz.org
- gist.github.com
Support for the following sites is listed as ToDo:
- paste.ee
Pastehunter comes with a couple of post process modules that extact useful data from pastes or pass them to other services The following are default modules:
- Emails
- Base64 Decoders
- Cuckoo
- Viper
You need a Pro account on pastebin that has access to the scraping API. https://pastebin.com/api_scraping_faq
Github needs an oauth token to stop it hitting the free ratelimit. Create one at https://github.com/settings/tokens
YOU DO NOT NEED TO GIVE IT ANY ACCESS PERMISSIONS
https://www.elastic.co/guide/en/elasticsearch/reference/current/deb.html
https://www.elastic.co/guide/en/kibana/current/deb.html
https://yara.readthedocs.io/en/latest/gettingstarted.html#compiling-and-installing-yara
If you have yara errors check the installed version numbers for yara and yara-python match the lastest versions.
git clone https://github.com/kevthehermit/pastehunter
Python 3
pip3 install -r requirements.txt
Install Docker & docker-compose
docker build . -t pastehunter
Run docker-compose up -d
Kibana is running only on the localhost interface on default port (5601).
Kibana use the default login and password : elastic and changme
Kibana is using the static IP address : 172.16.10.12 in the esnet network
Elasticsearch is running only on the localhost interface on default port 9200.
The mount point is /usr/share/elasticsearch/data by default
You can re-run the pastehunter script by doing docker-compose up -d
Docker-compose will use already running instances of Elasticsearch and Kibana
copy settings.conf.sample to settings.conf populate the details. For the scraping API you need to whitelist your IP on pastebin. No API key is required. See the link above
Start the application with python3 pastehunter.py
It may be useful to run in a screen to keep it running in the background.
Service config is coming