Skip to content

CERT-Polska/Artemis

Repository files navigation

logo

Artemis is a modular vulnerability scanner. This is the tool that powers CERT PL scanning activities, not only checking various aspects of website security but also building easy-to-read messages that are sent to organizations to improve their security.

The Artemis project has been initiated by the KN Cyber science club of Warsaw University of Technology and is currently being developed by CERT Polska.

If you want to use additional modules that weren't included here due to non-BSD-compatible licenses, browse to the Artemis-modules-extra repository.

Artemis is experimental software, under active development - use at your own risk.

To chat about Artemis, join the Discord server:

Features

For an up-to-date list of features, please refer to the documentation.

Screenshots

Artemis - scan

Development

Tests

To run the tests, use:

./scripts/test

Code formatting

Artemis uses pre-commit to run linters and format the code. pre-commit is executed on CI to verify that the code is formatted properly.

To run it locally, use:

pre-commit run --all-files

To setup pre-commit so that it runs before each commit, use:

pre-commit install

Building the docs

To build the documentation, use:

cd docs
python3 -m venv venv
. venv/bin/activate
pip install -r requirements.txt
make html

How do I write my own module?

Please refer to the documentation.

Contributing

Contributions are welcome! We will appreciate both ideas for new Artemis modules (added as GitHub issues) as well as pull requests with new modules or code improvements.

However obvious it may seem we kindly remind you that by contributing to Artemis you agree that the BSD 3-Clause License shall apply to your input automatically, without the need for any additional declarations to be made.

Contributors

Huge thanks to the following people that contributed to Artemis development!

kazet
kazet

💻 📖 🤔 🚇 👀 📢
Adam Kliś
Adam Kliś

💬 💻 🤔 👀 📢
anna1492
anna1492

🐛 💻
Michał M.
Michał M.

💻 🤔
cyberamt
cyberamt

💻 🤔
martclau
martclau

💻 🤔
szymsid
szymsid

💻 👀
bulek
bulek

💻 👀
Michel Le Bihan
Michel Le Bihan

💻
Grzegorz Eliszewski
Grzegorz Eliszewski

💻 🤔 📦
kshitij kapoor
kshitij kapoor

💻 🤔
Delfin
Delfin

💻
Bornunique911
Bornunique911

💻
Ridham Bhagat
Ridham Bhagat

💻
Mateusz Borkowski
Mateusz Borkowski

💻 🤔