Skip to content
KitploitKITPLOIT
도구익스플로잇블로그
Log in
제출
도구익스플로잇블로그
제출

해킹, 침투 테스트 및 사이버 보안 도구를 당신의 보안 무기고에!

Kitploit은 해킹, 사이버 보안 및 침투 테스트 도구 디렉토리입니다. 최신 프로젝트 업데이트를 발견하여 취약점을 찾고, 시스템을 분석하고, 테스트를 자동화하고, 보안을 강화하세요.

피드문의개인정보© 2026 Kitploit

도구 디렉토리

카테고리

모든 카테고리 보기
Loading categories
macnoise — 확장 가능한 MacOS 시스템 텔레메트리 생성기. | Kitploit
도구/GitHubGitHub/0xv1n/macnoise
Defensive ToolsNetwork SecurityPenetration TestingThreat IntelligenceLearning & EducationRed TeamingIncident Response
GitHub0xv1n/macnoise

macnoise

확장 가능한 MacOS 시스템 텔레메트리 생성기.

저장소 보기
624824일 전Kitploit 검토 완료
공유
<div style="text-align: center;">
  <img src="https://assets.kitploit.com/production/public/readmes/12216/015e563e6db740a8025fff16e60052d282eafc29855ed07fd23f58cd1a3fc0e5.png" alt="MacNoise 로고" style="max-width: 100%; height: auto; display: block; margin: 0 auto;">
</div>

---

[![CI](https://github.com/0xv1n/macnoise/actions/workflows/ci.yaml/badge.svg)](https://github.com/0xv1n/macnoise/actions/workflows/ci.yaml)
[![Release](https://img.shields.io/github/v/release/0xv1n/macnoise)](https://github.com/0xv1n/macnoise/releases/latest)

# MacNoise

MacNoise는 EDR 검증 및 탐지 엔지니어링을 위해 실제 macOS 활동을 생성합니다. 개별 모듈 또는 YAML 시나리오를 실행하여 네트워크 연결, 파일 쓰기, 프로세스 실행, 지속성, TCC 접근 및 기타 동작을 보안 통제에 대해 시험할 수 있습니다.

동기와 설계에 대한 배경은 [릴리스 블로그 게시물](https://0xv1n.github.io/posts/macnoise/)을 참조하세요.

## 실행 전 확인 사항

MacNoise는 소유하고 있거나 테스트에 대한 명시적 서면 허가를 받은 시스템에서 **승인된** 보안 테스트를 위해 사용하도록 의도되었습니다. 모듈은 설명된 실제 활동을 수행합니다. 샌드박스화되지 않으며, 일부 작업은 시스템 및 사용자 데이터를 되돌릴 수 없이 삭제하거나 변경할 수 있습니다. 실행 전에 모듈 동작과 드라이런 출력을 검토하세요. 대상 선택, 승인 및 결과에 대한 책임은 사용자에게 있습니다. 작성자는 오용에 대해 어떠한 책임도 지지 않습니다.

## 빠른 시작

Go 1.24 이상과 Make를 사용하여 체크아웃에서 빌드하세요:

```bash
make build
```

macOS에서 바이너리를 실행합니다. 크로스 컴파일하려면 Intel Mac의 경우 `make build-amd64`, Apple silicon의 경우 `make build-arm64`, 둘 다의 경우 `make release`를 사용합니다.

모듈을 나열하고 실행하려는 모듈을 검사합니다:

```bash
./macnoise list
./macnoise info file_create
```

매개변수를 미리 본 뒤 `--dry-run` 없이 동일한 명령을 실행하세요:

```bash
./macnoise run file_create --param count=1 --dry-run
./macnoise run file_create --param count=1
```

두 번째 명령은 파일을 생성하고, 텔레메트리를 내보내며, 정리를 실행합니다. 연결된 모듈 시퀀스를 미리 보려면:

```bash
./macnoise scenario configs/scenarios/file_flow.yaml --dry-run
```

[시나리오 실행](#run-scenarios)으로 모듈 출력을 연결하고, 분석을 위해 [출력 캡처](#capture-output-and-audit-records)를 수행하거나, 이후 스캔을 위해 [아티팩트 보존](#retain-artifacts)을 사용하세요.

## 모듈 찾기

생성된 [모듈 카탈로그](https://github.com/0xv1n/macnoise/blob/main/docs/module-catalog.md)에는 모든 모듈, 매개변수, 출력, 이벤트 유형, 권한 및 ATT&CK 매핑이 나열되어 있습니다. 카테고리 가이드에서는 플랫폼 요구 사항과 모듈 동작을 설명합니다:

| 카테고리 | 설명 |
|----------|-------------|
| [network](https://github.com/0xv1n/macnoise/blob/main/modules/network/README.md) | TCP 연결, HTTP, 리스너, 리버스 셸, DNS 및 TLS |
| [process](https://github.com/0xv1n/macnoise/blob/main/modules/process/README.md) | 실행, 시그널 전달, dylib 주입, Gatekeeper 우회 및 osascript |
| [file](https://github.com/0xv1n/macnoise/blob/main/modules/file/README.md) | 탐색, 읽기, 복사, 생성, 수정, 아카이빙, 은닉 및 디코이 암호화 |
| [tcc](https://github.com/0xv1n/macnoise/blob/main/modules/tcc/README.md) | 전체 디스크 접근, 연락처, 손쉬운 사용 및 화면 기록 프로브 |
| [credential](https://github.com/0xv1n/macnoise/blob/main/modules/credential/README.md) | 네이티브 자격 증명 저장소 접근 |
| [volume](https://github.com/0xv1n/macnoise/blob/main/modules/volume/README.md) | 디스크 이미지 생성 및 마운트된 볼륨 수명 주기 |
| [service](https://github.com/0xv1n/macnoise/blob/main/modules/service/README.md) | Launchd 열거, LaunchAgent 및 LaunchDaemon 지속성, cron, 셸 프로필 및 로그인 항목 |
| [plist](https://github.com/0xv1n/macnoise/blob/main/modules/plist/README.md) | Plist 생성 및 수정 |
| [evasion](https://github.com/0xv1n/macnoise/blob/main/modules/evasion/README.md) | 로그 삭제, 타임스톰핑, 기록 제거 및 위장 |

`./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 | 실행 후 [아티팩트 유지](#retain-artifacts) |
| `--timeout` | `30` | 모듈별 타임아웃(초). `0`은 타임아웃 비활성화 |
| `--audit-log` | (없음) | OCSF 1.7.0 감사 레코드를 JSONL 파일에 기록 |
| `--config` | (없음) | YAML 구성 파일에서 기본값 로드 |
| `--run-id` | 생성됨 | 이 실행의 상관 관계 식별자 설정 |

## 아티팩트 유지

기본적으로 MacNoise는 실행 후 모듈 정리를 수행합니다. 정리는 호출이 생성했으며 여전히 소유하는 아티팩트를 제거합니다. 완료된 네트워크, 프로세스 또는 파괴적 활동을 되돌릴 수는 없습니다.

스택이 지속성을 자체적으로 탐지하는지 검증하려면 스캔이 실행되는 동안 아티팩트를 그대로 두십시오. 예로는 `~/Library/LaunchAgents`의 LaunchAgent, cron 항목, 수정된 셸 프로필이 있습니다:

```bash
./macnoise run svc_launch_agent --no-cleanup
```

정리를 건너뛰는 각 모듈은 진단 메시지를 출력하며, 감사 로그에는 `cleanup_result: skipped`가 기록됩니다. [모듈 카탈로그](https://github.com/0xv1n/macnoise/blob/main/docs/module-catalog.md)와 카테고리 가이드를 사용하여 모듈이 생성하는 아티팩트를 검토하십시오.

**이러한 아티팩트를 제거하는 것은 사용자의 책임입니다.** 플래그 없이 동일한 모듈을 다시 실행하면 해당 실행에서 생성된 것만 정리되며, 이전 `--no-cleanup` 실행이 남긴 것은 정리되지 않습니다.

## 출력 및 감사 기록 캡처

MacNoise는 시도된 작업에 대한 자체 설명을 stdout으로 출력합니다. 보안 제어 장치는 호스트의 활동으로부터 자체 텔레메트리를 수집합니다. 구조화된 MacNoise 이벤트에는 `--format jsonl`을 사용하고, 파일에 사본을 추가하려면 `--output`을 사용하십시오:

```bash
./macnoise scenario configs/scenarios/file_flow.yaml --format jsonl --output /tmp/events.jsonl
```

`--audit-log`를 추가하여 모듈 실행, 사전 요구 사항 및 정리 결과, MITRE 매핑을 [OCSF 1.7.0](https://schema.ocsf.io/) JSONL로 기록합니다:

```bash
./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](https://github.com/0xv1n/macnoise/blob/main/CONTRIBUTING.md#primitive-modules)를 참조하십시오.

## 시나리오 실행

시나리오는 하나의 YAML 파일에서 모듈을 순서가 지정된 시퀀스로 연결합니다. 시나리오를 미리 본 다음 실행하고 보고서를 작성하십시오:

```bash
./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`로 저장하세요:

```yaml
version: 1
name: Archive one generated artifact
on_error: stop
inputs:
  content:
    type: string
    required: true
steps:
  - id: create
    module: file_create
    params:
      filename: artifact.txt
      content:
        input: content
  - id: archive
    module: file_archive
    params:
      source_path:
        output: create.path
      tool: tar
      output_path: /tmp/macnoise_example.tar.gz
outputs:
  archive:
    output: archive.path
```

No input content was provided in your message — the "INPUT:" section is empty, so there is no text to translate.

Please send the actual chunk 21 content (the Markdown text to be translated), and I will return only the Korean translation with all Markdown structure, code, URLs, and identifiers preserved exactly as specified.

```bash
./macnoise scenario archive.yaml --input content=example --dry-run
```

MacNoise는 미리보기 또는 실행 전에 매개변수 유형, 이름, 참조를 검증합니다. 선언된 모듈 출력만 참조할 수 있습니다. `on_error`의 기본값은 `stop`입니다. 실패 후에도 이후 모듈 호출이 실행되어야 하는 경우 `continue`로 설정하세요. 취소는 항상 실행을 중지합니다.

`include` 단계를 사용하여 로컬 시나리오를 재사용하세요. include는 포함하는 파일을 기준으로 해석되며, 루트 시나리오 디렉터리 아래에 유지되고, 순환을 거부하며, 최대 8단계까지 허용합니다. MacNoise는 실행을 위해 하나의 비공개 작업 공간을 생성하고 호출된 모듈을 역순으로 정리합니다. `--no-cleanup`을 사용하지 않는 한 정리 과정에서 생성된 아티팩트가 제거되므로, 실행 후 보고서의 경로가 더 이상 존재하지 않을 수 있습니다.

유형이 지정된 입력, 출력, 연결된 데이터 흐름은 [시나리오 템플릿](https://github.com/0xv1n/macnoise/blob/main/docs/templates/scenario.yaml)에서 시작하세요.

## 버전 1 호환성

버전 1.0은 지원되는 CLI 명령과 플래그, 모듈 이름과 계약, 시나리오 스키마 1, 텔레메트리 스키마 2.0, 시나리오 보고서 스키마 1.0을 정의합니다. 이러한 인터페이스에 대한 향후 호환되지 않는 변경에는 새로운 메이저 릴리스가 필요합니다.

## 기여

프리미티브, 시나리오, 핵심 변경 경로는 [CONTRIBUTING.md](https://github.com/0xv1n/macnoise/blob/main/CONTRIBUTING.md)를 참조하세요.

릴리스는 [release-please](https://github.com/googleapis/release-please)를 사용합니다. 변경 사항을 변경 로그에 설명하려면 `feat: add net_tls module` 또는 `fix: correct beacon jitter`와 같은 [Conventional Commit](https://www.conventionalcommits.org/) PR 제목을 사용하세요.

### AI 코드 정책

AI 지원 기여를 환영합니다. 사람의 검토 역량은 제한적이므로 각 PR은 특정 수정 또는 텔레메트리 모듈에 집중하도록 유지하세요. 광범위한 변경은 종료될 수 있습니다.
도구 다운로드

인기

모두 보기 →

커뮤니티에서 가장 많이 사용되는 도구를 찾아보세요.

  • 1

    OsintHunter

    letox4/osinthunter

    🎯 궁극의 OSINT 툴킷: 조사 그래프, 신뢰도 점수 산정, 별칭 패밀리, 지도, 타임라인 및 보고서. 49개 모듈, 400개 이상 사이트, API 키 불필요.

    916
  • 2

    ghostlock-app

    yukonga/ghostlock-app

    # GhostLock 원탭 실행 앱 (CVE-2026-43499)

    707
  • 3

    looking-glass

    anonghosty/looking-glass

    Shadowserver 보고서를 MongoDB로 수집하고 이를 대화형 지도, 분석, 발견 사항, 권고 및 경영진 대시보드로 재생하는 CSIRT 플랫폼입니다.

    430
  • 4

    jumpserver

    jumpserver/jumpserver

    JumpServer는 오픈소스 권한 접근 관리(PAM) 플랫폼으로, DevOps 및 IT 팀이 웹 브라우저를 통해 SSH, RDP, Kubernetes, 데이터베이스 및 RemoteApp 엔드포인트에 주문형 보안 액세스를 제공합니다.

    402
  • 5

    SafeLine

    chaitin/safeline

    악성 HTTP 트래픽을 필터링하고 SQL 인젝션, XSS, 봇 공격을 차단하며, 속도 제한 및 동적 HTML/JS 암호화를 제공하는 자체 호스팅 WAF 및 리버스 프록시입니다.

    349
  • 6

    ARTEX

    baarai/artex

    LLM 멀티 에이전트 자율 침투 테스트 플랫폼으로, 플래너/워커 에이전트, 자산 및 탐색 그래프, MITM 트래픽 기록, 취약점 재테스트 기능을 제공합니다.

    341

모든 도구 탐색

도구 컬렉션을 둘러보세요

모든 도구 보기 →