TBD
Project description
Miley - a proof of concept malware scanner for containers
Miley is a proof of concept malware scanner built for scanning container images, as well as local files.
Miley works by taking file hashes from the container/directory, and querying the hashes against a malware databse, Malware Bazaar.
This tool was created to satisfy classwork for Dakota State University's CSC-842 Security Tool Development.
Demo video: [here](coming soon!)
Prerequisites
- Python 3 interpreter
- Pip3
- Docker for container scanning
Usage
pip install miley
miley --help
Scan a hash (MD5, SHA-1, or SHA-256)
miley --hash f617abd6a9ccb98e34a6e32184004d5a08ea11d198fca9fed88b04b9dfc96de2
Scan a directory for malware
miley --path /path/to/directory/
Scan a remote container image
miley --image alpine:latest
Future Work
If I were to maintain this program going forward, I would:
- speed up the program
- support additional malware databases, such as Virus Total
- add a GUI
Why is it named Miley?
Miley is my beloved family dog, who passed away in 2023 due to old age.
Miley was always good at detecting and alerting to potentially dangerous situations, despite being blind.
I wrote this tool with her memory at the forefront of my mind.
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
File details
Details for the file miley-1.0.2.tar.gz
.
File metadata
- Download URL: miley-1.0.2.tar.gz
- Upload date:
- Size: 15.8 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: poetry/1.5.1 CPython/3.9.2 Linux/5.10.0-23-amd64
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | 9d2a7b03358708e21ffc97ef29c3c4a5a01eea59a4dd663f0331ccebfe55ac39 |
|
MD5 | 1f88607b774baf0f767ec4a31f71f22e |
|
BLAKE2b-256 | a3d9f5a3408b8e643a08fa71410471a0e178923b217c28298c2bee290ed8bc6f |
File details
Details for the file miley-1.0.2-py3-none-any.whl
.
File metadata
- Download URL: miley-1.0.2-py3-none-any.whl
- Upload date:
- Size: 17.5 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: poetry/1.5.1 CPython/3.9.2 Linux/5.10.0-23-amd64
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | 9ce3a525bf215084a81363c41ec5da9a81e76e811496b4ae3d99212768b11abb |
|
MD5 | 5581342d0b4b987249523451456332eb |
|
BLAKE2b-256 | c00bf69a28ab38dd4422549f9dd4b321b360b58324bf0c444e3b9287758722f9 |