Skip to main content

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

miley-1.0.2.tar.gz (15.8 kB view details)

Uploaded Source

Built Distribution

miley-1.0.2-py3-none-any.whl (17.5 kB view details)

Uploaded Python 3

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

Hashes for miley-1.0.2.tar.gz
Algorithm Hash digest
SHA256 9d2a7b03358708e21ffc97ef29c3c4a5a01eea59a4dd663f0331ccebfe55ac39
MD5 1f88607b774baf0f767ec4a31f71f22e
BLAKE2b-256 a3d9f5a3408b8e643a08fa71410471a0e178923b217c28298c2bee290ed8bc6f

See more details on using hashes here.

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

Hashes for miley-1.0.2-py3-none-any.whl
Algorithm Hash digest
SHA256 9ce3a525bf215084a81363c41ec5da9a81e76e811496b4ae3d99212768b11abb
MD5 5581342d0b4b987249523451456332eb
BLAKE2b-256 c00bf69a28ab38dd4422549f9dd4b321b360b58324bf0c444e3b9287758722f9

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page