UltraSec은(는) 무엇을 하나요?
다중 파일 보안 감사 에이전트 스킬 — 함수와 파일 간에 신뢰할 수 없는 데이터를 추적(소스-싱크 오염 분석)하고 Trivy/Semgrep/gitleaks/osv-scanner를 오케스트레이션하며, 발견된 사항을 인용 및 계층화된 보고서로 적대적 검증합니다. UltraIndex/UltraSearch의 자매 스킬입니다.
개요
AI 에이전트(예: Claude Code, Cursor, Codex)용으로 설계된 이 스킬은 보안 감사 워크플로우를 자동화합니다. 코드 전체의 데이터 흐름을 분석하고, 여러 보안 스캐너를 실행하며, 결과를 통합하여 실행 가능한 보고서를 제공합니다.
주요 기능
- 소스-싱크 오염 분석: 신뢰할 수 없는 입력(소스)이 사용자 입력, 파일 읽기, 네트워크 요청 등에서 함수 및 파일 전체를 거쳐 민감한 작업(싱크)으로 전파되는 방식을 식별합니다.
- 다중 스캐너 오케스트레이션: Trivy(컨테이너 및 의존성), Semgrep(사용자 정의 가능한 정적 분석), gitleaks(비밀 유출 탐지), osv-scanner(의존성 취약점)를 통합하여 실행합니다.
- 적대적 검증: 발견된 취약점을 다양한 관점에서 재확인하여 허위 양성을 줄이고, 정확성과 실용성을 향상시킵니다.
- 계층화된 보고서: 각 취약점을 심각도(critical, high, medium, low)별로 분류하고, 코드 위치와 관련 컨텍스트를 인용하여 우선순위를 정할 수 있도록 지원합니다.
사용 예시
에이전트가 UltraSec 스킬을 사용하여 소스 코드 저장소의 보안 감사를 수행하도록 요청할 수 있습니다.
# 예시: 현재 디렉토리에서 보안 감사 실행
ultrasec audit .
# 특정 파일 또는 디렉토리 감사
ultrasec audit path/to/code
동작 방식
- 오염 분석: 소스 코드의 소스(예:
request.GET), 싱크(예:os.system), sanitizer(예:escape)를 식별하기 위해 코드베이스를 구문 분석합니다. - 스캐너 실행: 구성된 모든 보안 스캐너(Trivy, Semgrep, gitleaks, osv-scanner)를 병렬 또는 순차적으로 실행합니다.
- 결과 상관관계 분석: 다양한 스캐너의 결과를 오염 분석 결과와 병합하여 종합적인 취약점 맵을 생성합니다.
- 적대적 검증: 각 취약점에 대해 반례(counterexample)를 찾거나 대체 경로를 분석하여 실제 위험을 확인합니다.
- 보고서 생성: 모든 검증된 취약점을 포함하고, 각 취약점에 심각도, 영향 범위, 권장 조치 사항을 제공하는 계층화된 보고서를 생성합니다.
지원 플랫폼
- Claude Code: 자연어 명령으로 보안 감사 워크플로우를 트리거할 수 있습니다.
- Cursor: 편집기 내에서 보안 분석을 직접 통합합니다.
- Codex: API를 통해 자동화된 보안 파이프라인의 일부로 기능을 제공합니다.
의존성
- Trivy: 컨테이너 이미지 및 파일 시스템 취약점 스캐너.
- Semgrep: 사용자 정의 가능한 패턴 기반 정적 분석.
- gitleaks: Git 저장소에서 하드코딩된 비밀 탐지.
- osv-scanner: 오픈 소스 의존성 취약점 스캐너.
이러한 도구들은 시스템에 설치되어 있고 $PATH에 있어야 UltraSec이 올바르게 작동합니다.
환경 변수
ULTRASEC_VERBOSE: 자세한 로깅을 활성화합니다 (예:1).ULTRASEC_SKIP_SCANNERS: 쉼표로 구분된 스캐너 목록을 실행에서 제외합니다 (예:trivy,gitleaks).
자세한 정보
자세한 내용은 UltraSec 저장소를 방문하거나 자매 프로젝트인 UltraIndex 및 UltraSearch를 확인하세요.