stolenusername/cowitness
CoWitness est un outil puissant de test d'applications web qui améliore la précision et l'efficacité de vos efforts de test. Il vous permet de simuler un serveur HTTP et un serveur DNS, fournissant des réponses complètes et des informations précieuses au cours de votre processus de test.
CoWitness est un outil conçu pour fonctionner comme un serveur HTTP, HTTPS et DNS. Il vous permet de servir des pages web, de consigner les requêtes HTTP et de personnaliser les réponses DNS. Ce README donne un aperçu des fonctionnalités et des instructions sur la façon de compiler et d'utiliser l'outil CoWitness.
Serveur HTTP : CoWitness inclut un serveur HTTP qui écoute sur le port 80. Il peut servir des fichiers statiques depuis le répertoire de travail actuel. Chaque requête HTTP est enregistrée, y compris l'adresse IP du client, la ressource demandée et l'agent utilisateur.
Serveur HTTPS : En plus du serveur HTTP, CoWitness fournit également un serveur HTTPS qui écoute sur le port 443. Comme le serveur HTTP, il sert des fichiers statiques et enregistre chaque requête.
Serveur DNS : CoWitness fonctionne comme un serveur DNS, écoutant sur le port 53. Il vous permet de personnaliser les réponses DNS, y compris les enregistrements NS et A. Les requêtes DNS sont enregistrées, y compris l'adresse IP du client et le domaine demandé.
Journalisation : CoWitness crée des fichiers journaux pour les requêtes HTTP et DNS. Les logs sont ajoutés aux fichiers existants, ce qui vous permet de suivre et d'analyser l'activité du serveur.
Mode silencieux : CoWitness peut s'exécuter en mode silencieux en passant l'argument -q en ligne de commande. Dans ce mode, la bannière en art ASCII ne s'affiche pas.
Avant d'utiliser CoWitness, assurez-vous de disposer des éléments suivants :
Suivez ces étapes pour installer et compiler CoWitness :
git clone https://github.com/your-username/CoWitness.git
cd CoWitness
make -f Makefile build
Cette commande compile le code source de CoWitness et crée un fichier exécutable pour amd64 et arm64.
Pour utiliser CoWitness sur un serveur distant, suivez ces étapes :
Connectez-vous au serveur distant via SSH :
ssh username@your-server-ip
Un moyen simple d'installer CoWitness est d'obtenir le package automatisé construit ici que vous pouvez ensuite récupérer avec curl ou wget sur votre système, ou copier le fichier depuis votre système avec scp.
cowitness
Vous pouvez personnaliser CoWitness selon vos besoins spécifiques. Voici quelques modifications possibles :
Modifier les ports par défaut : consultez l'aide d'utilisation pour les options en ligne de commande permettant de changer les ports par défaut.
Modifier les chemins des fichiers journaux : vous pouvez changer les chemins des fichiers journaux HTTP et DNS (http.log et dns.log) en mettant à jour les appels os.OpenFile dans le code source.
Nous accueillons favorablement les contributions et les retours de la communauté. Si vous rencontrez des problèmes ou avez des suggestions d'amélioration, veuillez ouvrir une issue ou soumettre une pull request sur notre dépôt GitHub !
CoWitness est publié sous la licence MIT.