KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#dsh #dsh-plugin #typescript #developer-tools #claude-code #ai-agent #codex #deepseek-harness #ai-agents #cli #react #mcp

shannon

★ 46,865 Open GitHub ↗

Shannon은 웹 애플리케이션 및 API를 위한 AI 모의 해커(pentester)입니다. 소스 코드를 분석하고, 공격 벡터를 식별하며, 취약점이 운영 환경에 도달하기 전에 실제 익스플로잇을 실행하여 이를 증명합니다.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

> [!NOTE]
> \*\*[Shannon 2.0가 공식 출시되었습니다](https://github.com/KeygraphHQ/shannon/discussions/405)\*\*

![Shannon - AI Pentester by Keygraph](./assets/github-banner.png)
# Shannon - AI Pentester by Keygraph
[![KeygraphHQ%2Fshannon | Trendshift](https://trendshift.io/api/badge/repositories/15604)](https://trendshift.io/repositories/15604)
Shannon은 웹 애플리케이션 및 API를 위한 자율형 AI 모의 해킹(pentester) 도구입니다.   
소스 코드를 분석하고, 공격 경유지를 식별하며, 취약점이 프로덕션 환경에 도달하기 전에 실제 익스플로잇을 실행하여 이를 증명합니다.
\*\*이 저장소는 Shannon Open Source로, 명령줄에서 로컬로 실행되는 전체 에이전트입니다.\*\*
---
[![Join Discord](./assets/discord.png)](https://discord.gg/9ZqQPuhJB7)
[![Visit Keygraph.io](./assets/Keygraph_Button.png)](https://keygraph.io/)
---

> [!TIP]
> \*\*AI 에이전트 및 LLM:\*\* 이 저장소에 대한 간결한 맵을 보려면 [llms.txt](llms.txt)로 시작하거나, README와 문서를 하나의 파일로 결합한 [llms-full.txt](llms-full.txt)를 사용하세요.
## 목차
- [Shannon이란 무엇인가요?](#what-is-shannon)
- [동작 중인 Shannon](#shannon-in-action)
- [빠른 시작](#quick-start)
- [주요 기능](#key-capabilities)
- [에디션](#editions)
- [아키텍처](#architecture)
- [문서](#documentation)
- [안전성, 범위 및 제한 사항](#safety-scope-and-limitations)
- [라이선스](#license)
- [Keygraph 소개](#about-keygraph)
- [커뮤니티 및 지원](#community-and-support)
## Shannon이란 무엇인가요?
Shannon은 [Keygraph](https://keygraph.io)에서 개발한 자율형 AI 모의 해킹 도구입니다. 소스 코드 분석과 라이브 익스플로잇을 결합하여 웹 애플리케이션과 그 하위 API에 대한 보안 테스트를 수행합니다.
Shannon은 웹 애플리케이션의 소스 코드를 분석하여 잠재적인 공격 벡터를 식별한 다음, 브라우저 자동화 및 명령줄 도구를 사용하여 실행 중인 애플리케이션과 그 API를 대상으로 실제 익스플로잇을 실행합니다. 최종 보고서에는 작동하는 개념 증명(proof-of-concept)이 있는 취약점만 포함됩니다.
Shannon은 에이전트입니다. 이 저장소는 사용자가 직접 실행하는 독립형 모의 해킹 도구인 Shannon Open Source입니다. 동일한 Shannon이 Keygraph의 상용 모의 해킹 제품인 [Keygraph 플랫폼](https://keygraph.io)을 구동하기도 합니다. 두 제품의 비교는 [에디션](#editions)을 참조하세요.
### Shannon이 존재하는 이유
Claude Code 및 Cursor 같은 도구 덕분에 팀은 코드를 끊임없이 배포합니다. 하지만 모의 해킹은 어떻게 이루어지나요? 일년에 단 한 번 일어납니다. 이는 엄청난 보안 공백을 만듭니다. 나머지 364일 동안, 여러분은 자신도 모르게 취약점을 프로덕션에 배포하고 있을 수 있습니다.
Shannon은 모든 빌드나 릴리스에 대해 실행할 수 있는 온디맨드 자동화 모의 해킹을 제공함으로써 그 공백을 메워줍니다.
## 동작 중인 Shannon

![자율 모의 해킹을 수행하는 Shannon](assets/shannon-action.gif)

Shannon Open Source가 생성한, 의도적으로 취약하게 만든 애플리케이션의 샘플 모의 해킹 보고서:
| 대상 | 요약 | 보고서 |
| --- | --- | --- |
| OWASP Juice Shop | 인증 우회, SQL 인젝션, IDOR, SSRF를 포함한 20개 이상의 취약점. | [보고서 보기](sample-reports/shannon-report-juice-shop.md) |
| c{api}tal API | 커맨드 인젝션, 인증 우회, 대량 할당(mass assignment)을 포함한 약 15개의 치명적 및 고위험 API 발견 사항. | [보고서 보기](sample-reports/shannon-report-capital-api.md) |
| OWASP crAPI | JWT, 인젝션, SSRF, API 권한 부여 경로 전반에 걸친 15개 이상의 치명적 및 고위험 발견 사항. | [보고서 보기](sample-reports/shannon-report-crapi.md) |
## 빠른 시작
### 사전 요구 사항
- \*\*Docker\*\*: 워커 컨테이너를 위해 필요합니다.
- \*\*Node.js 18+\*\*: 권장되는 `npx` 워크플로우를 위해 필요합니다.
- \*\*AI 공급자 자격 증명\*\*: Anthropic, OpenAI, xAI, AWS Bedrock 또는 [기타 공급자](docs/ai-providers.md#any-other-provider). Claude 모델을 권장합니다. 공급자별 권장 모델 ID, 게이트웨이 및 커스텀 베이스 URL은 [AI 공급자](docs/ai-providers.md#suggested-models)를 참조하세요.
- \*\*공급자에게 승인받은 사이버 보호 조치\*\*: Anthropic과 OpenAI는 사이버 보안 워크로드에 실시간 보호 조치를 적용하므로 스캔 도중에 중단될 수 있습니다. 첫 실행 전에 적법한 보안 테스터를 위한 지침을 완료하세요 - [AI 공급자](docs/ai-providers.md#cyber-safeguards-do-this-before-your-first-scan) 참조.
### Shannon 실행
> [!WARNING]
> Shannon은 적극적으로 익스플로잇을 실행합니다. 소유하고 있거나 테스트에 대한 명시적인 서면 허가를 받은 애플리케이션 및 환경을 상대로만 실행하세요. 프로덕션 시스템을 상대로 Shannon을 실행하지 마세요.
```bash
# 대화형 마법사로 자격 증명을 구성합니다.
npx @keygraph/shannon setup
# 소스 공개(source-available) 타겟을 대상으로 모의 해킹을 실행합니다.
npx @keygraph/shannon start -u https://your-app.com -r /path/to/your-repo
```
Shannon은 Docker Hub에서 워커 이미지를 가져오고, 필요한 로컬 인프라를 시작하며, 임시 워커 컨테이너 내부에 타겟 저장소를 읽기 전용으로 마운트하고, 결과를 로컬 워크스페이스에 기록합니다.
소스 빌드, 인증된 스캔, 공급자별 설정 및 플랫폼 참고 사항은 [문서](#documentation)를 참조하세요.
> [!TIP]
> \*\*API 크레딧 대신 Claude Code 구독으로 실행하고 싶으신가요?\*\* [`shannon-v1`](https://github.com/KeygraphHQ/shannon/tree/shannon-v1) 브랜치는 Claude Agent SDK 기반으로 빌드된 마지막 릴리스이므로 Claude Code OAuth 토큰을 허용합니다. `claude setup-token`으로 토큰을 생성한 다음, `npx @keygraph/shannon@1.9.0 setup`을 실행하고 \*\*OAuth Token\*\*을 선택하세요. 기존 구독 외에는 모의 해킹 비용이 전혀 발생하지 않습니다.
## 주요 기능
- \*\*익스플로잇 증명 보고서\*\*: Shannon은 추측성 경고 대신 재현 가능한 개념 증명 단계와 함께 검증된 발견 사항을 보고합니다.
- \*\*화이트박스 공격 계획\*\*: Shannon은 소스 코드 분석을 사용하여 동적 테스트를 안내하고 현실적인 공격 경로에 집중합니다.
- \*\*자율 실행\*\*: Shannon은 단일 명령으로 정찰, 취약점 분석, 익스플로잇, 보고서 생성을 시작합니다.
- \*\*인증된 테스트\*\*: 설정 파일을 통해 로그인 흐름, 테스트 자격 증명, TOTP, 이메일 기반 로그인 흐름, 집중 영역 및 교전 규칙을 설명할 수 있습니다.
- \*\*OWASP 중심 커버리지\*\*: Shannon은 익스플로잇 가능한 인젝션, XSS, SSRF, 인증 파괴(Broken Authentication), 권한 부여 파괴(Broken Authorization) 문제를 타겟으로 합니다.
- \*\*재개 가능한 워크스페이스\*\*: Shannon은 완료된 에이전트를 다시 실행하지 않고도 중단된 실행을 재개할 수 있습니다.
## 에디션
Shannon은 두 가지 방식으로 제공됩니다: 사용자가 직접 실행하는 모의 해킹 도구인 \*\*Shannon Open Source\*\*, 그리고 Shannon을 지속적으로 실행하고 주변의 전체 AppSec 라이프사이클을 마무리하는 상용 모의 해킹 제품인 \*\*Keygraph 플랫폼\*\*.
\*\*Shannon Open Source\*\*(이 저장소)는 독립형 모의 해킹 도구로, 사용자가 소유하거나 테스트 권한이 있는 웹 애플리케이션 및 API의 화이트박스, 익스플로잇 증명 테스트를 위한 CLI 에이전트입니다. 소스를 읽고, 공격을 계획하며, 실제 익스플로잇을 실행하고, 증명할 수 있는 것만 보고합니다. 온디맨드로 실행되며 해당 영역에서 완성도가 높습니다. 타겟을 지정하면 모의 해킹을 수행하고 보고합니다.
\*\*Keygraph 플랫폼\*\*은 Shannon으로 구동되는 엔터프라이즈급 지속적 모의 해킹 제품입니다. Keygraph 플랫폼에서는 Keygraph의 전체 코드 분석 스택이 제공하는 강화된 오케스트레이션 환경에서 향상된 빌드의 Shannon이 지속적으로 실행됩니다. 이 엔진을 중심으로 플랫폼은 분석부터 검증된 수정까지 전체 취약점 라이프사이클을 마무리합니다.
- \*\*분석 (Analyze)\*\*: 코드 속성 그래프(Code Property Graph) SAST, 도달 가능성이 있는 SCA, 시크릿, IaC 및 컨테이너 스캔. 그 자체로 최고 수준의 탐지 기능이자 Shannon의 공격을 날카롭게 다듬는 컨텍스트를 제공합니다.
- \*\*증명 (Prove)\*\*: 자율형 블랙박스 및 소스 인식 화이트박스 모의 해킹을 통해 후보 발견 사항을 추측성 알림이 아닌 검증되고 익스플로잇된 취약점으로 전환합니다.
- \*\*관리 (Manage)\*\*: 저장소당 취약점당 하나의 표준 레코드, 모든 소스에 걸쳐 중복 제거됨, 소유권, 상태, SLA 추적, 대시보드 및 양방향 Jira 동기화.
- \*\*수정 및 검증 (Remediate and verify)\*\*: 배송 전 수정된 코드에 대해 자동으로 작성 및 재테스트된 패치가 자동 적용되는 대신 기존 검토 워크플로우에 반영됩니다.
- \*\*배포 (Deploy)\*\*: 자체 호스팅(self-hosted) 및 에어갭(air-gapped) 환경, 엄격한 자체 키 가져오기(BYOK) 모델 액세스, 고객 제어 LLM 게이트웨이 패턴을 통해 소스, 결과 및 모델 트래픽이 경계 내에 유지됩니다.
Shannon은 Keygraph 플랫폼 중심에 있는 증명 엔진입니다. Shannon Open Source는 사용자가 직접 실행할 수 있도록 해당 엔진을 제공합니다. Keygraph 플랫폼은 지속적인 분석, 발견 사항 관리, 수정, 검증 및 엔터프라이즈 배포로 Shannon을 둘러싸고 있습니다.
| AppSec 라이프사이클 단계 | Shannon Open Source | Keygraph 플랫폼 |
| --- | --- | --- |
| 분석 | 공격 계획을 위한 소스의 기본 LLM 패스스루 | 실제 코드베이스 파싱, 코드 속성 그래프, SAST, 도달 가능성이 있는 SCA, 시크릿, IaC, 컨테이너 |
| 모의 해킹 및 증명 | 화이트박스 전용, 익스플로잇을 통한 증명 | 향상된 화이트박스, 블랙박스 및 그레이박스 모드, 지속적 실행 |
| 발견 사항 관리 | 로컬 Markdown 보고서 | 표준 발견 사항 시스템: 소스 간 중복 제거, 소유권, SLA, 대시보드, Jira 동기화 및 전문 모의 해킹 등급 PDF 보고서 |
| 수정 및 검증 | 보고서에서 수동으로 수정한 후 전체 스캔을 다시 실행하여 검증 | 자동화된 수정: 수정 사항이 포함된 PR을 열고, 전체 스캔을 다시 실행하지 않고 포인트 재테스트를 통해 검증 |
| 배포 및 운영 | 로컬 CLI 및 Docker 워커 | 자체 호스팅, 에어갭, BYOK, 지속적, 엔터프라이즈 통합 |
| 라이선스 및 지원 | AGPL-3.0, 커뮤니티 | 상용, 지원 제공 |
[Keygraph 웹사이트](https://keygraph.io)에서 자세히 알아보고, [Keygraph 플랫폼 기술 개요](docs/keygraph-platform.md)를 읽고, 무료 체험을 시작하거나 [데모](https://cal.com/team/keygraph/shannon-pro)를 예약하거나 [shannon@keygraph.io](mailto:shannon@keygraph.io)로 문의하세요.
## 아키텍처
Shannon은 소스 코드 분석과 라이브 익스플로잇을 결합한 멀티 에이전트 워크플로우를 사용합니다.
```text
┌──────────────────────┐
│ 사전 정찰 (Pre-Reconnaissance) │
│ (소스 코드 스캔) │
└──────────┬───────────┘
│
▼
┌──────────────────────┐
│ 정찰 (Reconnaissance) │
│ (공격 표면 매핑) │
└──────────┬───────────┘
│
▼
┌──────────┴───────────┐
│ │ │
▼ ▼ ▼
┌───────────┐ ┌───────────┐ ┌───────────┐
│ 취약점 │ │ 취약점 │ │ ... │
│(인젝션) │ │ (XSS) │ │ │
└─────┬─────┘ └─────┬─────┘ └─────┬─────┘
│ │ │
▼ ▼ ▼
┌───────────┐ ┌───────────┐ ┌───────────┐
│ 익스플로잇│ │ 익스플로잇│ │ ... │
│(인젝션) │ │ (XSS) │ │ │
└─────┬─────┘ └─────┬─────┘ └─────┬─────┘
│ │ │
└──────┬───────┴─────────────┘
│
▼
┌──────────────────────┐
│ 보고 (Reporting) │
└──────────────────────┘
```
상위 수준에서 보면:
- \*\*사전 정찰(Pre-reconnaissance)\*\*은 저장소에서 프레임워크, 진입점, 데이터 흐름, 예상되는 공격 표면을 식별합니다.
- \*\*정찰(Reconnaissance)\*\*은 라이브 애플리케이션을 탐색하고 런타임 동작을 코드 수준의 컨텍스트와 상관분석합니다.
- \*\*취약점 분석(Vulnerability analysis)\*\*은 인젝션, XSS, SSRF, 인증, 권한 부여를 위한 특화된 에이전트를 실행합니다.
- \*\*익스플로잇(Exploitation)\*\*은 실제 개념 증명 공격을 시도하고 증명할 수 없는 가설은 폐기합니다.
- \*\*보고(Reporting)\*\*는 검증된 발견 사항, 증거 및 수정 지침을 최종 Markdown 보고서로 컴파일합니다.
각 스캔은 격리된 워크스페이스와 호출별 오케스트레이션을 갖춘 임시 Docker 컨테이너에서 실행됩니다.
## 문서
운영 세부 정보는 다음 가이드를 참조하세요.
| 가이드 | 용도 |
| --- | --- |
| [소스 빌드 및 CLI 명령](docs/development.md) | 복제, 빌드, 일반 명령, 출력 경로 및 로컬 개발. |
| [설정](docs/configuration.md) | 인증된 테스트, 로그인 흐름, 교전 규칙 및 보고서 필터. |
| [AI 공급자](docs/ai-providers.md) | 모델 선택, 지원되는 공급자(Anthropic, OpenAI, xAI, AWS Bedrock 및 기타 Pi 지원 공급자) 및 커스텀 Gateway. |
| [플랫폼 및 네트워킹](docs/platforms.md) | Windows/WSL2, Linux, macOS, Docker 네트워킹, 로컬 앱 및 커스텀 호스트명. |
| [워크스페이스 및 재개](docs/workspaces.md) | 워크스페이스 이름 지정, 중단된 스캔 재개 및 워크스페이스 스토리지. |
| [안전성 및 제한 사항](docs/safety.md) | 승인된 사용 요구 사항, 비프로덕션 지침, 변경 효과(mutative effects), 비용 및 모델 주의사항. |
| [커버리지 및 로드맵](docs/coverage-roadmap.md) | 현재 취약점 커버리지 및 계획된 작업. |
| [Keygraph 플랫폼](docs/keygraph-platform.md) | 지속적인 에이전트 기반 모의 해킹 플랫폼: 코드 분석, 블랙박스 및 화이트박스 테스트, 발견 사항 관리, 수정, 검증 및 엔터프라이즈 배포. |
## 안전성, 범위 및 제한 사항
Shannon은 수동형 스캐너가 아닙니다. 익스플로잇 에이전트는 사용자를 생성하고, 양식을 제출하고, 애플리케이션 상태를 변경하고, 아웃바운드 요청을 트리거하는 등 타겟 시스템에 영향을 미칠 수 있습니다. 일회용 데이터가 있는 샌드박스, 스테이징 또는 로컬 개발 환경을 사용하세요.
사용자는 합법적이고 윤리적으로 Shannon을 사용할 책임이 있습니다. 소유하고 있지 않거나 테스트에 대한 명시적인 권한이 없는 시스템, 저장소 또는 애플리케이션을 상대로 Shannon을 지정하지 마세요.
중요한 제한 사항:
- Shannon Open Source는 인젝션, XSS, SSRF, 인증 파괴, 권한 부여 파괴와 같이 적극적으로 익스플로잇 가능한 문제에 중점을 둡니다. 취약한 종속성 및 안전하지 않은 설정을 포함한 광범위한 정적 분석 커버리지는 Keygraph 플랫폼을 통해 제공됩니다.
- 발견 사항은 여전히 인간의 검토가 필요합니다. LLM이 생성한 보고서에는 근거가 부족하거나 잘못된 세부 정보가 포함될 수 있습니다.
- Shannon은 공식적으로 Claude 모델을 지원합니다. 더 작거나 대체 또는 프록시된 비Claude 모델은 불완전하거나 불안정할 수 있습니다.
- 전체 실행에는 모델 가격 및 애플리케이션 복잡성에 따라 대략 1~1.5시간이 소요될 수 있으며 LLM API 비용이 발생할 수 있습니다.
- 신뢰할 수 없거나 적대적인 코드베이스를 스캔하지 마세요. 소스 코드를 읽는 AI 기반 도구는 프롬프트 인젝션에 노출될 수 있습니다.
새로운 환경에서 Shannon을 실행하기 전에 전체 [안전성 및 제한 사항](docs/safety.md) 가이드를 읽어보세요.
## 라이선스
Shannon Open Source는 [GNU Affero General Public License v3.0](LICENSE)에 따라 라이선스가 부여됩니다.
상용 및 엔터프라이즈 라이선스는 Keygraph 플랫폼을 포함하여 서로 다른 라이선스 조건, 상용 지원, 비공개 재배포, 관리형 서비스 사용 또는 광범위한 배포 옵션이 필요한 조직을 위해 제공됩니다.
상용 라이선스 문의는 [shannon@keygraph.io](mailto:shannon@keygraph.io)로 연락주세요.
## Keygraph 소개
\*\*Keygraph\*\*는 Shannon을 만든 회사입니다. 또한 전체 AppSec 라이프사이클을 마무리하고 모의 해킹 엔진으로서 향상된 빌드의 Shannon을 실행하는 상용 에이전트형 모의 해킹 제품인 \*\*Keygraph 플랫폼\*\*을 구축합니다.
## 커뮤니티 및 지원
버그, 배포 및 설정 질문에 대한 실무 지원을 위해 \*\*커뮤니티 오피스 아워(Community office hours)\*\*가 제공됩니다.
- 미국/유럽: 목요일 오전 10:00 PT
- 아시아: 목요일 오후 2:00 IST
- [슬롯 예약](https://cal.com/george-flores-keygraph/shannon-community-office-hours)
질문을 하고, 피드백을 공유하고, 다른 Shannon 사용자와 소통하려면 [Discord에 가입](https://discord.gg/cmctpMBXwE)하세요.
현재 Keygraph는 외부 코드 기여를 받고 있지 않습니다. 버그 신고 및 기능 요청에 대한 이슈는 환영합니다:
- [버그 신고](https://github.com/KeygraphHQ/shannon/issues)
- [기능 제안](https://github.com/KeygraphHQ/shannon/discussions)
소통 채널:
- [Keygraph 웹사이트](https://keygraph.io)
- [Twitter/X: @KeygraphHQ](https://twitter.com/KeygraphHQ)
- [LinkedIn: Keygraph](https://linkedin.com/company/keygraph)

**Built by [Keygraph](https://keygraph.io)**

shannon

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README