Проект API менеджера брандмауэра

Установка

Выполните следующие шаги для настройки и запуска API проекта:

1. Клонировать репозиторий

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

2. Отредактировать файл `.env`

Обновите переменные окружения в .env в соответствии с вашей конфигурацией.

nano .env

3. Запустить API с помощью Docker Compose

docker compose up -d

Это запустит API в фоновом режиме.

4. Проверить, что API работает

Проверьте, запущены ли контейнеры:

docker ps

Дополнительные команды

Остановить API

docker compose down

Перезапустить API

docker compose restart

Дайте знать, если нужны изменения! 🚀

Как настроить в первый раз и подключиться к клиенту брандмауэра

Установите агент брандмауэра на ваш сервер узла
Запустите агент следующей командой

sudo dpkg -i firewall-client_deb.deb

Создайте новую группу в менеджере брандмауэра
Создайте новый API-ключ в менеджере брандмауэра
Отредактируйте файл конфигурации на сервере узла

nano /usr/local/bin/config.ini

Добавьте следующую конфигурацию

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

Перезапустите агент брандмауэра

systemctl daemon-reload
systemctl start firewall-agent

Проверьте статус агента брандмауэра

systemctl status firewall-agent

Вы увидите подключенный узел в менеджере брандмауэра

Учетные данные по умолчанию

Username: admin
Password: admin

Вы можете изменить учетные данные по умолчанию на странице настроек

Как интегрировать с SIEM

Установите SIEM на ваш сервер
Настройте SIEM на отправку логов в менеджер брандмауэра (это можно сделать через конфигурацию SOAR или SIEM) Запрос должен быть POST со следующим форматом
Формат лога должен быть таким

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 ''

Вы можете увидеть документацию Swagger по следующей ссылке

http://api-server:8000/docs

Детальная конфигурация .env

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

Поддержать проект 💖

Если вы находите этот проект полезным, подумайте о поддержке через GitHub Sponsors:

CentralizedFirewall

Популярное