
확장 가능한 MacOS 시스템 텔레메트리 생성기.
MacNoise는 EDR 검증 및 탐지 엔지니어링을 위해 실제 macOS 활동을 생성합니다. 개별 모듈 또는 YAML 시나리오를 실행하여 네트워크 연결, 파일 쓰기, 프로세스 실행, 지속성, TCC 접근 및 기타 동작을 보안 통제에 대해 시험할 수 있습니다.
동기와 설계에 대한 배경은 릴리스 블로그 게시물을 참조하세요.
MacNoise는 소유하고 있거나 테스트에 대한 명시적 서면 허가를 받은 시스템에서 승인된 보안 테스트를 위해 사용하도록 의도되었습니다. 모듈은 설명된 실제 활동을 수행합니다. 샌드박스화되지 않으며, 일부 작업은 시스템 및 사용자 데이터를 되돌릴 수 없이 삭제하거나 변경할 수 있습니다. 실행 전에 모듈 동작과 드라이런 출력을 검토하세요. 대상 선택, 승인 및 결과에 대한 책임은 사용자에게 있습니다. 작성자는 오용에 대해 어떠한 책임도 지지 않습니다.
Go 1.24 이상과 Make를 사용하여 체크아웃에서 빌드하세요:
make build
macOS에서 바이너리를 실행합니다. 크로스 컴파일하려면 Intel Mac의 경우 make build-amd64, Apple silicon의 경우 make build-arm64, 둘 다의 경우 make release를 사용합니다.
모듈을 나열하고 실행하려는 모듈을 검사합니다:
./macnoise list
./macnoise info file_create
매개변수를 미리 본 뒤 --dry-run 없이 동일한 명령을 실행하세요:
./macnoise run file_create --param count=1 --dry-run
./macnoise run file_create --param count=1
두 번째 명령은 파일을 생성하고, 텔레메트리를 내보내며, 정리를 실행합니다. 연결된 모듈 시퀀스를 미리 보려면:
./macnoise scenario configs/scenarios/file_flow.yaml --dry-run
시나리오 실행으로 모듈 출력을 연결하고, 분석을 위해 출력 캡처를 수행하거나, 이후 스캔을 위해 아티팩트 보존을 사용하세요.
생성된 모듈 카탈로그에는 모든 모듈, 매개변수, 출력, 이벤트 유형, 권한 및 ATT&CK 매핑이 나열되어 있습니다. 카테고리 가이드에서는 플랫폼 요구 사항과 모듈 동작을 설명합니다:
| 카테고리 | 설명 |
|---|---|
| network | TCP 연결, HTTP, 리스너, 리버스 셸, DNS 및 TLS |
| process | 실행, 시그널 전달, dylib 주입, Gatekeeper 우회 및 osascript |
| file | 탐색, 읽기, 복사, 생성, 수정, 아카이빙, 은닉 및 디코이 암호화 |
| tcc | 전체 디스크 접근, 연락처, 손쉬운 사용 및 화면 기록 프로브 |
| credential | 네이티브 자격 증명 저장소 접근 |
| volume | 디스크 이미지 생성 및 마운트된 볼륨 수명 주기 |
| service | Launchd 열거, LaunchAgent 및 LaunchDaemon 지속성, cron, 셸 프로필 및 로그인 항목 |
| plist | Plist 생성 및 수정 |
| evasion | 로그 삭제, 타임스톰핑, 기록 제거 및 위장 |
./macnoise list --category network를 사용하여 목록을 필터링하세요. 카테고리 또는 등록된 모든 모듈을 실행하려면 ./macnoise run --category network 또는 ./macnoise run --all을 사용하세요.
macnoise run <module> [--param key=val ...] Run a specific module
macnoise run --category <cat> Run all modules in a category
macnoise run --all Run all modules
macnoise list [--category <cat>] List modules
macnoise info <module> Show module details, params, MITRE
macnoise scenario <file.yaml> [--input key=val] [--report report.json]
Run a YAML scenario
macnoise categories List categories with counts
macnoise version Print version
| 플래그 | 기본값 | 설명 |
|---|---|---|
--format | human | 출력 형식: human 또는 jsonl |
--output | (없음) | 출력을 파일에 기록 (stdout에 추가로) |
--verbose | false | 현재 출력을 변경하지 않고 허용됨 |
--dry-run | false | 실행하지 않고 작업 미리보기 |
--no-cleanup | false | 실행 후 아티팩트 유지 |
--timeout | 30 | 모듈별 타임아웃(초). 0은 타임아웃 비활성화 |
--audit-log | (없음) | OCSF 1.7.0 감사 레코드를 JSONL 파일에 기록 |
--config | (없음) | YAML 구성 파일에서 기본값 로드 |
--run-id | 생성됨 | 이 실행의 상관 관계 식별자 설정 |
기본적으로 MacNoise는 실행 후 모듈 정리를 수행합니다. 정리는 호출이 생성했으며 여전히 소유하는 아티팩트를 제거합니다. 완료된 네트워크, 프로세스 또는 파괴적 활동을 되돌릴 수는 없습니다.
스택이 지속성을 자체적으로 탐지하는지 검증하려면 스캔이 실행되는 동안 아티팩트를 그대로 두십시오. 예로는 ~/Library/LaunchAgents의 LaunchAgent, cron 항목, 수정된 셸 프로필이 있습니다:
./macnoise run svc_launch_agent --no-cleanup
정리를 건너뛰는 각 모듈은 진단 메시지를 출력하며, 감사 로그에는 cleanup_result: skipped가 기록됩니다. 모듈 카탈로그와 카테고리 가이드를 사용하여 모듈이 생성하는 아티팩트를 검토하십시오.
이러한 아티팩트를 제거하는 것은 사용자의 책임입니다. 플래그 없이 동일한 모듈을 다시 실행하면 해당 실행에서 생성된 것만 정리되며, 이전 --no-cleanup 실행이 남긴 것은 정리되지 않습니다.
MacNoise는 시도된 작업에 대한 자체 설명을 stdout으로 출력합니다. 보안 제어 장치는 호스트의 활동으로부터 자체 텔레메트리를 수집합니다. 구조화된 MacNoise 이벤트에는 --format jsonl을 사용하고, 파일에 사본을 추가하려면 --output을 사용하십시오:
./macnoise scenario configs/scenarios/file_flow.yaml --format jsonl --output /tmp/events.jsonl
--audit-log를 추가하여 모듈 실행, 사전 요구 사항 및 정리 결과, MITRE 매핑을 OCSF 1.7.0 JSONL로 기록합니다:
./macnoise scenario configs/scenarios/file_flow.yaml --audit-log /tmp/audit.jsonl
실행 식별자, 미리보기, 정리 진단은 stderr로 출력됩니다. 모든 텔레메트리 이벤트는 스키마 2.0에서 outcome과 하나의 타입이 지정된 subject를 포함합니다. subject는 관련된 파일, 프로세스, 네트워크 엔드포인트, 서비스 또는 리소스를 식별합니다:
outcome | 의미 | 사람용 표시자 |
|---|---|---|
executed | 작업이 실행되었고 모듈이 주장하는 대로 동작함 | [+] |
denied | 작업이 실행되었으나 환경이 이를 거부함 | [-] |
indeterminate | 작업이 실행되었으나 어떤 결론도 내릴 수 없음 | [?] |
error | MacNoise 자체가 작업을 수행하지 못함 | [!] |
거부된 TCC 프로브는 환경이 거부한 작업을 기록합니다. error는 MacNoise가 작업을 수행하지 못했음을 의미합니다. 감사 로그는 unmapped.outcome에 결과를 기록합니다. 민감한 것으로 선언된 매개변수는 관리형 감사 매개변수에서 [REDACTED]로 대체되며, 명령줄 식별 정보는 --param 및 --input 값을 삭제합니다.
감사 로그는 실행 전반에 걸쳐 레코드를 추가합니다. --run-id를 사용하여 상관 식별자를 설정하거나 MacNoise가 이를 생성하도록 하십시오. 이벤트 분류 세부 사항은 CONTRIBUTING.md를 참조하십시오.
시나리오는 하나의 YAML 파일에서 모듈을 순서가 지정된 시퀀스로 연결합니다. 시나리오를 미리 본 다음 실행하고 보고서를 작성하십시오:
./macnoise scenario configs/scenarios/file_flow.yaml --dry-run
./macnoise scenario configs/scenarios/file_flow.yaml --report /tmp/report.json
configs/scenarios/에서 스톡 시나리오를 선택하세요:
| 파일 | 설명 |
|---|---|
network_only.yaml | TCP, 리스너, DNS, HTTP 비콘, HTTP 유출 작업을 조합한 시나리오 |
edr_validation.yaml | 포괄적인 EDR 탐지 커버리지 |
full_sweep.yaml | 모든 카테고리 |
lazarus_group.yaml | Lazarus Group: dylib 주입, 서비스 탐색, 리버스 셸, LaunchAgent 지속성 |
amos_atomic_stealer.yaml | AMOS / Atomic Stealer: MaaS 인포스틸러, Gatekeeper 우회, 키체인 덤프, ZIP 유출, 백도어 지속성 |
clickfix.yaml | ClickFix: Terminal에 붙여넣는 난독화된 원라이너, base64 디코드, 2단계 페치, LaunchAgent 지속성 |
ransomware.yaml | 랜섬웨어 영향: 평문 미끼 파일 배치, 암호화, 그다음 몸값 요구 노트 드롭 |
discovery.yaml | argv 기반 시스템, 계정, 네트워크, 보안 소프트웨어 탐색 레시피를 조합한 시나리오 |
process_chain.yaml | 명시적 인자 벡터로 구성된 3개 프로세스 셸 체인 |
file_flow.yaml | 생성, 수정, 범위 제한 탐색, 읽기, 복사, 아카이브가 연결된 흐름 |
mounted_execution.yaml | 관찰된 디스크 이미지 마운트 지점에서 페이로드를 생성하고 실행 |
AMOS 시나리오는 시퀀스와 단계 주석에 사용된 위협 보고서를 인용합니다. Lazarus 시나리오는 대표적인 macOS 기법들을 하나의 시퀀스로 묶습니다. 각 단계 주석에는 해당 단계가 실행하는 MITRE ATT&CK 기법 이름이 표시됩니다.
실행 보고서를 보안 제어가 수집한 텔레메트리 및 경보와 비교하세요. 누락된 경보는 해당 작업의 결과와 탐지 규칙을 기준으로 조사해야 합니다.
시나리오 파일은 version: 1을 사용합니다. 다음 예시는 타입이 지정된 입력을 file_create에 전달한 다음, 선언된 path 출력을 아카이브합니다. archive.yaml로 저장하세요: