
Zeek 네트워크 플로우에서 여러 우선순위 모델(신규, 지속적, 랜덤 포레스트)을 사용하여 효율적인 IPv4 블록리스트를 생성하고, 신규 및 지속적인 공격자를 식별하며, IoT 환경에 최적화된 도구입니다.
공격자 IP 우선순위화(AIP)는 허니팟 네트워크에서 캡처한 네트워크 트래픽을 기반으로 효율적이고 경제적인 IP 차단 목록을 생성하는 도구입니다.
5G의 등장으로 IoT 기기는 방화벽 보호 없이 직접 연결되는 경우가 많습니다. 따라서 우리에게는 작고 효율적이며 경제적인 차단 목록이 필요합니다. AIP의 구조는 아래와 같습니다.

각 AIP 모델은 특정 기준에 따라 자체적인 차단 목록을 생성합니다. 주요 모델은 다음과 같습니다:
AIP는 Docker(권장) 또는 Python으로 직접 실행할 수 있습니다. 어느 쪽이든 두 가지가 필요합니다:
Zeek 로그를 data/raw/에, 하루에 하나의 폴더로 배치합니다(예: data/raw/2024-10-22/conn.*). Docker를 사용하면 Zeek 로그를 복사하는 대신 AIP가 해당 폴더를 가리키도록 할 수 있습니다.
허니팟 IP를 data/external/에 배치합니다. 예제 파일을 복사하고 편집하세요:
cp data/external/honeypots_public_ips_example.csv data/external/honeypots_public_ips.csv
cp data/external/do_not_block_these_ips_example.csv data/external/do_not_block_these_ips.csv
honeypots_public_ips.csv (필수): 허니팟의 공인 IP입니다. AIP는 이 IP로 전송된 트래픽만 확인합니다.do_not_block_these_ips.csv (선택): 차단 목록에 절대 포함되어서는 안 되는 IP입니다.AIP 폴더에서, Zeek 로그가 /opt/zeek/logs/에 있다고 가정할 때:
docker run --rm \
-v /opt/zeek/logs/:/home/aip/AIP/data/raw:ro \
-v ${PWD}/data/:/home/aip/AIP/data/:rw \
--name aip stratosphereips/aip:latest bin/aip
이 명령은 오늘 날짜에 대해 모든 모델을 실행합니다. 아래의 명령어 중 하나를 사용하려면 bin/aip 뒤에 작성하세요. 예를 들어, 하루치 모든 모델을 실행하려면:
docker run --rm \
-v /opt/zeek/logs/:/home/aip/AIP/data/raw:ro \
-v ${PWD}/data/:/home/aip/AIP/data/:rw \
--name aip stratosphereips/aip:latest bin/aip run-models --start-date 2026-10-12 --end-date 2026-10-12
이미지를 직접 빌드하려면 Docker 가이드를 참조하세요.
git clone https://github.com/stratosphereips/AIP.git ~/AIP
cd ~/AIP
python3 -m venv aip-venv
source aip-venv/bin/activate
pip install -r requirements.txt
export PYTHONPATH=$(pwd)/lib
bin/aip --help
새 터미널을 열 때마다 source aip-venv/bin/activate와 export PYTHONPATH 줄을 다시 실행하세요.
| 원하는 작업 | 명령어 |
|---|---|
| 오늘 날짜에 대해 모든 모델 실행 | bin/aip |
| 하루치 모든 모델 실행 | bin/aip run-models --start-date 2026-10-02 --end-date 2026-10-02 |
| 여러 날짜에 대해 모든 모델 실행 | bin/aip run-models --start-date 2026-10-01 --end-date 2026-10-12 |
| 하나의 모델만 실행 | --model에 Alpha, Alpha7, Prioritize_New, Prioritize_Consistent 또는 Random_Forest 추가 |
| 특정 날짜부터 어제까지 공격자 이력 재구축 | bin/aip rebuild-kb --start-date 2026-10-01 |
알아두어야 할 사항:
--end-date를 생략하면 오늘로 설정됩니다. 따라서 --start-date만 지정하면 해당 날짜부터 오늘까지 매일 실행됩니다.data/output/<model name>/에 저장됩니다.bin/aip 바로 뒤에 -v(진행 상황) 또는 -d(전체 세부 정보)를 추가하세요. 예: bin/aip -v run-models.bin/aip --help로 확인하세요.Stratosphere AIP 도구는 GNU General Public License v3.0에 따라 라이선스가 부여됩니다.
이 도구는 체코 프라하의 체코 기술대학교 Stratosphere 연구소에서 개발되었습니다. 이는 Stratosphere 차단 목록 생성 프로젝트의 일부입니다.
이 도구는 원래 Thomas O'Hara의 학사 논문 The Attacker IP Prioritizer: An IoT Optimized Blacklisting Algorithm (2021)에서 시작되었습니다.