Artemis es un escáner de vulnerabilidades modular. Es la herramienta que impulsa las actividades de escaneo de CERT PL, verificando varios aspectos de la seguridad de sitios web y generando mensajes fáciles de leer listos para ser enviados a las organizaciones escaneadas.

Inicio rápido 🔨 | Documentación 📚

Si deseas utilizar módulos adicionales que no fueron incluidos aquí debido a licencias no compatibles con BSD, navega al repositorio Artemis-modules-extra.

Si deseas modificar/desarrollar Artemis, lee primero Desarrollo.

Artemis es software experimental, en desarrollo activo - úsalo bajo tu propio riesgo.

Para charlar sobre Artemis, ¡únete al servidor de Discord!

Cooperación y conferencias

Artemis fue presentado en BlackHat USA 2024 en Las Vegas y en BlackHat Europe 2025 en Londres. Para más información sobre Artemis en BlackHat, haz clic aquí y aquí.

El proyecto también fue presentado en la 71.ª reunión del TF-CSIRT en Copenhague, 69.ª reunión del TF-CSIRT en Bucarest y en la conferencia CONFidence, entre otras.

Cooperación

El desarrollo de Artemis fue apoyado por Google Summer of Code 2024 y 2025.

Características

Para una lista actualizada de características, consulta la documentación. La más importante es la posibilidad de exportar fácilmente informes como:

Las siguientes direcciones contienen datos de sistemas de control de versiones:

• https://subdomain1.example.com:443/.git/

Hacer público un repositorio de código puede permitir a un atacante conocer el funcionamiento interno de un sistema, y si contiene contraseñas o claves API, también obtener acceso no autorizado. Tales datos no deberían estar disponibles públicamente.

Las siguientes direcciones contienen versiones antiguas de Joomla:

• https://subdomain2.example.com:443 - Joomla 2.5.4

Si un sitio ya no se utiliza, recomendamos cerrarlo para eliminar el riesgo de explotación de vulnerabilidades conocidas en versiones antiguas de Joomla. De lo contrario, recomendamos actualizaciones periódicas del núcleo y los complementos de Joomla.

La posibilidad de preparar automáticamente dichos informes nos ha permitido notificar a entidades de nuestra circunscripción sobre cientos de miles de vulnerabilidades.

Capturas de pantalla

Desarrollo

Para iniciar una versión modificada localmente de Artemis, ejecuta:

 ./scripts/start --mode=development

Este script copia automáticamente el archivo de entorno de ejemplo (env.example) a .env si no existe. Luego puedes configurar los ajustes en el archivo .env según tus necesidades. Esto incluye personalizar el user-agent estableciendo la variable CUSTOM_USER_AGENT, así como otros parámetros relevantes. Para una lista completa de variables de configuración y sus descripciones, consulta la sección de Configuración en la documentación.

La imagen de Artemis se construye localmente (a partir del código que estás desarrollando), no se descarga de Docker Hub. Para web, también podrás ver los resultados de las modificaciones de código en la página sin recargar todo el contenedor.

Pruebas

Para ejecutar las pruebas, usa:

./scripts/test

[!WARNING] Evita usar python -m unittest directamente como command: en docker-compose.test.yaml. Cuando Python se ejecuta como PID 1, los subprocesos, especialmente los binarios Go como Nuclei, sufren de E/S lenta o degradada porque el PID 1 maneja las señales y stdout/stderr de manera diferente. Usa unittest-parallel en su lugar, ya que sus procesos de trabajo evitan el problema del PID 1.

Formato de código

Artemis utiliza pre-commit para ejecutar linters y formatear el código. pre-commit se ejecuta en CI para verificar que el código esté formateado correctamente.

Para ejecutarlo localmente, usa:

pre-commit run --all-files

Para configurar pre-commit para que se ejecute antes de cada commit, usa:

pre-commit install

Modificación de dependencias

Usamos pip-tools para gestionar las dependencias. Para agregar o actualizar una dependencia:

1. Modifica requirements.in (o docs/requirements.in para dependencias de documentación),
2. Ejecuta ./scripts/compile-requirements para generar los archivos requirements.txt congelados,
3. Realiza commit de los archivos .in y .txt.

Construcción de la documentación

Para construir la documentación, usa:

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

¿Cómo escribir mi propio módulo?

Consulta la documentación.

Contribuciones

¡Las contribuciones son bienvenidas! Apreciaremos tanto ideas para nuevos módulos de Artemis (añadidas como issues de GitHub) como pull requests con nuevos módulos o mejoras de código.

Por obvio que parezca, te recordamos amablemente que al contribuir a Artemis, aceptas que la Licencia BSD 3-Cláusulas se aplicará automáticamente a tu aportación, sin necesidad de declaraciones adicionales.

Desarrollo

Antes de abrir un PR, asegúrate de instalar pre-commit:

• pre-commit install

Y ejecútalo en tus cambios.

Contribuyentes

Muchas gracias a las siguientes personas que contribuyeron al desarrollo de Artemis, especialmente al club científico KN Cyber de la Universidad de Tecnología de Varsovia que inició el proyecto.