Muon contains a database of URLS that are known to contain malware. The database can be queried using a REST API
Here are some examples to help you get started creating a container.
---
version: "2.1"
services:
muon:
image: rogueranga/muon:latest
container_name: muon
ports:
- 5000:5000
restart: unless-stopped
docker run -d \
--name=muon \
-p 5000:5000 \
--restart unless-stopped \
rogueranga/muon:latest
All responses will be in JSON. Note: The url must be base64 encoded
Name | Value | Required |
---|---|---|
version | 1 | Yes |
url | base64 encoded url | Yes |
Example request
$ curl -X GET http://localhost:5000/urlinfo/1/d3d3LmJhc2U2NGVuY29kZS5vcmc6NDQzLw==
Response
{
"base64_url":"d3d3LmJhc2U2NGVuY29kZS5vcmc6NDQzLw==",
"id":1,
"verified":"True",
"verified_at":"Tue, 14 Dec 2021 20:11:51 GMT"
}
Name | Value | Required |
---|---|---|
url | base64 encoded url | Yes |
verified | true/false | Yes |
Example request
$ curl -X POST http://localhost:5000/urlinfo/1/d3d3LmJhc2U2NGVuY29kZS5vcmc6NDQzLw==?verified=True
response
{
"base64_url":"d3d3LmJhc2U2NGVuY29kZS5vcmc6NDQzLw==",
"id":1,
"verified":"True",
"verified_at":"Tue, 14 Dec 2021 20:11:51 GMT"
}
Testing assumes you have the API avaiable on localhost:5000. To run the tests install pytests
pip3 install pytest
Then run pytest from the tests dir
/tests$ pytest
Pull requests are welcome.