watchman-http-server 0.4.0

Un serveur HTTP FastAPI pour récupérer les applications installées

Watchman HTTP Server

Watchman HTTP Server est un serveur FastAPI qui expose la liste des applications installées ainsi que des informations sur le système.

Installation

Installez le package via pip :

pip install watchman_http_server

Ou depuis le code source :

git clone https://github.com/votre-repo/watchman_http_server.git
cd watchman_http_server
pip install -e .

Utilisation

Lancer le serveur avec un port et une clé API spécifiés :

watchman-server --port 8000 --api-key "VOTRE_CLE_API"

Configuration

• --port : Définit le port d'écoute du serveur (par défaut : 8001).
• --api-key : Spécifie la clé API requise pour accéder aux endpoints.

Endpoints

GET /apps

Retourne la liste des applications installées et les informations du système.

Headers requis

WATCHMAN-API-KEY: VOTRE_CLE_API

Exemple de réponse

{
  "system_info": {
    "hostname": "mon-pc",
    "ip": "192.168.1.10",
    "mac": "A1:B2:C3:D4:E5:F6",
    "architecture": "x86_64",
    "os": "Windows 10"
  },
  "applications": [
    {
      "name": "Google Chrome",
      "version": "99.0.4844.84",
      "vendor": "Google LLC",
      "type": "application"
    }
  ]
}

Déploiement sur un réseau local

Pour rendre le serveur accessible sur un réseau local :

1. Lancer le serveur avec 0.0.0.0 comme hôte :

   watchman-server --port 8000 --api-key "VOTRE_CLE_API"
   

2. Assurez-vous que le port est ouvert dans le pare-feu :
   • Windows :

     netsh advfirewall firewall add rule name="Watchman" dir=in action=allow protocol=TCP localport=8000
     

   • Linux :

     sudo ufw allow 8000/tcp
     

Contributions

Les contributions sont les bienvenues ! Clonez le projet, créez une branche et proposez vos modifications via une pull request.

Licence

Ce projet est sous licence MIT.