Stroq: AI 코딩 에이전트를 위한 로컬 보안 감사 및 가드레일
개요
Stroq은 Claude Code, Cursor, Codex CLI를 포함한 AI 코딩 에이전트를 감사하고 보호하기 위해 설계된 로컬 보안 플랫폼입니다. 이 플랫폼은 에이전트가 읽은 콘텐츠를 기반으로 어떤 명령이 실행되는지 추적하여 에이전트의 동작에 대한 가시성을 제공하는 동시에, 민감한 자격 증명이 실수로 유출되는지 모니터링합니다. 이 도구는 원격 측정(telemetry) 없이 완전히 로컬에서 작동하며, Node.js 22 이상 버전만 있으면 됩니다.
핵심 기능
Stroq은 사후 감사 도구이자 실시간 가드레일 시스템으로 기능합니다.
과거 세션 감사
사용자는 stroq replay 및 stroq sent 명령을 사용하여 지난 30일간의 에이전트 활동을 분석할 수 있습니다. 이 도구들은 로컬 세션 기록을 파싱하여 다음을 식별합니다:
- 비밀 정보 노출: 자격 증명(예: AWS 키 또는 API 토큰)이 외부 서비스로 전송되었거나 AI 모델에 노출되었을 가능성이 있는 경우 이를 표시합니다. 실제 값은 마스킹하면서 키 이름은 명확하게 표시합니다.
- 출처 추적: 에이전트가 이전에 읽은 특정 파일이나 텍스트를 기반으로 명령을 추적하여, 에이전트가 왜 특정 작업을 실행하기로 결정했는지 사용자가 이해하도록 돕습니다.
실시간 가드레일
npx @stroq/cli init을 실행하면 사용자는 도구 호출이 실행되기 전에 이를 가로채는 훅(hook)을 설치할 수 있습니다. 이 훅은 다음을 수행합니다:
curl | sh와 같은 위험한 패턴을 거부합니다.- 알려진 비밀 정보가 포함된 아웃바운드 네트워크 호출을 차단합니다.
- 에이전트가 이전에 읽은 텍스트를 명령이 반복할 때 사용자에게 확인을 요청합니다.
보안 및 개인정보 보호
Stroq은 개인정보 보호 우선 아키텍처를 강조합니다. 외부 서버로 데이터를 전송하지 않으며, 계정이 필요 없고, 원격 측정을 사용하지 않습니다. 모든 분석은 로컬 머신에서 수행되며 콘솔 인터페이스는 127.0.0.1에서 실행됩니다. 이 도구는 완전한 샌드박스보다는 에이전트 작업에 대한 필터로 설계되었으며, 사용 중인 특정 에이전트와 버전에 따라 기능이 달라지는 훅에 의존합니다.
커뮤니티 피드백 및 향후 방향
이 프로젝트에 대한 논의에서는 다음과 같은 추가 개발 방향이 제시되었습니다:
- eBPF 통합: 일부 사용자는 eBPF 기반 백엔드로 전환하면 커널 수준에서 공격적인 시나리오를 포착하여 보안 범위를 개선할 수 있다고 제안했지만, 이는 Linux 환경으로 제한될 것입니다.
- 데몬화된 모니터링: 메뉴바 애플리케이션을 통해 실시간 알림을 제공하여 플래그가 지정된 에이전트 작업을 즉시 수정하거나 관리할 수 있는 백그라운드 데몬에 대한 제안이 있었습니다.
"ebpf 백엔드를 사용하면 훨씬 더 많은 공격 시나리오를 다룰 수 있습니다. 리눅스가 필요하지만, 요즘 나오는 모든 패치들을 고려하면 어차피 개발은 VM에서 해야 합니다." — @maven29
시작하기
Stroq은 npm을 통해 배포됩니다. 주요 명령은 다음과 같습니다:
npx @stroq/cli: 최근 에이전트 세션의 요약 카드를 표시합니다.npx @stroq/cli init: 에이전트 구성에 보안 훅을 설치합니다.npx @stroq/cli console: 규칙을 관리하고 세션 기록을 검토하기 위한 로컬 웹 인터페이스를 실행합니다.npx @stroq/cli attack: 샌드박스 환경에서 36개의 알려진 공격 패턴 모음을 실행하여 현재 정책의 효과를 테스트합니다.