Uses the FastAPI framework to create a REST API that allows users to upload their exported Wireshark files (JSON format) to a MongoDB Atlas database. After each upload, the packets endpoint returns an extracted version of the results to the client as well. The packets.py file is to be customized to whatever protocol you want to analyze, the choices seem to be endless!
The app is written in Python and uses the PyMongo library to connect to MongoDB Atlas.
Uses Python's Poetry package manager to manage dependencies.
- Poetry
- MongoDB Atlas account (and connection string)
- Wireshark JSON file
- MongoDB Atlas db/collection names (these are to be created in the MongoDB Atlas dashboard)
- Clone the repository
- Install Poetry
- Run
poetry installto install dependencies from thepyproject.tomlfile - Run
poetry shellto activate the virtual environment - Run
uvicorn app:app --reloadto start the server
-
Open a browser and navigate to
http://127.0.0.1:8000/ -
Upload a Wireshark JSON file
-
After the upload is complete, you'll be redirected to the
packetsendpoint, which will display the extracted results from the uploaded file. -
To view the results in MongoDB Atlas, you can use MongoDB Compass (my favorite way to do it) or the MongoDB Atlas dashboard.