openshield — 오픈소스 Azure CSPM - 잘못된 구성과 양자-안전하지 않은 암호화를 스캔하고, 발견 사항을 CIS/NIST/ISO27001/SOC2에 매핑하며, 단일 명령으로 수정합니다. | Kitploit

기능	설명
오설정 스캐너	스토리지, 네트워크, ID, 데이터베이스, 컴퓨팅, Key Vault, AKS, 포스트퀀텀 암호화, 백업, 서버리스, 프라이빗 엔드포인트 및 공급망 태세 전반에 걸쳐 95개의 Azure 보안 규칙 실행
규정 준수 매퍼	탐지 결과를 CIS Benchmarks, NIST CSF, ISO 27001 및 SOC 2 프레임워크 JSON 파일에 매핑
스캔 기록 API	스캔 및 탐지 결과를 PostgreSQL에 저장하고 REST를 통해 탐지 결과, 점수, 스캔 기록, 규정 준수 태세, 드리프트 및 리소스 인벤토리 노출
수정 플레이북	모든 규칙에 일치하는 Azure CLI 수정 스크립트 포함(95개 플레이북)
보안 대시보드	Vercel에 배포된 전체 React 대시보드 - 실시간 모니터링, 탐지 결과, 규정 준수, 드리프트, 우선순위 및 AI 계층 보기
프로젝트 웹사이트	openshield-org.github.io/openshield의 문서 및 참조 사이트 - 블로그, 규칙 갤러리, 아키텍처, 증거 가이드, 로드맵 및 릴리스
Sentinel 통합	탐지 결과를 정규화하고 Log Analytics 사용자 지정 테이블 및 KQL 분석 규칙을 통해 Microsoft Sentinel로 전송

flowchart TD
    A["React Dashboard\nVercel · Live"]
    B["Flask REST API\nJWT · CORS · Blueprints"]
    C["Scanner Engine\n95 Python rules"]
    D["Azure Subscription\nScanned via Azure SDK + Graph"]
    E["Compliance Framework JSON\nCIS · NIST · ISO 27001 · SOC 2"]
    F["PostgreSQL Database\nFindings · Scans"]
    G["Azure CLI Playbooks\n95 remediation scripts"]
    H["sentinel/ingest.py\nNormalise + HMAC upload"]
    I["Microsoft Sentinel\nOpenShieldFindings_CL · KQL rules"]

    A -->|REST calls| B
    B -->|trigger scans| C
    B -->|read/write| F
    B -->|compliance score| E
    C -->|Azure SDK + Graph| D
    C -->|findings| F
    C -->|scan output JSON| H
    G -->|manual fixes| D
    H -->|Data Collector API| I
    I -->|alerts| A

[!IMPORTANT] 보안 요구사항: 프로덕션 배포는 JWT_SECRET이 없거나, 안전하지 않은 기본값으로 설정되었거나, 32자 미만인 경우 시작 시 실패합니다. 강력한 비밀 키를 생성하려면:
python -c "import secrets; print(secrets.token_urlsafe(32))"
이 강제 적용을 활성화하려면 OPENSHIELD_ENV=production을 설정하세요(또는 Render의 자동 RENDER=true에 의존). 이러한 신호 없이 실행되는 로컬 개발은 경고와 함께 기본값 사용이 허용됩니다.

계층	기술	비용
프로젝트 웹사이트	정적 HTML + Tailwind CDN, Vercel에 배포	무료
보안 대시보드	React + Vite + Tailwind, Vercel에 배포	무료
백엔드 API	Python + Flask	무료
데이터베이스	PostgreSQL	Render 관리형 PostgreSQL
클라우드 스캐너	Python + Azure SDK	무료
수정	Azure CLI 플레이북	무료
SIEM	Microsoft Sentinel	90일 무료 체험
CI/CD	GitHub Actions	무료
저장소	GitHub	무료

openshield/
├── scanner/               # Azure 오설정 규칙 엔진
│   ├── rules/             # 개별 스캔 규칙 (여기에 기여하세요!)
│   ├── engine.py          # 핵심 스캔 오케스트레이션
│   └── azure_client.py    # Azure SDK 래퍼
├── compliance/            # 프레임워크 매핑 엔진
│   └── frameworks/        # CIS, NIST, ISO 27001, SOC 2 매핑
├── playbooks/             # 수정 플레이북
│   ├── arm/               # 향후 ARM 템플릿용 예약
│   ├── terraform/         # 향후 Terraform 수정용 예약
│   └── cli/               # Azure CLI 스크립트
├── api/                   # Flask REST API
│   ├── routes/
│   └── models/
├── frontend/              # React 보안 대시보드 (Vercel)
├── website/               # 프로젝트 웹사이트 - 문서, 블로그, 규칙 갤러리 (Vercel)
├── sentinel/              # Sentinel 통합 및 KQL 규칙
├── .github/workflows/     # CI 검사
├── docs/                  # 문서
├── CONTRIBUTING.md
└── README.md

# 저장소 복제
git clone https://github.com/openshield-org/openshield.git
cd openshield

# Python 종속성 설치
pip install -r requirements.txt

# Azure 자격 증명 설정
export AZURE_SUBSCRIPTION_ID=your-subscription-id
export AZURE_CLIENT_ID=your-client-id
export AZURE_CLIENT_SECRET=your-client-secret
export AZURE_TENANT_ID=your-tenant-id
export JWT_SECRET=your-strong-secret   # 쓰기 엔드포인트 보호에 사용 (스캔 트리거, AI)
export DATABASE_URL=postgresql://openshield:openshield@localhost:5432/openshield

# 데이터베이스 스키마 생성 또는 업데이트
alembic upgrade head

# 스캔 실행
python -c "
from scanner.engine import ScanEngine
import json, os
result = ScanEngine(os.environ['AZURE_SUBSCRIPTION_ID']).run_scan()
print(json.dumps(result, indent=2))
"

# API 시작
FLASK_APP=api/app.py flask run

# PostgreSQL 16 시작, 마이그레이션 적용 후 API, worker 및 대시보드 시작
docker compose --profile local up --build

# 데이터베이스 인식 API 준비 상태 확인
curl --fail http://127.0.0.1:8000/ready

cd frontend
npm install

# 로컬 개발 - 기본적으로 http://localhost:5000을 가리킴
npm run dev

# 라이브 Render 백엔드에 대해 개발하려면:
VITE_API_URL=https://openshield-api.onrender.com npm run dev

서비스	URL
보안 대시보드 (Vercel)	`https://openshield-gules.vercel.app`
REST API (Render)	`https://openshield-api.onrender.com`
프로젝트 웹사이트	`https://openshield-org.github.io/openshield/`

openshield

인기

문제점

포스트퀀텀 암호화가 지금 중요한 이유

OpenShield 기능

보안 보증

아키텍처

라이브 데모

기술 스택

프로젝트 구조

빠른 시작

기여

로드맵

라이선스

OpenShield 학습

API 참조

변경 로그