Ubuntu 시스템의 포렌식 트리아지를 위한 Python CLI/TUI — 아티팩트 수집, 타임라인 상관 분석, Wazuh 통합을 통해 지속성 메커니즘을 탐지하고 치료합니다.
라이브 Ubuntu 시스템을 위한 포렌식 트리아지 — 약 1분 만에 자동화된 아티팩트 수집, 지속성 탐지, 가이드 기반 교정을 수행합니다.
Linux 시스템이 침해되었다고 의심될 때, 처음 30-40분은 보통 동일한 열 가지 명령을 순서대로 실행하는 데 소비됩니다. 실행 중인 프로세스를 확인하고, 이상한 cron 작업을 찾고, LD_PRELOAD를 grep하고, authorized_keys에서 새 항목을 스캔하고, sudoers를 감사합니다. 각 단계는 수동이고, 컨텍스트 전환이 필요하며, 압박 속에서 오류가 발생하기 쉽습니다. 한 가지 소스를 놓치면 — 예를 들어 /etc/sudoers만 보고 /etc/sudoers.d/를 빠뜨리거나, /etc/cron.d/ 외에 사용자 crontab을 놓치면 — 불완전한 그림을 갖게 됩니다.
기존 옵션들은 이 문제를 깔끔하게 해결하지 못합니다. lynis는 트리아지 도구가 아니라 하드닝 감사 도구입니다 — 깨끗한 시스템에서는 구성 약점을 보고하고, 이미 감염된 시스템에서는 노이즈를 생성합니다. chkrootkit과 rkhunter는 알려진 루트킷 시그니처를 검사하지만, 악용된 systemd 타이머나 정상처럼 보이는 cron 항목 같은 새로운 지속성 기법에는 눈이 먼 상태입니다. 일반적인 SIEM 쿼리는 보고 있는 시스템에 존재하지 않을 수 있는 로그 인프라를 필요로 합니다. 그리고 Volatility 같은 포렌식 제품군은 실행 중인 호스트의 라이브 셸이 아니라 메모리 이미지를 대상으로 합니다.
이 격차를 메우는 도구는 바로 지금 라이브 시스템에서 실행되고, 가장 흔한 지속성 벡터를 포괄하며, 여러 로그 소스에 걸친 활동을 타임라인으로 상관시키고, 외부 에이전트나 데이터베이스, 인터넷 연결 없이 정확히 무엇을 살펴봐야 하는지 알려주는 도구입니다.
ubuntils는 네 가지 순차적 단계로 실행됩니다:
/proc, cron 테이블, systemd 유닛, SSH 키, sudoers 파일, 환경 정의, 패키지 무결성(dpkg --verify), PAM/NSS 구성, 로드된 커널 모듈에서 포렌식 아티팩트를 동시에 수집합니다. 대부분의 수집기는 1-2초 안에 끝나지만, 설치된 모든 패키지 파일을 다시 검사하는 dpkg --verify가 압도적으로 시간을 차지합니다 — Ubuntu 26.04 arm64 데스크톱 VM에서 전체 스캔은 29–68초가 걸렸습니다.--rules로 로드된 사용자 정의 규칙을 수집된 아티팩트에 대해 실행하여, 약 1초 만에 순위가 매겨지고 신뢰도 점수가 부여된 발견 목록을 생성합니다.--json)으로 나타납니다.ubuntils 자체는 네트워크 호출을 하지 않으며, 사용자 정의 규칙과 상관 분석을 포함한 모든 기능이 로컬에서 수집된 아티팩트에 대해 실행됩니다. 발견 사항이 호스트를 떠날 수 있는 유일한 방법은 Wazuh 통합입니다: Wazuh 에이전트가 설치되어 있으면 라이브 scan이 발견 사항을 로컬 파일에 기록하고, 에이전트가 이를 매니저로 전송합니다. 실행 시 이를 끄려면 --no-wazuh를 전달하세요.
ubuntils scan은 아래의 모든 변경에도 그대로 유지됩니다 — 여전히 100% 라이브, 단일 호스트 방식이며, 기존의 모든 플래그가 동일하게 작동합니다. 두 가지 추가 명령인 collect와 analyze는 동일한 탐지/타임라인 파이프라인을 오프라인 친화적인 수집 후 분석(acquire-then-analyze) 워크플로로 분리한 것으로, 조사 대상 호스트에서 직접 탐지를 실행할 수 없거나 실행하고 싶지 않은 경우를 위한 것입니다 — 아래의 오프라인 분석: collect와 analyze를 참조하세요. 여기에는 탐지 범위에 대한 주의사항도 포함되어 있습니다.
Ubuntu 22.04+ 및 PEP 668을 적용한 모든 시스템(권장):
Ubuntu 22.04+는 시스템 전역 pip install을 차단합니다. pipx를 사용하세요 — 환경을 투명하게 처리해 주므로 신경 쓸 필요가 없습니다:
sudo apt install pipx -y
pipx ensurepath # then open a new shell
git clone https://github.com/asmitdesai/ubuntils.git
cd ubuntils
pipx install -e .
ubuntils scan # not `ubuntils scan` — see below
일반 사용자로 실행하세요: scan과 collect는 sudo 아래에서 스스로를 다시 호출합니다. 직접 ubuntils …를 입력하면 command not found로 실패하는데, sudo의 secure_path에 pipx가 명령을 설치하는 ~/.local/bin이 포함되지 않기 때문입니다. 루트 셸에서 시작해야 한다면 설치된 바이너리를 경로로 호출하거나(~youruser/.local/bin/ubuntils scan), 대신 가상 환경에 설치하세요:
python3 -m venv .venv
.venv/bin/pip install -e .
.venv/bin/ubuntils scan
구형 시스템 / 수동 설치:
git clone https://github.com/asmitdesai/ubuntils.git
cd ubuntils
pip install -r requirements.txt -e .
ubuntils scan
ubuntils는 전체 아티팩트에 접근하려면 root 권한이 필요합니다. 비-root 사용자로 ubuntils scan을 실행하면 동일한 Python 인터프리터(절대 경로 기준)를 사용하여 자동으로 sudo로 재실행되므로, PATH를 root 프로세스로 전달하지 않고도 올바른 환경이 사용됩니다. 모든 외부 명령(ss, dpkg, systemctl, …)은 고정된 root 소유 검색 경로에서 확인되며, 사용자의 PATH는 절대 사용되지 않습니다. root 없이 실행하면 /etc/shadow, 일부 /proc 항목, 보호된 cron 파일을 건너뛰고 각각에 대해 경고를 기록합니다.
탐지만 — 대화형 TUI:
ubuntils scan
JSON 출력을 파일로 저장한 탐지:
ubuntils scan --json > /tmp/triage-$(hostname)-$(date +%Y%m%d).json
CLI 복구 미리보기를 통한 탐지 (드라이 런 — 변경 사항 적용되지 않음):
ubuntils scan --remediate
CLI 교정 적용 후 탐지:
ubuntils scan --remediate --confirm
인쇄 버전:
ubuntils version
나중에 또는 오프라인 분석을 위해 변조 방지 번들을 수집하세요:
ubuntils collect --output /path/to/bundle.tar.gz
이전에 수집된 번들 분석(루트 권한 불필요):
ubuntils analyze /path/to/bundle.tar.gz --json
번들 대신 마운트된 포렌식 이미지 또는 추출된 파일시스템 트리를 분석합니다:
ubuntils analyze --root /mnt/forensic-image --json
See 오프라인 분석: 수집 및 분석에서 번들 형식과 — 중요한 점으로 — 라이브 scan과 비교하여 오프라인 분석이 감지할 수 없는 항목을 확인하세요.
ubuntils scan [OPTIONS]
--json Output JSON to stdout instead of launching the TUI
--output FILE Write the JSON report to FILE (implies --json)
--remediate Run the remediation engine after detection
--confirm Required with --remediate to actually apply changes (else dry-run)
--min-confidence N Only auto-remediate findings with confidence >= N (default 40)
--no-wazuh Never forward findings to a local Wazuh agent
--config FILE YAML allowlist of findings to suppress (see below)
--baseline FILE YAML baseline of environment-specific known-good fingerprints to suppress (see below)
--since TIME Limit the timeline to events since TIME (e.g. '24h', '7d', '2026-05-20')
--rules FILE YAML file of custom detection rules to add (see below)
--verbose Verbose structlog output
ubuntils collect [OPTIONS]
--output FILE Bundle path to write (default ./ubuntils-bundle-<timestamp>.tar.gz)
--verbose Verbose structlog output
ubuntils analyze (BUNDLE | --root PATH) [OPTIONS]
--root PATH Analyze a mounted image / artifact tree instead of a bundle
--json Output JSON instead of launching the TUI
--output FILE Write the JSON report to FILE (implies --json)
--config FILE YAML allowlist of findings to suppress (same format as scan)
--baseline FILE YAML baseline of environment-specific known-good fingerprints to suppress (same format as scan)
--rules FILE YAML file of custom detection rules to add (same format as scan)
--since TIME Limit the timeline to events since TIME (e.g. '24h', '7d', '2026-05-20')
--verbose Verbose structlog output
ubuntils version
Print version string and exit
--config)새로 프로비저닝되었거나 CI로 관리되는 호스트는 예상된 노이즈를 생성합니다 — 배포 키, 프로비저닝 crontab, 내장된 셸 초기화 등입니다. 대응 담당자에게 이를 정신적으로 걸러내도록 가르치는 대신, YAML 허용 목록으로 명시적으로 억제하세요:
# allowlist.yaml
allowlist:
rules:
- SHELL_RC_MODIFICATION # suppress this rule entirely
paths:
- /home/ci/.ssh/authorized_keys # suppress any finding on this exact path
ubuntils scan --json --config allowlist.yaml
억제는 항상 명시적입니다 — 규칙 ID 및/또는 정확한 아티팩트 경로로 지정합니다. "모든 것을 무시"하는 포괄적 스위치는 없습니다. 샘플은 examples/allowlist.yaml에 있습니다.
--baseline)--config는 이 코드베이스에 대해 ubuntils를 실행하는 모든 사람에 대해 규칙이나 경로를 억제합니다. --baseline은 더 좁고 환경별입니다. 즉, "이 환경에서는 이 정확한 아티팩트 — 이 SSH 키, 이 RC 파일 — 가 알려진 정상"이라고 말하는 것으로, 같은 도구로 스캔하는 다른 모든 호스트에 대해 규칙이나 경로를 음소거하지 않습니다. --config와 별도의 파일로 유지되는 이유는 --rules가 별도인 이유와 같습니다. 억제와 규칙 전체 허용 목록은 하나의 파일에 있어서는 안 되는 서로 다른 관심사입니다.