방화벽 관리자 API 프로젝트

설치

API 프로젝트를 설정하고 실행하려면 다음 단계를 따르세요:

1. 리포지토리 복제

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

2. `.env` 파일 편집

.env 파일의 환경 변수를 설정에 맞게 업데이트하세요.

nano .env

3. Docker Compose로 API 시작

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

인기