다음에 올 것을 만들어가는 기술에 대한 심층 기사.

AI 에이전트 시크릿 유출: 스캐닝 vs 격리

AI 코딩 에이전트의 '다시 묻지 않기' 허용목록으로 생기는 시크릿 유출을 스캐닝과 격리 관점에서 비교하고, 커밋된 자격 증명을 막는 실전 방어책을 정리합니다.

기계식 스위치보드. 위치로 표시된 레버 하나가 빛나는 케이블들을 라우팅하고, 그중 일부는 패널 밖으로 빛을 흘리고 있다
권한 허용목록은 통제처럼 느껴지지만, 승인한 모든 명령을 시크릿까지 포함해서 조용히 보관하고 있습니다.

보안 연구자들이 공개 GitHub 파일 1,000개 이상에서 비밀번호, API 토큰, 클라우드 자격 증명을 발견했습니다. 그것도 허술한 .env 파일이 아니라 AI 코딩 에이전트 설정 파일에서요. 원인은 AI 코딩 에이전트 시크릿 유출을 부르는 조용한 패턴입니다. 개발자가 curl -H "Authorization: Bearer sk-..." 같은 명령을 승인하고 “다시 묻지 않기”를 클릭하면, 토큰이 포함된 전체 명령이 로컬 설정 파일에 기록됩니다. 그 파일을 커밋하는 순간 시크릿은 공개됩니다. 저는 수년간 인프라 보안 일을 해왔는데, 이건 제가 본 유출 유형 중 가장 피할 수 있었던 것 중 하나입니다. 게다가 이 파일은 2년 전만 해도 존재하지 않았다는 점에서 완전히 새로운 유형이기도 합니다.

두 가지 방어책은 시크릿 스캐닝(유출을 탐지한 뒤 정리)과 격리(애초에 시크릿이 에이전트나 저장소에 닿지 않도록 하는 것)입니다. 둘 다 필요하지만, 어느 하나만으로는 충분하지 않습니다. 이 글에서는 두 방식을 정면으로 비교하고, 각각이 언제 유리하고 어디서 실패하는지 살펴본 뒤, Claude Code, Cursor 또는 권한 허용목록을 쓰는 어떤 에이전트든 팀에 도입한다면 제가 실제로 적용할 구성을 정리합니다.

먼저 짚고 넘어갈 점이 있습니다. 이건 에이전트 코딩 도구를 반대하는 글이 아닙니다. 저도 매일 쓰고 있고, 이제 없으면 안 됩니다. 권한 프롬프트, 즉 에이전트가 “이걸 실행해도 될까요?”라고 묻는 기능은 이 도구들이 제공하는 안전장치 중 가장 좋은 것 중 하나입니다. 문제는 여러분이 “예”라고 답한 뒤에 무슨 일이 일어나는가입니다. 그 “예”가 어디에 기록되고, 무엇을 담고 있는지가 핵심입니다.

허용목록이 시크릿 저장소가 되는 과정

이 실패 모드를 이해하려면 “다시 묻지 않기”가 실제로 무엇을 저장하는지 봐야 합니다. 에이전트 CLI가 명령 실행을 요청하면, 단순한 구현은 권한 규칙에 전체 명령 문자열을 저장합니다. 패턴이 아니고, 해시도 아닙니다. 승인했던 문자열 그대로입니다.

개발자가 aws s3 cp s3://bucket/backup.sql . --profile prod를 승인하는 건 무해합니다. 하지만 psql postgresql://admin:hunter2@db.internal/myapp나 curl -u deploy:APIKEY123 https://.../deploy를 승인하면, 자격 증명이 .claude/settings.local.json 또는 이에 상응하는 설정 파일에 그대로 남습니다. 이 설정 파일은 로컬에만 머물도록 설계되어 있습니다. Claude Code는 도구가 직접 파일을 만들 때 자동으로 gitignore에 추가하기도 합니다. 하지만 개발자가 파일을 수동으로 만들었거나 강제로 add했거나, 전역 gitignore가 이 파일을 막지 못하면, git add . 한 번과 push 한 번이면 GitHub에 올라갑니다. 연구자들이 찾은 1,122개 파일이 바로 이 연쇄 과정 때문에 생긴 겁니다.

이 체인의 각 고리는 하나하나 보면 합리적입니다. 인라인 자격 증명이 든 명령을 승인하는 건 개발자들이 수십 년간 대화형으로 해온 일이고, 명령은 실행되고 셸 히스토리는 로컬에만 남으니 아무도 신경 쓰지 않았습니다. “다시 묻지 않기”를 누르는 것도 합리적입니다. 프롬프트 피로는 실재하고, 이런 에이전트의 핵심 가치는 중단을 줄이는 데 있으니까요. 도구가 파일이 로컬이라고 말했다면 git add .도 변명할 여지가 있습니다. 이 사고는 한 명의 부주의에서 나온 게 아닙니다. 다섯 개의 무해한 행동이 합쳐져 공개 자격 증명이 되는 시스템에서 나온 겁니다. 이런 실패가 고치기 가장 어려운 이유는, 그 누구도 자신이 뭔가 잘못했다고 보지 않기 때문입니다.

에이전트가 생기기 전에도 같은 실수를 본 적이 있습니다. 제가 컨설팅했던 한 핀테크 회사의 팀 리드는 CI 헬퍼 봇을 위해 allowed_commands.sh를 두고 있었습니다. 개념은 같은데 직접 만든 것이었죠. 누군가 일회성 데이터베이스 마이그레이션 명령을 DSN을 인라인으로 넣은 채 승인했습니다. 6개월 뒤 저장소가 오픈소스로 공개되었고, DSN은 “설정이 아니다”라는 이유로 아무도 감사하지 않은 파일의 git 히스토리에 남아 있었습니다. 그 파일은 설정 파일이었습니다. 다만 설정처럼 보이지 않았을 뿐입니다.

핵심 통찰은 이겁니다. 권한 허용목록은 운영 시크릿을 부수적으로 포착하는 설정 파일입니다. 아무도 그것을 시크릿 보관 파일이라고 생각하지 않기 때문에 시크릿이 있는지 검토하지 않습니다. 여러분의 시크릿 관리 정책은 .env, credentials.yml, 어쩌면 Terraform state를 다룹니다. .claude/settings.local.json이나 .cursor/ 설정은 거의 확실히 다루지 않습니다. 우리는 비슷한 사각지대를 API 클라이언트를 자격 증명 저장소로 보고 감사하기에서 다룬 적이 있습니다. 매일 쓰는 도구들은 정책이 명시하지 않은 곳에 시크릿을 쌓아 둡니다.

그리고 이 범주는 점점 커지고 있습니다. 최근 몇 년간 출시된 에이전트 도구는 거의 모두 어떤 형태든 가지고 있습니다. 허용목록, 신뢰 디렉터리, 기억된 승인, 인라인 토큰이 들어간 MCP 서버 설정 같은 것들이죠. 각각은 기존 정책, gitignore, 스캐너 설정이 언급하지 않는 새로운 파일 경로입니다. 다음 사고는 이름만 다른 파일에서 같은 실수가 반복되는 형태일 겁니다.

시크릿 스캐닝 vs 격리: 두 가지 방어책

이 글 나머지에서 다룰 비교 기준은 다음과 같습니다:

  • 탐지 우선 (시크릿 스캐닝): pre-commit 훅, gitleaks나 trufflehog 같은 저장소 스캐너, GitHub나 GitLab의 push 보호 기능, 그리고 주기적인 히스토리 스캔. 시크릿은 새어 나간다고 가정하고, 빨리 찾아 교체합니다.
  • 격리 우선 (시크릿을 밖에 두기): 시크릿은 환경 변수, 비밀번호 관리자 CLI, 또는 단기 자격 증명을 통해서만 명령에 들어갑니다. 에이전트는 샌드박스나 일회성 VM에서 실행되고, 로컬 설정 파일은 전역 gitignore로 막습니다. 애초에 유출될 것이 없도록 설계합니다.

탐지는 사후 정리 작업이고, 격리는 설계 속성입니다. 두 방식은 반대 방향으로 실패합니다. 스캐닝은 놓치는 경우(false negative)가 있고 항상 사후에 실행됩니다. 격리는 도입 비용이 들고 개발자의 불편과 부딪힙니다. 어느 쪽이 유리한지는 어떤 실패 모드를 감수할 수 있는지에 달려 있습니다.

시간이 지나면서 두 방식이 무너지는 방식에도 비대칭이 있습니다. 스캐닝은 우아하게 저하됩니다. 놓친 시크릿은 나쁘지만, 잡아낸 것은 여전히 잡히고 룰셋도 개선됩니다. 격리는 예외를 통해 저하됩니다. 개발자가 “이번 한 번만 토큰을 직접 붙여넣자”며 불편을 우회할 때마다 속성은 약해지고, 그 약화를 기록하는 로그는 없습니다. 격리가 실패했다는 사실은 열린 자물쇠를 발견하는 것과 같아서, 누군가 확인해 볼 때에야 알게 됩니다. 그래서 두 방식은 경쟁자가 아니라 함께 써야 합니다. 다만 저는 둘에 다르게 가중치를 둡니다. 아래 섹션에서는 업계 기본값이지만 이 유출 유형에서는 둘 중 더 약한 스캐닝이 왜 그런지 설명합니다.

시크릿 스캐닝: 강점과 명확한 한계

스캐닝은 유출이 이미 일어났거나 곧 일어날 때 빛을 발합니다. 인간의 본성을 생각하면 그런 경우가 꽤 많습니다. GitHub의 push 보호는 push 시점에 알려진 토큰 형식을 차단합니다. pre-commit 훅의 gitleaks는 노트북을 떠나기 전에 놀라울 만큼 많은 것을 잡아냅니다. 이 글에서 하나만 실천한다면 이것을 하세요:

# .pre-commit-config.yaml
repos:
- repo: https://github.com/gitleaks/gitleaks
rev: v8.18.4
hooks:
- id: gitleaks

10분 정도 설정하면, 이 글에서 다룬 특정 유출 유형, 즉 커밋된 설정 파일 속 토큰은 대부분 사라집니다. gitleaks는 그 파일이 JSON 설정 파일인지 신경 쓰지 않기 때문입니다. 파일명이 아니라 내용을 스캔합니다. 내부 토큰 접두사가 있다면 정규식을 추가하세요.

팀들이 잊기 쉬운 스캐닝 계층이 하나 더 있습니다. 로컬 머신을 주기적으로 스캔해서 커밋되지 않은 시크릿을 찾는 것입니다. 저장소 레벨 훅은 커밋이나 push 시점에만 동작합니다. 설정 파일이 디스크에 석 달 동안 방치되다가 누군가 git add .를 실행하기 전까지, 그 시크릿은 공개까지 명령 한 줄 거리에 있는 상태입니다. 홈 디렉터리의 dotfile에 gitleaks를 매주 cron으로 돌리는 예약 작업만 있어도 그 기간을 며칠 수준으로 줄일 수 있습니다. 볼품없지만 작동합니다.

하지만 스캐닝에는 Claude Code 사례가 잘 보여주는 세 가지 명확한 한계가 있습니다. 첫째, 엔트로피 기반 탐지기는 엔트로피가 낮은 시크릿을 놓칩니다. psql 연결 문자열 안의 Winter2024! 같은 비밀번호는 엔트로피 검사에 걸리지 않고, 알려진 제공자 형식이 아니면 어떤 규칙에도 매칭되지 않습니다. 연구자들은 AWS 형식 키뿐 아니라 평문 비밀번호도 많이 찾아냈습니다. 둘째, 스캐닝은 push 단계에서 사후적입니다. push 보호는 push를 막아 주니 훌륭합니다. 하지만 탐지되지 않으면 시크릿은 히스토리에 남고, 히스토리는 영원합니다. 유출 후 교체하려면 그 자격 증명이 쓰인 모든 곳을 찾아야 하는데, 그 정리 작업이 하루보다 짧게 끝나는 걸 본 적이 없습니다. 셋째, 스캐닝은 완전하다는 잘못된 안도감을 줍니다. 팀은 초록색 체크 표시를 보고 시크릿이 어떻게 흐르는지 생각하지 않게 됩니다. AI 보안 스캐너에 관한 우리 글에서 말했듯이, 스캐너는 안전망이지 넘어지지 않는 것을 대신하지 않습니다.

두 번째 지점과 관련해, 자격 증명이 공개 저장소에 실제로 올라갔을 때 “정리”가 무엇을 뜻하는지 정확히 짚어 둘 필요가 있습니다. 팀들은 이를 늘 과소평가합니다. 교체는 쉬운 부분입니다. 토큰을 폐기하고, 새로 발급하고, 시크릿 저장소를 갱신하면 됩니다. 어려운 부분은 고고학 작업입니다. 옛 자격 증명을 쓰던 모든 배포 파이프라인, cron 작업, 개발자 노트북, 서드파티 연동을 찾아서 갱신해야 하고, 하나라도 놓치면 최악의 시점에 장애가 납니다. 거기에 거울 문제도 있습니다. 저장소가 공개라면 시크릿이 몇 분 안에 수집되었다고 가정해야 합니다. 자격 증명 수집 봇은 GitHub 이벤트 스트림을 계속 감시합니다. 스캐너가 알림을 보낼 때쯤이면 시크릿은 이미 복제되고, 색인되고, 프로덕션 엔드포인트에 시도되었을 수도 있습니다. 탐지는 인지를 가져다주었지만, 안전은 가져다주지 않았습니다.

그렇다고 스캐닝을 부당하게 대하고 싶지는 않습니다. 이 논쟁에서 너무 쉽게 무시되기 때문입니다. 저장소가 수백 개이고 개발자가 수천 명인 대기업에서는, 행동 변화 없이 확장되는 계층은 스캐닝뿐입니다. 이 규모에서는 교육으로 유출을 없앨 수 없지만, push 보호로 대부분을 막을 수는 있습니다. 첫 주에 노력을 어디에 쓸지 고민하는 플랫폼 팀이라면 답은 스캐닝입니다. 비용이 싸고, 중앙에서 관리할 수 있으며, 가장 큰 피해를 주는 고엔트로피 제공자 토큰을 잡아냅니다. 다만 그것이 전체 해법이라고 착각하지는 마세요.

큰 구멍이 난 어부의 그물이 어두운 물에서 끌어올려지고 있다. 빛나는 물고기 대부분은 틈 사이로 빠져나가고 몇 마리만 잡혀 있다
스캐닝은 인식하는 시크릿만 잡아냅니다. 엔트로피가 낮은 비밀번호와 새로운 형식은 빠져나갑니다.

격리: 환경 변수, 샌드박스, 단기 자격 증명

격리는 시크릿이 그렇지 않으면 글로 적히게 되는 모든 곳에서 빛을 발합니다. 바로 이 사고가 일어난 곳입니다. 자격 증명이 명령 안에 문자 그대로 나타나지 않는다면, 허용목록에 저장될 위험한 것이 없습니다. 승인된 명령은 curl -H "Authorization: Bearer $DEPLOY_TOKEN" ...가 되고, 설정 파일에는 무해한 변수 이름만 남습니다. 대부분을 덮는 규칙은 두 가지입니다:

  • 시크릿은 환경 변수나 간접 참조($TOKEN, $(op read ...), 에이전트가 런타임에 읽는 설정 파일)를 통해서만 명령에 들어갑니다. 리터럴 값으로는 절대 넣지 않습니다.
  • 에이전트 로컬 설정 디렉터리(.claude/, .cursor/, .aider*)는 프로젝트별이 아니라 머신 전역 gitignore(~/.config/git/ignore)에 넣어서, 어떤 프로젝트도 커밋할 수 없게 합니다.
# Global gitignore covers every repo on this machine
git config --global core.excludesFile ~/.config/git/ignore
cat >> ~/.config/git/ignore <<'EOF'
.claude/
.cursor/
.aider*
.env*
EOF

왜 저장소별이 아니라 전역일까요? 이유는 두 가지입니다. 첫째, 저장소별 gitignore는 누군가 새 저장소마다 항목을 추가하는 것을 기억해야만 존재합니다. 그런데 새 저장소는 바로 보안 위생을 신경 쓰지 않을 때 만들어집니다. 둘째, 전역 gitignore는 프로젝트 정책이 아니라 머신 정책입니다. “gitignore 정리”라는 풀 리퀘스트에서 실수로 제거될 수 없습니다. 실제로 그런 일이 벌어지는 걸 직접 본 적도 있습니다. 저장소별 버전은 저장소를 보호하고, 전역 버전은 개발자를 보호합니다. 그리고 여기서 유출 가능성이 높은 단위는 개발자입니다.

환경 변수 규칙도 같은 수준의 검토가 필요합니다. 미묘한 실패 모드가 있기 때문입니다. 바로 셸 프로필입니다. 개발자가 환경 변수 요구 사항을 .bashrc에 DEPLOY_TOKEN=sk-...를 export해서 “해결”하면, 시크릿을 검토되지 않은 dotfile 하나에서 다른 dotfile로 옮긴 것일 뿐입니다. 이 규칙은 실제 시크릿 백엔드에서 끝나야 합니다. 1Password CLI, 암호화된 저장소에서 읽는 direnv, 세션 시작 시 aws ssm이나 op inject를 쓰는 클라우드 시크릿 매니저 같은 것입니다. 에이전트는 변수를 받지만, 디스크에는 값이 남지 않습니다. 간접 참조가 한 단계 더 늘어나는 것뿐이지만, 이것이 격리와 겉치레를 가르는 차이입니다.

더 강한 격리는 제가 실제 샌드박싱이라고 부르는 것입니다. 작업마다 일회성 VM이나 컨테이너에서 에이전트를 실행하고, 격리된 네트워크에 두고, 외부 API 앞에 프록시를 둡니다. 제가 좋아하는 한 실무자의 구성은 에이전트와 전능한 SaaS 키 사이에 API 프록시를 둡니다. 읽기는 통과시키고, 쓰기는 휴대폰에서 탭해야 허용됩니다. 이것이 제대로 된 심층 방어입니다. --dangerously-skip-permissions가 켜진 채 에이전트가 완전히 장악되더라도, 프록시가 허용한 것만 건드릴 수 있습니다. 더 넓은 트레이드오프는 AI 에이전트의 격리 대 모니터링에서 다뤘습니다. 이번 사례는 격리의 손을 들어주는 근거입니다.

단기 자격 증명은 강한 버전의 나머지 절반입니다. 다른 모든 계층이 실패해도 폭발 반경을 줄여 주기 때문에 과소평가되곤 합니다. GitHub에 유출된 정적 AWS 액세스 키는 누군가 알아챌 때까지 유효합니다. 반면 1시간 TTL의 OIDC 발급 자격 증명이 GitHub에 유출되면, 그건 로그 항목 하나에 불과합니다. 클라우드 제공자가 워크로드 아이덴티티 페더레이션을 지원한다면(주요 제공자는 모두 지원합니다), 에이전트의 자격 증명은 사고 대응 팀이 회의를 소집하기도 전에 만료되어야 합니다.

격리의 솔직한 비용은 불편함입니다. 비밀번호 관리자 CLI는 작업 도중 지문 인증 프롬프트를 띄웁니다. 일회성 VM은 실행마다 설정 시간과 콜드 스타트 지연이 생깁니다. 범위가 제한된 프록시는 누군가 만들고 유지보수해야 합니다. 개인 사이드 프로젝트를 하는 개발자라면 전체 샌드박싱은 과합니다. 전역 gitignore와 환경 변수 조합이 맞는 선택입니다. 에이전트가 프로덕션 자격 증명에 접근하는 팀이라면, 그 불편함은 다음 침해 공지의 주인공이 되지 않기 위한 대가입니다.

중간 계층: 허용목록 자체를 고치기

여러분이 아니라 도구 벤더가 소유한 세 번째 선택지도 있습니다. 리터럴 명령을 저장하지 않는 것입니다. curl -H "Authorization: Bearer *"처럼 인수 값을 가린 패턴으로 권한 규칙을 저장하면, 매칭에는 충분히 쓸 수 있으면서 시크릿은 담지 않습니다. Claude Code 팀도 이 유형을 막는 방향을 검토 중이라고 밝혔고, 권장 방향은 허용/거부 목록을 유지할 필요가 없는 자동 권한 모드입니다. 올바른 직관입니다. 수동으로 관리하는 모든 허용목록은 아직 보이지 않는 타임스탬프를 달고 있는 미래의 사고입니다.

패턴 매칭이 공짜 점심은 아닙니다. 분명히 해 둘게요. curl * 같은 글롭은 무해한 배포 명령과 악의적인 유출 명령을 똑같이 매칭합니다. 따라서 공격적으로 가리면 유출 위험을 승인 범위 위험과 맞바꾸게 됩니다. 더 나은 설계는 텍스트보다 구조에 가까울 겁니다. 승인된 바이너리와 플래그만 저장하고, 인수 값은 절대 저장하지 않는 것입니다. 그러면 매칭은 정밀하게 유지되고(헤더가 있는 curl은 허용하고, 새 도메인으로 파이프하는 curl은 거부), 자격 증명이 숨을 수 있는 것은 아무것도 저장되지 않습니다. 벤더들은 결국 거기에 도달할 겁니다. 이미 수천 개가 넘는 공개 파일이라는 증거가 있으니 인센티브는 충분합니다.

벤더가 그걸 출시하기 전까지는 위생 관리로 근사할 수 있습니다. 로컬 설정 파일 자체를 주기적으로 스캔하세요. gitleaks detect --no-git --source ~/.claude .claude 같은 한 줄 명령이 이 글의 주제인 바로 그 파일을 감사합니다. 저장소 근처에 가기 전에 말이죠. dotfile 설정 스크립트에 넣어 두면 비용이 들지 않습니다.

제 권장안: 기본은 격리, 안전망은 스캐닝

하나만 고르라면 격리를 고르겠습니다. 일어나지 않은 유출은 빠르게 탐지된 유출보다 언제나 낫습니다. 스캐닝은 격리가 실패할 때 기대는 장치입니다. 그리고 격리는 실패합니다. 누군가는 새벽 1시에 연결 문자열을 채팅에 붙여넣을 테니까요. 하지만 스캐닝은 정책이 아니라 예외 처리기로 두어야 합니다.

구체적으로, 이번 분기에 에이전트 코딩 도구를 도입하는 팀이라면 노력이 적은 순서대로 다음을 적용하세요:

  1. 모든 개발자 머신에 에이전트 설정 디렉터리용 전역 gitignore를 설정하세요. 5분이면 되고, 커밋된 설정 파일 유출을 완전히 없앱니다.
  2. 규칙: 시크릿은 환경 변수나 비밀번호 관리자 CLI를 통해서만 넣고, 명령에 인라인으로 넣지 않습니다. 아무도 읽지 않는 위키가 아니라 온보딩에 넣으세요.
  3. pre-commit 훅으로 gitleaks를 실행하고, 포지 플랫폼에는 push 보호를 켜세요. 위 모든 것의 안전망입니다.
  4. 에이전트가 건드리는 모든 것에는 단기, 범위 제한 자격 증명을 사용하세요(정적 키 대신 OIDC 발급 클라우드 자격 증명). 그러면 유출되어도 몇 시간 안에 만료됩니다.
  5. 프로덕션 접근 권한이 있는 에이전트에는 일회성 샌드박스와, 에이전트 자격 증명이 할 수 있는 일을 범위 제한하는 API 프록시를 적용하세요.

순서에 주목하세요. 가장 저렴한 두 항목이 격리이고, 이 둘은 사고 확률을 줄이는 수준이 아니라 사고 유형 전체를 없앱니다. 스캐닝 항목이 첫 번째가 아니라 세 번째인 이유는 중요하지 않아서가 아닙니다. 줄 타기 아래의 그물과 같아서, 밧줄을 점검한 뒤에 그물을 설치하기 때문입니다. 4번과 5번은 사고를 막는 단계에서 침해를 막는 단계로 넘어가는 지점입니다. 우리가 계획하든 말든 에이전트 도구는 그쪽으로 가고 있습니다.

작은 문이 있는 요새 벽. 그 뒤로 두 번째 안쪽 벽과 중앙의 잠긴 금고가 있다
계층형 격리: 바깥 벽이 뚫려도 금고 안에는 훔쳐 갈 만한 정적 자격 증명이 없습니다.

이 사고에서 처음 두 항목만 적용했어도 연구자들의 데이터셋에 있던 거의 모든 파일을 막을 수 있었을 겁니다. 이게 이 사고에서 답답한 부분입니다. 정교한 공격이 아닙니다. 새로운 파일 형식에 오래된 실수가 담긴 것이고, 해결책은 처음 .env를 커밋한 이후 줄곧 강조해 온 위생 관리와 같습니다. 아직 어떤 정책도 언급하지 않는 디렉터리에 적용하면 됩니다.

정책을 업데이트하세요. 에이전트는 어디에도 가지 않고, “다시 묻지 않기” 버튼도 마찬가지입니다.