본문으로 건너뛰기
에이전트 Skills 전체 목록

Security Audit Skill (Cloudflare)

  • 추천0
  • GitHub 별74K
  • 개발라이선스MIT

코딩 에이전트가 정찰 · 취약점 사냥 · 독립 검증을 거쳐 보안 감사 보고서를 만들어요. MIT

원본:cloudflare/security-audit-skill

요약

코딩 에이전트가 정찰 · 취약점 사냥 · 독립 검증을 거쳐 보안 감사 보고서를 만들어요. MIT

설명

security-audit

코딩 에이전트를 보안 감사자로 바꿔 주는 스킬이에요. 서로 격리된 에이전트들을 이끌어 정찰, 커버리지 중심 사냥, 후보 검증, 구조화된 출력, 독립적인 기록 검증, 대상에 얽매이지 않는 보고서 작성까지 이어서 진행해요.

이 스킬은 Cloudflare의 취약점 발견 하네스의 씨앗이 된 스킬이에요. 그 하네스는 Build your own vulnerability harness에 소개돼 있어요. 하네스는 여러 단계로 이뤄진, 전사 규모의 시스템으로 자랐고, 이 스킬은 그 출발점이 된 단일 저장소용 버전이에요.

하는 일

스킬은 구조화된 감사를 여섯 단계로 진행해요.

  1. 정찰 -- 아키텍처, 신뢰 경계, 입력 지점, 이전 증거, 결정적 커버리지를 architecture.md와 coverage-ledger.json에 지도로 그려요.
  2. 커버리지 중심 사냥 -- 원장(ledger)의 단위마다 격리된 사냥꾼을 배정하고, 그들이 확인한 내용을 기록해요. 커버리지 비평가가 빈틈을 찾아요.
  3. 후보 검증 -- 겹치지 않는 후보마다 새 검증 에이전트를 붙여서, 그 후보를 반증해 보게 해요.
  4. 구조화된 출력 -- confirmed, needs_validation, rejected 기록을 findings.json에 쓰고 report-schema.json으로 검증해요.
  5. 독립적인 기록 검증 -- 새 에이전트들이 최종 소스 주장을 검증해요. 실질적인 교체가 있으면 또 다른 독립 검증 에이전트가 한 번 더 확인해요.
  6. 대상에 얽매이지 않는 보고서 -- 검증된 기록과 커버리지 원장에서 REPORT.md, FINDINGS-DETAIL.md, NEEDS-VALIDATION.md를 만들어요.

부모 에이전트는 원장을 만든 뒤와 이후 원장을 고칠 때마다 validate-coverage-ledger.cjs를 돌려요. 4단계에서는 validate-findings.cjs를 돌리고, 5단계에서 교체가 있을 때마다 다시 돌려요.

판정은 서로 구분돼요. confirmed는 소스 추적이 완전하고 관찰된 결과의 범위가 정해진 것, needs_validation은 풀리지 않은 사실이 정확히 하나 남아 있고 심각도는 없는 것, rejected는 반증된 후보를 기록한 것이에요.

같은 저장소에 여러 번 돌린 결과는 쌓여요. 스킬은 이전 원장과 발견을 보고 빈틈을 겨냥하고, 바뀐 소스를 다시 검증하고, 현재 소스에 맞는 증거는 이어받아요. 오래됐거나 풀리지 않은 작업을 커버된 것으로 치지는 않아요.

파일

파일용도
SKILL.md설정, 핵심 원칙, 플랫폼 용어, 워크플로 개요, 감사에서 피할 패턴
RECONNAISSANCE.md1단계 정찰 프롬프트와 종합 지침
HUNTING.md2단계 오케스트레이션, 사냥 방법론, 검증 규칙
ATTACK-CLASSES.md핵심, 와일드카드, 뻔한 것들에 대한 공격 프롬프트
MEMORY-SAFETY-AND-BINARY.md네이티브 대상용 메모리 안전, 바이너리, 커널 사냥 분류
AI-AND-LLM.mdLLM 기반 대상용 프롬프트 인젝션, 에이전트·도구, 출력 처리 사냥 분류
WEB-PROTOCOL-AND-AUTH.mdHTTP 프로토콜·인증 대상용 HTTP 요청 프레이밍, 캐시, 인증 프로토콜 사냥 분류
CLIENT-SIDE.md클라이언트·브라우저 대상용 DOM 인젝션, 메시지 신뢰, UI 리드레스, 프로토타입 오염 사냥 분류
SUPPLY-CHAIN-AND-RELEASE.md의존성, CI, 릴리스, 서명, 업데이트, 플러그인, 확장 사냥 분류
CLOUD-AND-DEPLOYMENT.mdIAM, 코드형 인프라, 컨테이너, 서버리스, 인그레스, 런타임 설정 사냥 분류
PROTOCOLS-RPC-AND-MESSAGING.mdRPC, 직렬화, 큐, 브로커, 웹훅, 스트리밍 프로토콜 사냥 분류
RESOURCE-EXHAUSTION-AND-AVAILABILITY.md공유 자원, 할당량, 큐, 워커, 운영자 비용 사냥 분류
DATA-ISOLATION-AND-LIFECYCLE.md테넌트 격리, 캐시, 검색, 내보내기, 백업, 마이그레이션, 삭제, 복원 사냥 분류
DESKTOP-MOBILE-AND-LOCAL-IPC.md네이티브 앱, 딥링크, 웹뷰, 노출된 컴포넌트, 헬퍼, 데몬, 로컬 IPC 사냥 분류
VALIDATION-AND-REPORTING.md3~6단계 후보 검증, 구조화된 출력, 기록 검증, 보고서 작성
report-schema.jsonfindings.json의 세 판정 모두를 위한 JSON 스키마
validate-findings.cjs4·5단계에서 findings.json을 검증하는, 의존성 없는 검증기
validate-findings.test.cjs발견 검증기 테스트와 생산자 호환 픽스처 확인
validate-coverage-ledger.cjs1~5단계에서 coverage-ledger.json을 검증하는, 의존성 없는 검증기
validate-coverage-ledger.test.cjs커버리지 원장 검증기 테스트

설치

Skills CLI로 스킬을 설치해요.

npx skills add https://github.com/cloudflare/security-audit-skill \
  --skill security-audit

사용자 단위로 설치하려면 --global을 붙여요.

npx skills add https://github.com/cloudflare/security-audit-skill \
  --skill security-audit \
  --global

에이전트 선택과 비대화형 옵션은 npx skills --help로 확인하세요.

사용법

감사할 코드베이스 안에서(또는 그 코드베이스를 가리키도록) 코딩 에이전트를 시작하고, 보안 감사를 해 달라고 말하세요.

security audit this codebase
find security vulnerabilities in ./src
do a security review, output to ~/audits/my-project

요청이 스킬의 트리거(보안 감사, 취약점 찾기, 코드 모의해킹 등)와 맞으면 스킬이 자동으로 켜져요. 코드베이스 감사나 모의해킹을 직접 요청하면 전체 감사 모드로 돌아요. 보안에 관한 질문이나 특정 취약점에 집중한 작업은, 보고서 산출물을 따로 요청하지 않는 한 안내 모드로 돌아요. 전체 감사 모드에서 출력 폴더를 정하지 않으면 ~/security-audit-skill/ 아래에 실행마다 새 폴더가 만들어져요. 버전 관리가 무시하는 폴더를 직접 골랐을 때에만 대상 저장소 안에 써요.

필요한 것

  • 도구 사용과 병렬 하위 에이전트를 지원하는 모델을 쓰는 코딩 에이전트
  • 의존성 없는 발견 검증기와 커버리지 원장 검증기를 돌릴 Node.js
  • 대상이 정한 빌드, 테스트, 프로세스, 브라우저, 에뮬레이터, 퍼저, 픽스처를 실행할 때 쓸 OS 수준의 샌드박스. 외부 네트워크를 끄고, 허용 목록으로 정제한 환경 변수만 쓰고, 자원 한도를 강제하고, 지정한 임시 경로에만 쓰게 해야 해요. 이런 통제가 없으면 워크플로는 대상 코드를 실행하지 않고 그 단서를 needs_validation으로 남겨 둬요.

설계 원칙

  • 경계가 무너진 것이 확인된 것만 확정해요. 소스에 근거가 있지만 막힌 단서는 풀리지 않은 사실을 정확히 적어 needs_validation으로 둬요.
  • 적대적 검증. 발견을 확인하는 에이전트는 그것을 찾은 에이전트가 아니에요.
  • 심각도에는 영향이 필요해요. 체크리스트와 다른 점이 아니라, 가능성 × 영향으로 따져요.
  • 방어 심화의 빈틈은 취약점이 아니에요. A 계층이 공격을 막고 있다면 B 계층이 없다는 것은 보강 메모일 뿐이에요.
  • 여러 번 돌리면 커버리지가 나아져요. 저희 시험에서는 한 번 돌린 결과가, 반복해서 돌려 찾은 전체 취약점의 약 절반이었어요.

문의

AI 기반 보안 도구에 대한 질문, 의견, 경험 나누기: security-ai-research@cloudflare.com

라이선스

MIT -- LICENSE를 보세요.

평점

–평가 0개 기준
5점
0
4점
0
3점
0
2점
0
1점
0