Skip to content

passuf/blackhole

Repository files navigation

Black Hole

Collect arbitrary HTTP requests to see what your HTTP client is sending, e.g. when debugging webhooks.

Bucket

Requests

Features

  • Create buckets with unique URLs to send requests to
  • Collect and analyse the HTTP requests:
    • HTTP Header
    • Body
    • GET query parameters
    • Form data
    • Raw HTTP request
    • Custom values parsed into a dictionary

Setup

Install the Requirements

Create a virtualenv:

virtualenv venv_dir

Activate the virtualenv:

source venv_dir/bin/activate

Install the requirements:

pip install -r requirements.txt

Run the Django app

Create a local settings file local_settings.py based on the example local_settings.example.py and configure the parameters according to your setup (do not share this file!):

cp blackhole/local_settings.example.py blackhole/local_settings.py

Prepare the database:

python manage.py migrate

Run the test server to verify the installation:

python manage.py runserver 127.0.0.1:8001

Deploy the app

There are several good guides on how to deploy a Django application. Personally, I like the one from Michal Karzynski or Digital Ocean.

Acknowledgements

About

Capture and analyse wild HTTP requests

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published