┌─────────────┐     ┌──────────────┐     ┌───────────┐
│  React SPA  │────▶│  FastAPI      │────▶│  MongoDB  │
│  (Vite)     │ WS  │  Backend     │     │           │
└─────────────┘     └──────┬───────┘     └───────────┘
                           │
              ┌────────────┼────────────┐
              ▼            ▼            ▼
        ┌──────────┐ ┌──────────┐ ┌──────────┐
        │  Shodan  │ │  Nuclei  │ │  Redis   │
        │  API     │ │  Scanner │ │  Streams │
        └──────────┘ └──────────┘ └──────────┘

# 클론
git clone [email protected]:BishopFox/aimap.git
cd aimap

# 설정
cp .env.example .env
# .env 편집 — 최소한 SHODAN_API_KEY를 설정하세요

# 실행
docker compose up --build

# 백엔드
cd backend
python -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
uvicorn app.main:app --reload --port 8000

# 프론트엔드 (별도 터미널)
cd frontend
npm install
npm run dev   # http://localhost:5173에서 시작

# 필수
SHODAN_API_KEY=your_shodan_api_key

# 선택 사항 — 추가 발견 소스로 Censys 사용
CENSYS_API_ID=
CENSYS_API_SECRET=

# 선택 사항 — AI 기반 공격 분석 활성화
ANTHROPIC_API_KEY=

# MongoDB (로컬 개발 시 기본값 사용)
MONGODB_URI=mongodb://localhost:27017
MONGODB_DB=aimap

# Redis (로컬 개발 시 기본값 사용, 선택 사항)
REDIS_URL=redis://localhost:6379/0

# CORS (기본값은 모든 출처 허용)
CORS_ORIGINS=*

# Modal 서버리스 (스캔/공격을 Modal 컨테이너로 전달)
MODAL_ENABLED=false

# Clerk 인증 — 아래 참조
CLERK_ISSUER=

protocol:mcp                          # MCP 서버
auth:none                             # 인증 없음
risk:critical                         # 위험 점수 9.0 이상
risk:high                             # 위험 점수 7.0 – 8.9
risk:medium                           # 위험 점수 4.0 – 6.9
risk:low                              # 위험 점수 1.0 – 3.9
tool:query_db                         # 특정 도구를 노출하는 엔드포인트
country:US                            # 국가 코드별
port:11434                            # 포트 번호별
org:"Amazon AWS"                      # 호스팅 조직별 (여러 단어는 따옴표)
has:system_prompt                     # 유출된 시스템 프롬프트가 있는 엔드포인트

protocol:mcp auth:none country:US     # 미국 내 인증 없는 MCP 서버
risk:critical tool:exec_code          # 코드 실행 도구가 있는 위험도 높은 엔드포인트
protocol:ollama port:11434            # 기본 포트의 Ollama

aimap/
├── backend/
│   ├── app/
│   │   ├── main.py                  # FastAPI 앱, 수명 주기, CORS, 라우터
│   │   ├── config.py                # Pydantic 설정 (환경 변수)
│   │   ├── auth.py                  # Clerk JWT 검증 (CLERK_ISSUER가 비어 있으면 우회)
│   │   ├── database.py              # 비동기 MongoDB (Motor) 연결
│   │   ├── limiter.py               # SlowAPI 속도 제한
│   │   ├── routes/
│   │   │   ├── endpoints.py         # CRUD + 검색 + 지구본 + 보강
│   │   │   ├── scans.py             # 스캔 수명 주기 + 실행 + WebSocket
│   │   │   └── attack.py            # 공격 전달 + Redis Streams + WebSocket
│   │   ├── discovery/
│   │   │   ├── orchestrator.py      # 스캔 파이프라인: Shodan → httpx → Nuclei → 수집
│   │   │   ├── shodan_adapter.py    # 32개의 큐레이팅된 Shodan 쿼리 + 결과 정규화
│   │   │   ├── nuclei_runner.py     # Nuclei 서브프로세스 실행기 + 결과 파서
│   │   │   └── base.py              # SourceAdapter 추상 기본 클래스
│   │   └── services/
│   │       ├── attack_mcp.py        # MCP 프로토콜 공격 엔진
│   │       ├── attack_ollama.py     # Ollama 공격 엔진
│   │       ├── attack_openclaw.py   # OpenClaw/Clawdbot 공격 엔진
│   │       ├── enrichment.py        # Shodan/Nuclei 보강 + 위험 점수
│   │       ├── live_probe.py        # 모델/도구 열거를 위한 HTTP 프로빙
│   │       ├── search.py            # Shodan 스타일 쿼리 파서 → MongoDB 필터
│   │       ├── redis_client.py      # 비동기 Redis 싱글톤 (대체 지원)
│   │       └── concurrency.py       # 세마포어 + Redis 기반 슬롯 제한
│   ├── Dockerfile
│   └── requirements.txt
├── frontend/
│   ├── src/
│   │   ├── App.tsx                  # 라우트 + Clerk 인증 래퍼
│   │   ├── pages/
│   │   │   ├── Marketing.tsx        # 3D 지구본이 있는 공개 랜딩 페이지
│   │   │   ├── Landing.tsx          # 인증된 대시보드 (지구본 포함)
│   │   │   ├── Search.tsx           # 쿼리 구문을 사용한 엔드포인트 검색
│   │   │   ├── Explore.tsx          # 모든 엔드포인트 탐색/필터
│   │   │   ├── AgentDetail.tsx      # 단일 엔드포인트 심층 분석
│   │   │   ├── TestAgent.tsx        # 공격 테스트 실행기
│   │   │   ├── Scans.tsx            # 스캔 관리
│   │   │   └── Ranges.tsx           # CIDR 범위 관리
│   │   ├── components/
│   │   │   ├── GlobeVisualization.tsx  # globe.gl 3D 지구본 + 범례
│   │   │   ├── Layout.tsx           # 앱 셸 (사이드바 + 내비바)
│   │   │   └── ui/                  # shadcn/ui 컴포넌트
│   │   ├── hooks/useApi.ts          # 모든 API 엔드포인트용 SWR 훅
│   │   └── lib/api-client.ts        # Clerk 토큰 주입이 포함된 Fetch 래퍼
│   ├── Dockerfile
│   ├── nginx.conf
│   └── tailwind.config.js
├── templates/                       # Nuclei YAML 템플릿
├── docs/                            # GitHub Pages 정적 사이트
├── docker-compose.yml
├── .env.example
└── README.md

MODAL_ENABLED=true