agent-shield은(는) 무엇을 하나요?
13개의 엔진으로 AI 관련 플러그인과 도구를 스캔하여 보안 위험을 신속하게 탐지하고, 사용 전 안전한 설치를 보장합니다.
개요
Agent Shield는 AI 에이전트(예: Claude Code, Cursor, Codex)와 함께 작동하여 플러그인, 확장 프로그램, 패키지 및 기타 타사 도구를 설치하기 전에 보안을 검사합니다. 13가지 정적 분석 엔진을 사용하여 악성 코드, 취약점 및 의심스러운 동작을 탐지하고 자세한 보안 보고서를 제공합니다.
주요 기능
- 다중 엔진 스캐닝: 13가지 보안 엔진을 동시에 실행하여 포괄적인 위협 탐지
- 실시간 위험 평가: 스캔 결과를 기반으로 즉각적인 위험 점수 및 심각도 레이블 제공
- 설치 전 보호: 패키지 또는 플러그인이 환경에 도달하기 전에 위험 식별
- AI 에이전트 통합: CI/CD 파이프라인 및 AI 에이전트 명령줄에 원활하게 통합
지원 플랫폼
- Claude Code
- Cursor
- Codex
- 기타 AI 에이전트 도구
사용 방법
-
플러그인 스캔: 다음 명령을 실행합니다.
agent-shield scan <file_or_url>예:
agent-shield scan my-plugin.tar.gz -
결과 검토: 각 스캔 엔진의 위험 점수 및 발견 사항이 포함된 JSON 또는 표 형식의 보고서를 받습니다.
-
조치: 심각도에 따라 플러그인 설치를 허용 또는 차단하거나 수동 검토를 위해 표시합니다.
예시 워크플로우
# 패키지 스캔
agent-shield scan https://registry.npmjs.org/suspicious-package/-/suspicious-package-1.0.0.tgz
# 출력 예시
[위험 탐지] 13개 엔진 완료
- 높음: 2 (악성 코드 패턴)
- 중간: 1 (의심스러운 네트워크 호출)
- 낮음: 3 (사용되지 않는 권한)
결론: 설치 차단됨
구성
환경 변수:
AGENT_SHIELD_API_KEY: API 액세스용 키 (선택 사항)AGENT_SHIELD_TIMEOUT: 스캔당 제한 시간 (초) (기본값: 60)AGENT_SHIELD_ENGINES: 활성화할 엔진 이름을 쉼표로 구분한 목록 (기본값: 모두)
보안 고려 사항
- 에이전트가 설치 전에 스캔을 실행하도록 구성되었는지 확인합니다.
- 잠재적 위험을 효과적으로 평가하려면 최신 엔진 서명 데이터베이스를 유지합니다.
- 에이전트의
beforeInstall후크에서 스캔 결과를 사용하여 안전한 설치를 자동화합니다.
라이선스
MIT