---

## 사용 사례

### 침투 테스트
- 내부 평가 중에 발견된 자격 증명을 여러 서비스에서 검증
- 데이터베이스 및 파일 공유 서비스 전반의 비밀번호 재사용 패턴 테스트
- 새로 배포된 인프라에서 기본 자격 증명 식별

### 레드 팀 운영
- 비밀번호 덤프 또는 피싱 캠페인 이후 빠른 자격 증명 검증
- 네트워크 서비스 전반의 측면 이동 기회 테스트
- 이질적인 환경에서 손상된 자격 증명 검증

### 개인 키 스프레이

손상된 시스템에서 개인 키를 찾았나요? 네트워크 전체에 스프레이하여 다른 곳에서도 액세스 권한을 부여하는지 확인하세요:```bash
# Discover SSH services and spray a found private key
naabu -host 10.0.0.0/24 -p 22 -silent | \
  nerva --json | \
  brutus creds -u root,admin,ubuntu,deploy -k /path/to/found_key --json

### 보안 검증
- 새로 배포된 서비스에 기본 자격 증명 테스트
- 플랫폼 간 비밀번호 정책 적용 검증
- 컴플라이언스 및 보안 평가를 위한 감사 추적 생성

---

## 설치

### 사전 빌드된 바이너리 (권장)

[GitHub Releases](https://github.com/praetorian-inc/brutus/releases)에서 다운로드:```bash
# Linux (amd64)
curl -L https://github.com/praetorian-inc/brutus/releases/latest/download/brutus-linux-amd64.tar.gz | tar xz
sudo mv brutus /usr/local/bin/

# macOS (Apple Silicon)
curl -L https://github.com/praetorian-inc/brutus/releases/latest/download/brutus-darwin-arm64.tar.gz | tar xz
sudo mv brutus /usr/local/bin/

# macOS (Intel)
curl -L https://github.com/praetorian-inc/brutus/releases/latest/download/brutus-darwin-amd64.tar.gz | tar xz
sudo mv brutus /usr/local/bin/

### Go 설치```bash
go install github.com/praetorian-inc/brutus/cmd/brutus@latest

각 서브명령어에는 검색을 위한 별칭이 있습니다:

| 서브명령어 | 별칭 |
|------------|---------|
| `creds` | `services`, `defaults`, `credentials` |
| `web` | `http`, `panels` |
| `snmp` | `community` |
| `badkeys` | `keys`, `ssh-keys`, `badkey` |
| `logon` | `stickykeys`, `sticky-keys`, `utilman`, `sethc`, `winlogon`, `accessibility` |
| `enum` | *(없음)* |```bash
# Test SSH credentials
brutus creds --target 192.168.1.100:22 --protocol ssh -u root -p toor

# Test HTTP web panel with AI credential detection
brutus web --target 192.168.1.1:80 --experimental-ai

# Test HTTP web panel with manual credentials
brutus web --target 192.168.1.1:80 -c "admin:admin,root:toor"

# Test SNMP community strings
brutus snmp --target 192.168.1.1:161 --mode aggressive

# Detect Windows logon-screen backdoors
brutus logon --target 10.0.0.50:3389

# Pipeline mode: creds skips HTTP/SNMP, web skips non-HTTP, snmp skips non-SNMP
naabu -host 10.0.0.0/24 -silent | nerva --json | brutus creds -P passwords.txt
naabu -host 10.0.0.0/24 -p 80,443,8080 -silent | nerva --json | brutus web --experimental-ai
naabu -host 10.0.0.0/24 -p 161 -silent | nerva --json | brutus snmp --mode aggressive

### 출력 예시```
$ brutus creds --target 192.168.1.100:22 --protocol ssh -u root,admin -p toor,password,admin
[+] VALID: ssh root:toor @ 192.168.1.100:22 (1.23s)

파이프라인 통합을 위한 JSON 출력 (성공한 자격 증명만 출력):```
$ brutus creds --target 192.168.1.100:22 --protocol ssh -u root -p toor --json
{"protocol":"ssh","target":"192.168.1.100:22","username":"root","password":"toor","duration":"1.234567ms","banner":"SSH-2.0-OpenSSH_8.9p1"}

#### 시나리오 2: 대상 도메인에서의 버그 바운티 리콘```bash
# Full pipeline against a single target
naabu -host target.example.com -top-ports 1000 -silent | \
  nerva --json | \
  brutus creds

# Or scan a list of subdomains
cat subdomains.txt | naabu -silent | nerva --json | brutus creds

#### 시나리오 4: 인프라 전반 SSH 키 테스트```bash
# Test embedded bad keys (Vagrant, F5 BIG-IP, ExaGrid, etc.) across a range
naabu -host 10.0.0.0/8 -p 22 -rate 1000 -silent | \
  nerva --json | \
  brutus badkeys --json -o ssh-key-findings.json

# Find systems using compromised SSH keys (key field is true)
cat ssh-key-findings.json | jq 'select(.key == true)'

### Scan Tool Import (Nmap & Masscan)

Brutus는 **nmap** 및 **masscan** 스캔 출력 파일에서 직접 대상을 가져올 수 있어 형식 변환이나 중간 도구가 필요하지 않습니다.

#### Nmap XML Import (`--nmap-file`)

nmap의 XML 출력(`-oX`)에서 대상을 가져옵니다. Nmap은 서비스 핑거프린팅을 제공하므로 Brutus는 자동으로 감지된 서비스를 올바른 프로토콜에 매핑합니다:```bash
# Run an nmap service scan
nmap -sV -oX scan.xml 10.0.0.0/24 -p 22,3306,5432,6379,445,3389

# Feed nmap results directly to Brutus
brutus creds --nmap-file scan.xml -P passwords.txt

# Test web services from nmap scan
brutus web --nmap-file scan.xml -c "admin:admin,root:password"

# Test SNMP from nmap scan
brutus snmp --nmap-file scan.xml --mode aggressive

# JSON output for scripting
brutus creds --nmap-file scan.xml --json -o results.json

#### 다른 워크플로우와 결합

`--nmap-file` 및 `--masscan-file` 플래그는 모든 하위 명령어와 함께 작동하며, `--target`, `--targets-file` 및 stdin과 상호 배타적입니다:```bash
# Scan for RDP backdoors from nmap results
brutus logon --nmap-file scan.xml

# Test SSH bad keys from nmap results
brutus badkeys --nmap-file scan.xml

# Override protocol for all masscan targets
brutus creds --masscan-file scan.json --protocol redis -p "redis,password"

**Nerva URI** (기본 Nerva 출력, `--json` 옵션 불필요):```bash
# Nerva outputs URI-scheme lines by default
$ echo "github.com:22" | nerva
ssh://github.com:22 (20.205.243.166)

# Pipe directly to Brutus — protocol is extracted from the URI scheme
echo "10.0.0.1:22" | nerva | brutus creds
echo "10.0.0.0/24:3306" | naabu -silent | nerva | brutus creds

Brutus는 자동으로:
- JSON, URI 스킴 및 bare 대상 형식을 파싱합니다
- 서비스를 프로토콜에 매핑합니다
- 적절한 기본 자격 증명을 테스트합니다
- 일치하는 JSON 형식으로 결과를 출력합니다

### 파이프라인 출력 형식

Brutus는 성공한 자격 증명만 JSONL 형식(각 줄에 하나의 JSON 객체)으로 출력합니다:```bash
# Brutus JSON output (with --json flag) - only successful authentications
{"protocol":"ssh","target":"192.168.1.100:22","username":"root","password":"toor","duration":"1.234567ms","banner":"SSH-2.0-OpenSSH_8.9p1"}
{"protocol":"mysql","target":"192.168.1.101:3306","username":"root","password":"","duration":"890.123µs"}
{"protocol":"ssh","target":"192.168.1.103:22","username":"vagrant","key":true,"duration":"2.345678ms","banner":"SSH-2.0-OpenSSH_9.6"}

### 내장 키 모음

| 제품 | CVE | 기본 사용자 | 설명 |
|---------|-----|--------------|-------------|
| Vagrant | - | vagrant, root | HashiCorp Vagrant의 안전하지 않은 키 |
| F5 BIG-IP | CVE-2012-1493 | root | 고정 SSH 호스트 키 |
| ExaGrid | CVE-2016-1561 | root | 백업 어플라이언스 백도어 |
| Monroe DASDEC | CVE-2013-0137 | root | 비상 경보 시스템 |
| Barracuda | CVE-2014-8428 | cluster | 로드 밸런서 VM |
| Ceragon FibeAir | CVE-2015-0936 | mateidu | 무선 백홀 |
| Array Networks | - | sync | vAPV/vxAG 어플라이언스 |
| Quantum DXi | - | root | 중복 제거 어플라이언스 |
| Loadbalancer.org | - | root | 엔터프라이즈 로드 밸런서 |

---

## 공격성 모드

전역 `--mode` 플래그(`-m`)는 모든 서브커맨드의 공격성을 제어합니다. 이는 적용 범위와 안전성 간의 균형을 맞추는 성능 튜닝 사전 설정을 설정합니다.

| 모드 | 스레드 | 타임아웃 | 속도 제한 | 지터 | 재시도 | 사용 사례 |
|------|---------|---------|------------|--------|---------|----------|
| `cautious` | 5 | 15s | 2 req/s | 500ms | 1 | 프로덕션 환경, 잠금 방지 |
| `default` | 10 | 10s | Unlimited | None | 2 | 표준 테스트 |
| `aggressive` | 20 | 10s | Unlimited | None | 3 | 랩/CTF 환경, 최대 적용 범위 |

모드 사전 설정이 먼저 적용된 후, 명시적인 CLI 플래그가 이를 재정의합니다.```bash
# Safe mode for production Active Directory (low concurrency, rate-limited)
brutus creds --target dc.corp.local:445 --protocol smb -m cautious -U users.txt -P passwords.txt

# Maximum coverage for a CTF
brutus creds --target 10.10.10.100:22 --protocol ssh -m aggressive -U users.txt -P rockyou.txt

# Cautious mode but override threads
brutus creds --target 192.168.1.100:22 --protocol ssh -m cautious --threads 20

Supported schemes:
- `socks5://` — 표준 SOCKS5 프록시 (클라이언트 측 DNS 확인)
- `socks5h://` — 원격 DNS 확인을 사용하는 SOCKS5 (내부 호스트네임을 대상으로 할 때 유용)

---

## SNMP 커뮤니티 문자열 테스트

`snmp` 하위 명령어는 글로벌 `--mode` 플래그로 제어되는 계층화된 단어 목록을 사용한 전용 SNMP v1/v2c 커뮤니티 문자열 테스트를 제공합니다:

| 모드 | 문자열 수 | 범위 |
|------|---------|----------|
| `cautious` | ~25 | 일반적인 문자열 (public, private, community 등) |
| `default` | ~25 | cautious와 동일 |
| `aggressive` | 200+ | 포괄적 (벤더별, SCADA, IP 카메라, 스토리지 등) |```bash
# Test with default community strings (~25)
brutus snmp --target 192.168.1.1:161

# Aggressive mode for comprehensive testing (200+)
brutus snmp --target 10.0.0.1:161 --mode aggressive

# Custom community strings
brutus snmp --target 192.168.1.1:161 -c "mycommunity,secretstring"

# Custom community string file
brutus snmp --target 192.168.1.1:161 -C community-strings.txt

# Pipeline mode
naabu -host 10.0.0.0/24 -p 161 -silent | nerva --json | brutus snmp --mode aggressive

번역할 Markdown 콘텐츠를 제공해 주세요.```go
package main

import (
    "fmt"
    "time"

    "github.com/praetorian-inc/brutus/pkg/brutus"
    _ "github.com/praetorian-inc/brutus/pkg/builtins" // registers all protocols and analyzers
)

func main() {
    config := &brutus.Config{
        Target:        "192.168.1.100:22",
        Protocol:      "ssh",
        Usernames:     []string{"root", "admin"},
        Passwords:     []string{"password", "admin", "toor"},
        Timeout:       5 * time.Second,
        Threads:       10,
    }

    results, err := brutus.Brute(config)
    if err != nil {
        panic(err)
    }

    for _, r := range results {
        if r.Success {
            fmt.Printf("[+] Valid: %s:%s\n", r.Username, r.Password)
        }
    }
}

**작동 방식:**

1. **탐지** — Brutus가 HTTP 대상에 접속하여 인증 유형(기본 인증 vs 폼 기반)을 탐지합니다.
2. **장치 식별** — Claude Vision이 스크린샷을 분석하여 장치/애플리케이션을 식별합니다.
3. **자격 증명 제안** — Claude가 훈련 데이터에서 기본 자격 증명을 제안합니다.
4. **선택적 웹 검색** — Perplexity(설정된 경우)가 온라인에서 추가 자격 증명을 검색합니다.
5. **테스트** — 발견된 자격 증명을 대상에 대해 테스트합니다.

**HTTP 기본 인증 대상의 경우:**
- `/`를 탐색하여 HTTP 헤더를 캡처합니다.
- Server 헤더, WWW-Authenticate 영역 등에서 장치를 식별합니다.
- Claude가 예상되는 기본 자격 증명을 제안합니다.
- 자격 증명 쌍을 자동으로 테스트합니다.

**HTTP 폼 기반 인증 대상의 경우:**
- 헤드리스 Chrome을 사용하여 페이지를 렌더링하고 스크린샷을 캡처합니다.
- Claude Vision이 로그인 폼, 장치 유형을 식별하고 자격 증명을 제안합니다.
- Perplexity(선택 사항)가 추가 기본 자격 증명을 검색합니다.
- 브라우저 자동화가 폼을 작성하고 제출합니다.

**요구 사항:**
- `ANTHROPIC_API_KEY` — Claude Vision(장치 식별 + 자격 증명 제안)에 **필수**
- `PERPLEXITY_API_KEY` — 추가 웹 검색 연구에 *선택 사항*
- Chrome/Chromium 설치(폼 기반 인증 전용)

**Non-HTTP 프로토콜(SSH, MySQL 등)은 `--experimental-ai`의 영향을 받지 않습니다** — 표준 자격 증명 테스트를 계속 사용합니다.

---

## RDP: 고정 키 백도어 탐지 및 익스플로잇

Brutus는 RDP 대상에 대한 **고정 키 백도어**(MITRE ATT&CK [T1546.008](https://attack.mitre.org/techniques/T1546.008/))의 자동 탐지를 포함합니다. 이 사전 인증 검사는 비-NLA RDP 대상에서 실행됩니다 — 자격 증명이 필요하지 않습니다.

**작동 방식:**

1. RDP 대상에 연결하고 비-NLA 세션을 협상합니다.
2. 기준선으로 로그인 화면 비트맵을 캡처합니다.
3. Shift 키를 5회 전송합니다(고정 키 트리거).
4. 응답 비트맵을 캡처합니다.
5. 휴리스틱 분석이 터미널 창(cmd.exe, PowerShell 등)이 나타났는지 감지합니다.
6. 선택적으로 Claude Vision API를 통해 확인합니다(`ANTHROPIC_API_KEY`가 설정된 경우).```bash
# Detection only — no brute force
brutus logon --target 10.0.0.50:3389

# Detection + Vision API confirmation
brutus logon --target 10.0.0.50:3389 --experimental-ai

**탐지 출력:**```
[CRITICAL] Sticky keys backdoor CONFIRMED (confidence: 85%)
sethc.exe has been replaced with cmd.exe or similar.
SYSTEM-level unauthenticated access available via 5x Shift.

이렇게 하면 연결하고, 백도어를 트리거하고, 명령어를 입력하고, Enter를 누르고, 출력을 기다린 후 결과의 PNG 스크린샷을 저장합니다.

### Interactive Web Terminal (`--web`)

브라우저 기반 RDP 뷰어를 실행하여 백도어 명령 프롬프트와 실시간으로 상호작용하세요:```bash
# Start interactive web terminal
brutus logon --target 10.0.0.50:3389 --web

**기술적 구현:** RDP 프로토콜 지원은 [IronRDP](https://github.com/Devolutions/IronRDP) (Rust)를 WebAssembly로 컴파일하고 [wazero](https://github.com/tetratelabs/wazero)를 통해 실행하며, Brutus의 제로-CGO, 단일 바이너리 설계를 유지합니다.

---

## 계정 열거

`enum` 하위 명령은 조직에 대해 어떤 계정 존재 여부 오라클이 작동하는지 (그리고 그에 대해 이메일을 열거) 또는 Active Directory 사용자를 열거하며, 모두 비밀번호를 보내지 않습니다.

### 계정 존재 여부 오라클 열거

인증되지 않은 계정 존재 여부 오라클(microsoft365, google, github, 그리고 Microsoft Teams 오라클)이 조직에 대해 어떤 것들이 작동하는지 식별하고, 알려진 유효 사용자에 대해 검증한 후, 작동하는 오라클들에 대해 후보 이메일을 열거합니다. DNS TXT 정찰은 후보 오라클을 표면화하며, `--known-valid`에 대한 검증이 핵심입니다. `--known-valid`는 필수이며, 열거는 이를 확인하는 오라클에 대해서만 실행됩니다:```bash
# Discover candidate oracles via DNS and report which ones work
brutus enum active oracles --domain example.com --known-valid [email protected]

# Enumerate specific emails against the working oracles
brutus enum active oracles --domain example.com -e [email protected],[email protected] --known-valid [email protected]

# Enumerate emails from file
brutus enum active oracles --domain example.com -E emails.txt --known-valid [email protected]

# Generate emails from embedded name lists and enumerate against working oracles
brutus enum active oracles --domain example.com --generate --format flast --known-valid [email protected]

# Discover working oracles with a known-valid email before large-scale enumeration
brutus enum active oracles discover --domain example.com --known-valid [email protected]

### 이메일/사용자 이름 생성

내장된 이름/성 워드리스트로부터 이메일 주소나 사용자 이름을 생성합니다:```bash
# Generate emails: [email protected]
brutus enum generate --domain example.com --format flast

# Generate usernames only (no domain): jsmith
brutus enum generate --format flast

# Available formats: first.last, flast, firstl, f.last, lastf, last.first, lastfirst, first
brutus enum generate --domain example.com --format first.last

### Microsoft Teams / Entra ID 인증

[디바이스 코드 흐름](https://learn.microsoft.com/en-us/entra/identity-platform/v2-oauth2-device-code)(RFC 8628)을 사용하여 Microsoft Entra ID(Azure AD)로부터 OAuth2 액세스 토큰, 리프레시 토큰, ID 토큰을 획득합니다. 획득된 토큰은 Microsoft Graph API 호출, Teams 열거 및 [ROADtools](https://github.com/dirkjanm/ROADtools)와 같은 도구나 사용자 지정 Graph 쿼리를 통한 감사에 사용할 수 있습니다.```bash
# Authenticate against the common endpoint (any Microsoft tenant)
brutus enum active teams auth

# Authenticate against a specific tenant by domain or GUID
brutus enum active teams auth --tenant contoso.com
brutus enum active teams auth --tenant 00000000-0000-0000-0000-000000000000

# Request a different resource scope (space-separated). The default targets the
# Skype/Teams resource (api.spaces.skype.com); the Teams client is NOT
# authorized for Microsoft Graph (Graph yields AADSTS65002).
brutus enum active teams auth --scope "offline_access https://api.spaces.skype.com/.default"

# Use a custom app registration (your own Azure app client ID)
brutus enum active teams auth --client-id 00000000-0000-0000-0000-000000000000

# Capture the full token set as JSONL for piping to other tools
brutus enum active teams auth -o tokens.jsonl
brutus enum active teams auth --json

#### Teams 사용자 열거

인증 후, 이메일 주소로 기업 Teams 사용자를 열거합니다. 각 결과는 `exists`, blocked (테넌트가 외부 검색을 금지하지만 사용자가 존재할 수 있음), `not found`, 또는 `unknown` (인증/전송 실패)입니다. 개인/라이브 계정은 지원되지 않습니다 — 기업 테넌트만 가능합니다.```bash
# Device-code auth inline, then enumerate a couple of emails
brutus enum active teams users -e [email protected],[email protected]

# Generate candidate emails for a domain and enumerate the most-likely 5000
# (presence and out-of-office are gathered by default; use --no-presence to skip)
brutus enum active teams users --domain target.com --format first.last --limit 5000

# Enumerate emails from a file
brutus enum active teams users -E emails.txt

# Reuse a token captured earlier and route through a SOCKS5 proxy
brutus enum active teams auth -o token.jsonl
brutus enum active teams users -E emails.txt --token-file token.jsonl --proxy socks5://127.0.0.1:1080

# Provide an access token directly
brutus enum active teams users -e [email protected] --access-token "$TOKEN"

`--domain`는 `enum generate`와 동일한 빈도 순위 기반 이름/성 생성기를 재사용합니다. `--format`은 사용자 이름 레이아웃을 선택하고, `--limit`은 생성되는 첫 N개(가장 가능성 높은) 후보로 제한합니다. `--domain`은 `-e`/`-E`와 함께 사용할 수 있습니다.

---

## 알려진 제한 사항

### 고정 키 휴리스틱 탐지

- **교차된 거짓 음성:** 휴리스틱 전용 탐지(`--experimental-ai` 없는 `brutus logon`)는 동일한 대상에 대해 반복 스캔할 때 거짓 음성을 생성할 수 있습니다. 성공적인 탐지 후에는 서버에 cmd.exe 창이 열려 있습니다. 이후 연결은 기준 프레임에 이미 cmd.exe가 존재하므로, 5회 Shift 키 전송이 새 창을 생성하지 않아 픽셀 차이가 최소화되어 "클린" 판정이 나옵니다. 이는 `--experimental-ai` 모드에는 영향을 주지 않습니다. 해당 모드는 응답 프레임 자체에 대해 Vision API 분석(기준-응답 차이 아님)을 사용하며, 이전 상태와 관계없이 터미널 창을 안정적으로 식별합니다.
- **해결 방법:** 반복 스캔에서 일관된 탐지를 위해 `ANTHROPIC_API_KEY`를 설정한 상태로 `--experimental-ai`를 사용하거나, RDP 세션이 리셋되도록 스캔 사이에 쿨다운을 두십시오.

### 브라우저 플러그인

- 로컬에 Chrome/Chromium이 설치되어 있어야 함
- 헤드리스 모드는 일부 시스템에서 작동하지 않을 수 있음
- 일부 JavaScript가 많은 로그인 페이지는 추가 대기 시간이 필요할 수 있음