Si vous souhaitez modifier/développer Artemis, lisez d'abord Développement.

Artemis est un logiciel expérimental, en développement actif – utilisez-le à vos risques et périls.

Pour discuter d'Artemis, rejoignez le serveur Discord !

Coopération et conférences

Artemis a été présenté au BlackHat USA 2024 à Las Vegas et au BlackHat Europe 2025 à Londres. Pour plus d'informations sur Artemis à BlackHat, cliquez ici et ici.

Le projet a également été présenté lors de la 71e réunion du TF-CSIRT à Copenhague, de la 69e réunion du TF-CSIRT à Bucarest et de la conférence CONFidence, entre autres.

Coopération

Le développement d'Artemis a été soutenu par Google Summer of Code 2024 et 2025.

Fonctionnalités

Pour une liste à jour des fonctionnalités, veuillez consulter la documentation. La plus importante est la possibilité d'exporter facilement des rapports tels que :

Les adresses suivantes contiennent des données de système de contrôle de version :

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

Rendre un dépôt de code public peut permettre à un attaquant de comprendre le fonctionnement interne d'un système, et s'il contient des mots de passe ou des clés API – d'obtenir un accès non autorisé. Ces données ne devraient pas être publiquement disponibles.

Les adresses suivantes contiennent d'anciennes versions de Joomla :

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

Si un site n'est plus utilisé, nous recommandons de l'arrêter pour éliminer le risque d'exploitation de vulnérabilités connues dans d'anciennes versions de Joomla. Sinon, nous recommandons des mises à jour régulières du cœur de Joomla et des plugins.

La possibilité de préparer automatiquement de tels rapports nous a permis de notifier les entités de notre circonscription de centaines de milliers de vulnérabilités.

Captures d'écran

Développement

Pour démarrer une version modifiée localement d'Artemis, exécutez :

Ce script copie automatiquement le fichier d'environnement d'exemple (env.example) vers .env s'il n'existe pas. Vous pouvez ensuite configurer les paramètres dans le fichier .env selon vos besoins. Cela inclut la personnalisation du user-agent en définissant la variable CUSTOM_USER_AGENT, ainsi que d'autres paramètres pertinents. Pour une liste complète des variables de configuration et leurs descriptions, veuillez vous référer à la section Configuration de la documentation.

L'image Artemis est ensuite construite localement (à partir du code que vous développez), et non téléchargée depuis Docker Hub. Pour le web, vous pourrez également voir les résultats des modifications de code sur la page sans recharger l'ensemble du conteneur.

Tests

Pour exécuter les tests, utilisez :

[!WARNING] Évitez d'utiliser python -m unittest directement comme command: dans docker-compose.test.yaml. Lorsque Python s'exécute en tant que PID 1, les sous-processus, en particulier les binaires Go comme Nuclei, souffrent d'E/S lentes ou dégradées car le PID 1 gère les signaux et stdout/stderr différemment. Utilisez plutôt unittest-parallel, car ses processus de travail évitent le problème du PID 1.

Formatage du code

Artemis utilise pre-commit pour exécuter les linters et formater le code. pre-commit est exécuté sur le CI pour vérifier que le code est correctement formaté.

Pour l'exécuter localement, utilisez :

Pour configurer pre-commit afin qu'il s'exécute avant chaque commit, utilisez :

Modification des dépendances

Nous utilisons pip-tools pour gérer les dépendances. Pour ajouter ou mettre à jour une dépendance :

1. Modifiez requirements.in (ou docs/requirements.in pour les dépendances de documentation),
2. Exécutez ./scripts/compile-requirements pour générer le(s) fichier(s) requirements.txt figé(s),
3. Commitez les fichiers .in et .txt.

Construction de la documentation

Pour construire la documentation, utilisez :

Comment écrire mon propre module ?

Veuillez vous référer à la documentation.

Contribuer

Les contributions sont les bienvenues ! Nous apprécierons à la fois les idées de nouveaux modules Artemis (ajoutées en tant que issues GitHub) ainsi que les pull requests avec de nouveaux modules ou des améliorations de code.

Aussi évident que cela puisse paraître, nous vous rappelons qu'en contribuant à Artemis, vous acceptez que la licence BSD 3-Clause s'applique automatiquement à votre apport, sans qu'aucune déclaration supplémentaire ne soit nécessaire.

Développement

Avant d'ouvrir une PR, veuillez vous assurer d'installer pre-commit :

• pre-commit install

Et exécutez-le sur vos modifications.

Contributeurs

Un grand merci aux personnes suivantes qui ont contribué au développement d'Artemis, en particulier au club scientifique KN Cyber de l'Université de Technologie de Varsovie qui a initié le projet !