Shannon은 Docker Hub에서 워커 이미지를 가져오고, 필요한 로컬 인프라를 시작하며, 대상 리포지토리를 임시 워커 컨테이너 내부에 읽기 전용으로 마운트하고, 결과를 로컬 워크스페이스에 기록합니다.

소스 빌드, 인증된 스캔, 공급자별 설정 및 플랫폼 참고 사항은 [문서](#documentation)를 참조하세요.

> [!TIP]
> **API 크레딧 대신 구독을 선호하시나요?**
>
> - **OpenAI Codex:** 최신 버전의 Shannon은 ChatGPT Plus 및 Pro 구독을 지원합니다. 시작하려면 [OpenAI Codex 구독 설정 가이드](https://github.com/keygraphhq/shannon/blob/main/docs/ai-providers.md#openai-codex-chatgpt-pluspro-subscription)를 따르세요.
> - **xAI (Grok):** 최신 버전의 Shannon은 xAI 구독을 지원합니다. 시작하려면 [xAI 구독 설정 가이드](https://github.com/keygraphhq/shannon/blob/main/docs/ai-providers.md#xai-grok-subscription)를 따르세요.
> - **Claude Code:** 최신 버전의 Shannon은 Claude Code 구독을 지원하지 않습니다. Claude Agent SDK 기반의 최종 릴리스인 버전 `1.9.0`을 사용하려면 [Claude Code 구독 설정 가이드](https://github.com/keygraphhq/shannon/blob/main/docs/ai-providers.md#claude-code-subscription)를 따르세요.

## 주요 기능

- **실증 기반 보고서**: Shannon은 추측성 경고 대신 재현 가능한 개념 증명 단계와 함께 검증된 발견 사항을 보고합니다.
- **화이트박스 공격 계획**: Shannon은 소스 코드 분석을 사용하여 동적 테스트를 안내하고 현실적인 공격 경로에 집중합니다.
- **자율 실행**: Shannon은 단일 명령으로 정찰, 취약점 분석, 익스플로잇 및 보고서 생성을 시작합니다.
- **인증된 테스트**: 구성 파일은 로그인 흐름, 테스트 자격 증명, TOTP, 이메일 기반 로그인 흐름, 집중 영역 및 공격 규칙을 설명할 수 있습니다.
- **OWASP 중심 범위**: Shannon은 악용 가능한 Injection, XSS, SSRF, 취약한 인증(Broken Authentication) 및 취약한 권한 부여(Broken Authorization) 문제를 대상으로 합니다.
- **재개 가능한 워크스페이스**: Shannon은 완료된 에이전트를 다시 실행하지 않고 중단된 실행을 재개할 수 있습니다.
- **기계 판독 가능 출력**: Shannon은 발견 사항을 구조화된 JSON으로 출력하며, 기본적으로 익스플로잇 모드 스캔에서 SARIF 2.1.0으로도 출력합니다(`report.sarif: "false"`로 선택 해제). SARIF는 정적 분석 결과에 대한 OASIS 표준이므로 발견 사항은 이를 읽는 모든 코드 스캐닝 서비스, 취약점 관리 플랫폼, 보안 대시보드 또는 CI/CD 파이프라인으로 흘러갑니다.
- **자체 키 사용, 공급자 중립**: Shannon은 Anthropic, OpenAI, xAI, AWS Bedrock 및 Anthropic Messages API 또는 OpenAI Chat Completions 또는 Responses API를 지원하는 모든 엔드포인트에서 실행됩니다. 여기에는 Ollama, vLLM 또는 LM Studio를 통해 제공되는 자체 호스팅 모델과 OpenRouter 및 LiteLLM과 같은 게이트웨이가 포함됩니다. 자격 증명을 직접 제공하므로 소스 코드와 모델 트래픽은 인프라 내부에 유지됩니다. 로컬 및 자체 호스팅 모델은 기술적으로 지원되지만 권장되지는 않습니다. 프론티어 모델만큼 Shannon의 지침이나 도구 사용 제약을 안정적으로 따르지 않을 수 있으므로, 선택한 모델의 동작을 알고 있는 경우에만 해당 경로를 사용하세요.

## 에디션

Shannon은 두 가지 방식으로 제공됩니다: 직접 실행하는 펜테스터인 **Shannon Open Source**와 Shannon을 지속적으로 실행하고 그 주변의 전체 AppSec 수명 주기를 완결하는 상용 펜테스팅 제품인 **Keygraph 플랫폼**입니다.

**Shannon Open Source**(이 리포지토리)는 독립형 펜테스터입니다: 소유하거나 테스트 권한이 있는 웹 애플리케이션 및 API에 대한 화이트박스, 실증 기반 테스트를 위한 CLI 에이전트입니다. 소스를 읽고, 공격을 계획하고, 실제 익스플로잇을 실행하며, 증명할 수 있는 것만 보고합니다. 요청 시 실행되며 해당 영역에서 완전합니다. 대상을 지정하면 펜테스트를 수행하고 보고합니다.

**Keygraph 플랫폼**은 Shannon으로 구동되는 엔터프라이즈급 연속 펜테스팅 제품입니다. Keygraph 플랫폼에서 Shannon의 향상된 빌드는 Keygraph의 전체 코드 분석 스택에서 공급되는 강화된 오케스트레이션 환경에서 지속적으로 실행됩니다. 해당 엔진 주변에서 플랫폼은 분석부터 검증된 수정까지 전체 취약점 수명 주기를 완결합니다:

- **분석(Analyze)**: Code Property Graph SAST, 도달 가능성 기반 SCA, 시크릿, IaC 및 컨테이너 스캐닝. 그 자체로 일급 탐지 기능이며, Shannon의 공격을 날카롭게 만드는 컨텍스트입니다.
- **증명(Prove)**: 자율 블랙박스 및 소스 인지 화이트박스 펜테스트는 후보 발견 사항을 추측성 알림이 아닌 입증되고 악용된 취약점으로 전환합니다.
- **관리(Manage)**: 리포지토리별 취약점당 하나의 표준 레코드로, 모든 소스에서 중복 제거되며 소유권, 상태, SLA 추적, 대시보드 및 양방향 Jira 동기화가 포함됩니다.
- **수정 및 검증(Remediate and verify)**: 패치는 자동으로 작성되고 전달 전에 패치된 코드에 대해 재테스트되며, 자동 적용이 아닌 기존 검토 워크플로우에 통합됩니다.
- **배포(Deploy)**: 자체 호스팅 및 에어갭 환경, 엄격한 자체 키(BYOK) 모델 액세스, 고객 제어 LLM 게이트웨이 패턴을 통해 소스, 결과 및 모델 트래픽이 경계 내부에 유지됩니다.

Shannon은 Keygraph 플랫폼의 중심에 있는 증명 엔진입니다. Shannon Open Source는 직접 실행할 수 있는 해당 엔진을 제공합니다. Keygraph 플랫폼은 Shannon을 지속적인 분석, 발견 사항 관리, 수정, 검증 및 엔터프라이즈 배포로 둘러쌉니다.

| AppSec 수명 주기 단계 | Shannon Open Source | Keygraph 플랫폼 |
| --- | --- | --- |
| 분석 | 공격 계획을 위한 소스의 기본 LLM 패스스루 | 실제 코드베이스 파싱 및 Code Property Graph, SAST, 도달 가능성 기반 SCA, 시크릿, IaC 및 컨테이너 |
| 펜테스트 및 증명 | 화이트박스 전용, 실증 기반 | 향상된 화이트박스 및 블랙박스, 그레이박스 모드, 지속적 실행 |
| 발견 사항 관리 | 로컬 Markdown 보고서 | 표준 발견 사항 시스템: 소스 간 중복 제거, 소유권, SLA, 대시보드, Jira 동기화 및 전문 펜테스트급 PDF 보고서 |
| 수정 및 검증 | 보고서에서 수동으로 수정한 후 전체 스캔을 다시 실행하여 검증 | 자동 수정: 수정 사항이 포함된 PR을 열고 전체 스캔을 다시 실행하지 않고 포인트 재테스트로 검증 |
| 배포 및 운영 | 로컬 CLI 및 Docker 워커 | 자체 호스팅, 에어갭, BYOK, 지속적, 엔터프라이즈 통합 |
| 라이선스 및 지원 | AGPL-3.0, 커뮤니티 | 상용, 지원 |

[Keygraph 웹사이트](https://keygraph.io)에서 자세히 알아보고, [Keygraph 플랫폼 기술 개요](https://github.com/keygraphhq/shannon/blob/main/docs/keygraph-platform.md)를 읽고, 무료 평가판을 시작하거나 [데모](https://cal.com/team/keygraph/shannon-pro)를 예약하거나 [[email protected]](mailto:[email protected])로 문의하세요.

## 아키텍처

Shannon은 소스 코드 분석과 실시간 익스플로잇을 결합하는 멀티 에이전트 워크플로우를 사용합니다:```text
        ┌──────────────────────┐
        │   Pre-Reconnaissance │
        │   (source code scan) │
        └──────────┬───────────┘
                   │
                   ▼
        ┌──────────────────────┐
        │   Reconnaissance     │
        │  (attack surface     │
        │   mapping)           │
        └──────────┬───────────┘
                   │
                   ▼
        ┌──────────┴───────────┐
        │          │           │
        ▼          ▼           ▼
  ┌───────────┐ ┌───────────┐ ┌───────────┐
  │ Vuln      │ │ Vuln      │ │   ...     │
  │(Injection)│ │  (XSS)    │ │           │
  └─────┬─────┘ └─────┬─────┘ └─────┬─────┘
        │              │             │
        ▼              ▼             ▼
  ┌───────────┐ ┌───────────┐ ┌───────────┐
  │ Exploit   │ │ Exploit   │ │   ...     │
  │(Injection)│ │  (XSS)    │ │           │
  └─────┬─────┘ └─────┬─────┘ └─────┬─────┘
        │              │             │
        └──────┬───────┴─────────────┘
               │
               ▼
        ┌──────────────────────┐
        │      Reporting       │
        └──────────────────────┘