01
커밋 경계
비밀값이 기록에 남기 전에.
API 키나 토큰이 담긴 변경, 배포에 포함하면 안 되는 파일을 커밋할 때 검사합니다.
Git 훅에서 검사
보호 범위
작업의 경계마다,
확인할 것을 나눕니다.
AI 에이전트가 일하는 저장소에
정책과 검사를 더하는 보안 도구입니다.
02
쓰기 경계
파일에 쓰기 전에 한 번 더.
지원되는 도구의 사전 훅에서 비밀값 쓰기와 자기 권한 설정 변경을 검사합니다.
도구와 연결 상태에 따라 작동
03
상태 점검
설치 뒤에도 설정을 확인합니다.
정책과 도구 설정의 어긋남, 도구가 제공하는 격리 설정의 활성 여부를 확인합니다.
설치 여부와 작동 여부를 구분
작동 방식
규칙은 한곳에.
검사는 필요한 곳에.
정책 파일에 작업 범위와 검사 기준을 적습니다. 도구마다 흩어진 설정을 같은 기준으로 확인하고, 판정의 근거를 기록합니다.
- 정책을 읽고 검사합니다.
- 도구별 설정과 대조합니다.
- 기록에 비밀값을 남기지 않습니다.
정책 파일일부 예시
[mode]
level = "작업공간"
[secrets]
scanner = "자동"
warn_as_block = false
[audit]
enabled = true
level = "결정만"보호의 한계
맡길 수 없는 일도
분명히 적어 둡니다.
설치됐다는 사실만으로
모든 작업이 보호되지는 않습니다.
쓰기 검사는 지원 도구에서만
2차 층이 없어도 커밋 검사는 남습니다. 훅을 거치지 않는 작업까지 감시하지는 않습니다.
OS 격리는 별도의 역할
OS 격리는 우리가 만들지 않는다. 각 도구가 제공하는 격리 기능의 설정을 확인합니다.
오탐 가능성도 남습니다
비밀값인지 애매한 판정은 기본적으로 경고합니다. 모든 유출이나 위험한 행동을 막는다는 뜻은 아닙니다.
명령 통제는 실환경 검증 전
선택형 명령 통제 기능을 구현했지만, 실제 Claude·Codex 환경에서의 차단 검증은 아직 끝나지 않았습니다.
설계의 근거
무엇을 만들었는지,
왜 그렇게 정했는지.
위협을 조사하고 대응 레퍼런스를 비교했습니다. 선택과 제외의 이유는 의사결정 기록(ADR)에 남겼습니다.
이식 실측
확인한 만큼만
말하겠습니다.
서로 다른 저장소에서의 실측을 준비하고 있습니다.
아직 결과 수치를 공개할 단계는 아닙니다.
설치 성공률
측정 중
새 저장소에 정상 설치되는지
차단 발동률
측정 중
막아야 할 작업을 실제로 막는지
오탐률
측정 중
정상 작업을 잘못 막지는 않는지
도입 문의
내 작업 환경에서는
어디까지 가능할까요?
사용 중인 도구와 필요한 보호 범위를 알려주세요.