Weir는 AI 에이전트가 API 키 같은 자격 증명을 추적 정보, 로그, 모델 입력이나 다른 서비스로 보내는지 확인하는 도구다. 실제 키 대신 가짜 키를 심어 에이전트의 동작을 시험하고, Claude Code에서는 등록한 실제 키가 세션에 들어오거나 도구 호출로 나가는 상황을 표시한다.
에이전트 테스트는 weir-scan과 weir-run을 설치해 구성 파일에 키가 놓일 위치와 실행할 흐름을 지정한 뒤 진행한다. Weir는 로컬 가짜 모델을 상대로 에이전트의 흐름을 실행하고, 전송된 데이터에서 심어 둔 값과 정확히 일치하는 항목을 찾는다. 테스트는 CI나 노트북에서 실행할 수 있으며, 풀 리퀘스트에 결과를 댓글로 남기는 GitHub Action도 제공한다. MLflow에서 발견한 보안 권고(GHSA-j7qq-vr8c-xvw3)는 3.17.0에서 수정됐다.
Claude Code의 상태 표시줄은 등록한 실제 자격 증명 가운데 세션에 들어온 것과 도구 호출로 나간 것이 몇 개인지 보여준다. 값 자체는 표시하지 않으며, Weir는 실제 키를 저장하는 대신 키 기반 지문만 보관한다고 설명한다. 설정 과정에서 동의하면 읽기, Bash, Grep, Glob, WebFetch 결과에서 등록된 키 전체와 일치하는 값을 [weir: NAME removed]로 바꾸는 훅도 추가할 수 있다. 훅이 실패하면 상태 표시줄에 ‘possibly not redacted’라고 표시한다.
Weir는 키 전체 값만 탐지하므로 해시되거나 일부만 잘리고 다른 텍스트와 붙은 값은 찾지 못한다. 테스트가 실행되는 동안 에이전트가 보내는 내용만 확인하며, 네트워크 격리는 권한 없는 사용자 네임스페이스를 허용하는 Linux에서만 지원한다. 그 밖의 환경에서는 네트워크가 격리되지 않았다고 보고한다. 훅은 도구 실행 뒤 모델이 읽는 결과만 바꾸므로 이미 실행된 명령이나 채팅에 직접 붙여 넣은 키를 되돌리거나 잡아내지는 못한다. Weir는 Apache-2.0 라이선스로 제공된다.
- 빠른 실행:
pip install weir-scan을 설치한 뒤weir canary judge --sample을 실행한다. - 문서: Weir 저장소, 에이전트 테스트 안내, 상태 표시줄 문서
댓글 (0)
로그인하면 이 기사에 내 생각을 남길 수 있어요