Projet API Firewall Manager

Installation

Suivez ces étapes pour configurer et exécuter le projet API :

1. Clonez le dépôt

git clone https://github.com/adriyansyah-mf/CentralizedFirewall
cd CentralizedFirewall

2. Modifiez le fichier .env

Mettez à jour les variables d'environnement dans .env selon votre configuration.

nano .env

3. Démarrez l'API avec Docker Compose

docker compose up -d

Cela démarrera l'API en mode détaché.

4. Vérifiez que l'API fonctionne

Vérifiez si les conteneurs sont en cours d'exécution :

docker ps

Commandes supplémentaires

Arrêter l'API

docker compose down

Redémarrer l'API

docker compose restart

Faites-moi savoir si vous avez besoin de modifications ! 🚀

Comment configurer pour la première fois et se connecter au client firewall

1. Installez l'Agent Firewall sur votre serveur nœud
2. Exécutez l'agent avec la commande suivante

sudo dpkg -i firewall-client_deb.deb

3. Créez un nouveau groupe dans le Firewall Manager
4. Créez une nouvelle clé API dans le Firewall Manager
5. Modifiez le fichier de configuration sur le serveur nœud

nano /usr/local/bin/config.ini

6. Ajoutez la configuration suivante

[settings]
api_url = API-URL
api_key = API-KEY
hostname = Node Hostname (make it unique and same as the hostname on the SIEM) 

7. Redémarrez l'agent firewall

systemctl daemon-reload
systemctl start firewall-agent

8. Vérifiez le statut de l'agent firewall

systemctl status firewall-agent

9. Vous verrez le nœud connecté dans le Firewall Manager

Identifiants par défaut

Username: admin
Password: admin

Vous pouvez modifier les identifiants par défaut dans la page des paramètres

Comment intégrer avec SIEM

1. Installez le SIEM sur votre serveur
2. Configurez le SIEM pour envoyer les logs au Firewall Manager (Vous pouvez le faire via la configuration SOAR ou SIEM) La requête doit être de type POST avec le format suivant
3. Le format du log doit être comme ceci

curl -X 'POST' \
  'http://api-server:8000/general/add-ip?ip=123.1.1.99&hostname=test&apikey=apikey&comment=log' \
  -H 'accept: application/json' \
  -d ''

Vous pouvez voir la documentation Swagger au lien suivant

http://api-server:8000/docs

La configuration détaillée du fichier .env

DB=changeme
JWT_SECRET=changeme
PASSWORD_SALT=changme
PASSWORD_TOKEN_KEY=changme
OPENCTI_URL=changme
OPENCTI_TOKEN=changme

Sponsorisez ce projet 💖

Si vous trouvez ce projet utile, envisagez de me soutenir via GitHub Sponsors :