Comment ça marche ?

Hyperfox crée un serveur proxy HTTP transparent et le lie au port 1080/TCP sur localhost (-addr 127.0.0.1 -http 1080). Le serveur proxy lit les requêtes HTTP en clair et les redirige vers la destination cible (l'en-tête Host est utilisé pour identifier la destination). Lorsque la destination cible répond, Hyperfox intercepte la réponse et la transmet au client d'origine.

Toutes les communications HTTP entre l'origine et la destination sont interceptées par Hyperfox et enregistrées dans une base de données SQLite créée automatiquement. À chaque démarrage d'Hyperfox, une nouvelle base de données est créée (par exemple : hyperfox-00123.db). Vous pouvez modifier ce comportement en fournissant explicitement un nom de base de données (par exemple : -db traffic-log.db).

Utilisation

Lancez Hyperfox avec la configuration par défaut :

utilisez cURL pour demander n'importe quelle page HTTP, le paramètre -x indique à cURL d'utiliser hyperfox comme proxy :

vous devriez voir un journal de la page demandée dans la sortie d'Hyperfox :

Interface utilisateur (-ui)

Utilisez le paramètre -ui pour activer l'interface utilisateur d'Hyperfox qui s'ouvrira dans une nouvelle fenêtre de navigateur :

La commande ci-dessus crée un serveur web qui se lie à 127.0.0.1:1984. Si vous souhaitez modifier l'adresse ou le port, utilisez le commutateur -ui-addr :

Changer l'adresse du serveur UI est particulièrement utile lorsqu'Hyperfox fonctionne sur un hôte distant ou sans tête et que vous souhaitez voir l'interface depuis un autre hôte.

L'activation de l'UI active également une API REST minimale (sur 127.0.0.1:4891) qui est consommée par l'application front-end.

Veuillez noter que l'API REST d'Hyperfox n'est protégée que par une clé générée aléatoirement qui change à chaque démarrage d'Hyperfox. Selon votre cas d'utilisation, cela pourrait ne pas être adéquat.

Exécuter l'interface utilisateur Hyperfox sur votre appareil mobile

Lorsque le paramètre -ui-addr est différent de 127.0.0.1, Hyperfox affichera un code QR pour faciliter la connexion depuis des appareils mobiles :

Mode SSL/TLS (-ca-cert & -ca-key)

Les connexions SSL/TLS sont sécurisées de bout en bout et protégées contre les écoutes clandestines. Hyperfox ne pourra rien voir de ce qui se passe entre un client et une destination sécurisée. Cela n'est valable que tant que la chaîne de confiance reste intacte.

Supposons que le client fasse confiance à un certificat d'autorité de certification racine connu par Hyperfox. Si cela se produit, Hyperfox pourra émettre des certificats qui seront approuvés par le client.

Des exemples de tels fichiers d'autorité de certification racine factices peuvent être trouvés ici :

• Certificat CA Hyperfox
• Clé CA Hyperfox

vous pouvez aussi générer votre propre certificat et clé d'autorité de certification racine.

Il existe plusieurs façons d'installer les certificats d'autorité de certification racine, selon votre système d'exploitation.

Ce code QR peut être utile lors de l'installation du certificat racine d'Hyperfox sur un appareil mobile :

Certificat d'autorité de certification racine Hyperfox

Utilisez les flags -ca-cert et -ca-key pour fournir à Hyperfox le certificat et la clé d'autorité de certification racine que vous souhaitez utiliser :

la commande ci-dessus crée un serveur spécial et le lie à 127.0.0.1:10443. Ce serveur attend une connexion SSL/TLS. Lorsqu'une nouvelle connexion SSL/TLS arrive, Hyperfox utilise l'extension SNI pour identifier le serveur de noms de destination et créer un certificat SSL/TLS pour celui-ci. Ce certificat est signé avec la clé d'autorité de certification racine fournie.

Exemple d'interception TLS

Lancez Hyperfox avec les paramètres TLS appropriés et -http 443 (le port 443 nécessite des privilèges administrateur).

Utilisez cURL pour construire une requête HTTPs vers example.com : l'option -resolve indique à cURL d'ignorer la vérification DNS et d'utiliser 127.0.0.1 comme s'il s'agissait de l'adresse légitime pour example.com, tandis que le paramètre -k indique à cURL d'accepter n'importe quel certificat TLS.

vous devriez voir un journal de la page demandée dans la sortie d'Hyperfox :

Exemples d'utilisation

Via /etc/hosts sur localhost

Ajoutez l'hôte que vous souhaitez inspecter à votre fichier /etc/hosts :

Exécutez Hyperfox avec les options que vous souhaitez, rappelez-vous simplement que vous devez utiliser les ports 80 pour HTTP et 443 pour HTTPS, ce qui nécessite des privilèges administrateur. En plus de -http et -https, utilisez le paramètre -dns avec un résolveur DNS valide :

Cela fera en sorte qu'Hyperfox ignore le résolveur DNS du système d'exploitation et en utilise un alternatif (rappelez-vous que example.com pointe vers 127.0.0.1).

Utilisez maintenant cURL et essayez d'atteindre la destination :

Hyperfox capturera la requête et l'affichera dans sa sortie :

Via usurpation ARP sur un LAN

Voir Attaque MITM avec Hyperfox et arpfox.

Hacking

Choisissez un problème, corrigez-le et envoyez une pull request.

Licence

Copyright (c) 2012-aujourd'hui José Nieto, https://xiam.io

La permission est accordée, gratuitement, à toute personne obtenant une copie de ce logiciel et des fichiers de documentation associés (le "Logiciel"), de traiter le Logiciel sans restriction, y compris sans limitation les droits d'utiliser, copier, modifier, fusionner, publier, distribuer, sous-licencier et/ou vendre des copies du Logiciel, et de permettre aux personnes à qui le Logiciel est fourni de le faire, sous réserve des conditions suivantes :

L'avis de copyright ci-dessus et cet avis d'autorisation doivent être inclus dans toutes les copies ou parties substantielles du Logiciel.

LE LOGICIEL EST FOURNI "EN L'ÉTAT", SANS GARANTIE D'AUCUNE SORTE, EXPRESSE OU IMPLICITE, Y COMPRIS MAIS SANS S'Y LIMITER LES GARANTIES DE QUALITÉ MARCHANDE, D'ADÉQUATION À UN USAGE PARTICULIER ET DE NON-CONTREFAÇON. EN AUCUN CAS LES AUTEURS OU TITULAIRES DU COPYRIGHT NE SERONT RESPONSABLES DE TOUTE RÉCLAMATION, DOMMAGE OU AUTRE RESPONSABILITÉ, QUE CE SOIT DANS LE CADRE D'UNE ACTION CONTRACTUELLE, DÉLICTUELLE OU AUTRE, DÉCOULANT DE, OU EN RELATION AVEC LE LOGICIEL OU SON UTILISATION OU D'AUTRES INTERACTIONS AVEC LE LOGICIEL.