이 엔지니어를 위한 이야기 공장 AI 기술에 인문학의 온기를

에이전트 승인 파일 1,122개에서 나온 자격증명

에이전트 승인 파일 1,122개에서 나온 자격증명

애플리케이션 보안 업체 Apiiro가 11월 5일 조사 결과를 공개했습니다. 11월 1일부터 사흘 동안 공개 깃허브를 훑어 Claude Code의 로컬 설정 파일 .claude/settings.local.json 사본을 104,185개 모았는데, 그 가운데 1,122개, 약 1.1%에서 진짜 자격증명이 나왔다는 겁니다. 서로 다른 값으로 세면 1,379개. 데이터베이스 비밀번호, API 토큰, SSH 로그인, AWS 키 같은 것들이었다고 해요.

설정 파일에 비밀번호가 왜 들어가 있나 싶으실 텐데요. 이 파일은 설정이라기보다 승인 기록에 가깝습니다. 에이전트가 명령 하나를 실행해도 되겠냐고 물을 때 "예, 다시 묻지 않기"를 고르면 그 허락이 여기에 적힙니다.

그런데 허락을 적어 두는 일이 생각보다 까다롭습니다.

운영 데이터베이스에 붙어서 느린 쿼리 하나만 확인해 달라고 시켰다고 해 보죠. 에이전트가 PGPASSWORD=... psql -h prod-db ... 를 실행하겠다고 묻습니다. 앞으로 열 번은 더 물어볼 게 뻔하니 다시 묻지 않기를 누릅니다. 이제 도구는 무엇을 허락받았는지 적어야 하는데, 적는 단위가 명령 문자열입니다. 공식 문서에 나오는 예가 npm test * 같은 모양이에요. 승인한 명령의 앞부분을 그대로 떼어 오고 뒤에 별표를 붙여 범위를 조금 넓히는 식이죠.

규칙이 보는 것은 그 명령이 무슨 일을 하느냐가 아니라 어떤 글자로 시작하느냐입니다. 그래서 허용 규칙은 명령의 의미가 아니라 명령의 표면을 보존하는데, 비밀번호는 하필 그 표면에 있습니다. 환경변수를 앞에 붙여 쓰는 관행이 특히 고약해요. PGPASSWORD= 는 명령의 맨 앞자리라 뒤쪽을 아무리 별표로 뭉개도 규칙 안에 남습니다.

별표로 줄여지지 않는 명령도 있습니다. 환경변수를 여럿 앞세웠거나 heredoc이 섞였거나 여러 줄짜리 스크립트인 경우인데요. 이럴 때 명령 전문이 통째로 한 항목이 되어 저장된다는 신고가 깃허브 이슈 두 건으로 올라와 있습니다. 한 신고자는 파일이 311개 항목 31KB까지 불어났고 그 안에 살아 있는 Stripe 키와 Supabase JWT가 들어 있었다고 적었어요. 설계된 동작이 아니라 버그로 분류된 이슈인데, 둘 다 답변 없이 봇이 닫았습니다.

그럼 규칙을 처음부터 넉넉하게 잡으면 될까요? 앞부분은 어차피 그대로 들어가니 큰 소용이 없고 허용 범위만 넓어집니다. 비밀번호를 명령줄에 글자로 넣지 않는 쪽이 둘 다 피하는 길이죠.

코드 편집기 화면에 깃 커밋 히스토리가 분기와 함께 그려져 있고, 왼쪽 파일 목록에 .gitignore가 보인다
코드 편집기 화면에 깃 커밋 히스토리가 분기와 함께 그려져 있고, 왼쪽 파일 목록에 .gitignore가 보인다

출처: Unsplash, Yancy Min

여기까지는 로컬 파일 이야기고, 문제는 이게 공개 저장소까지 간다는 쪽입니다. 파일 이름에 local이 붙어 있으니 막혀 있겠거니 싶지만, 두 군데가 비어 있어요. 공식 문서를 보면 Claude Code는 저장소가 이 파일을 아직 무시하고 있지 않을 때 한해, 자기가 거기 처음 쓰는 시점에 경로를 개발자의 전역 깃 제외 목록에 넣습니다. 사람이 손으로 먼저 만들어 둔 파일에는 해 주지 않고요. 전역이라는 말 그대로 그 노트북 한 대에만 남고 프로젝트를 따라가지 않죠. 동료도, CI도, 새로 받은 장비도 그 사실을 모릅니다. 그리고 한 번이라도 추적된 파일에는 깃의 무시 규칙이 아예 적용되지 않습니다. 누군가 예전에 한 번 커밋해 버렸다면 뒤늦게 저장소 .gitignore에 줄을 추가하는 건 장식에 가깝고요.

커밋한 사람이 누구인지도 들여다볼 만합니다. 추적 가능한 저장소 1,105곳 가운데 539곳에서, 이 파일을 바꾼 커밋이 Claude 공동작성 커밋이었다고 해요. 작업이 끝나고 "지금까지 한 거 커밋해 줘"라고 말하면 에이전트는 바뀐 것을 담습니다. 바뀐 것 안에는 조금 전 자기가 쓴 승인 기록도 들어 있고요. 프롬프트 인젝션도 아니고 침해도 아닙니다. 승인, 기록, 커밋, 푸시가 전부 정상 절차대로 이어진 결과입니다.

숫자를 받아들일 때 선은 그어 두는 게 좋겠습니다. 전부 Apiiro가 자체 집계한 값이고 독립적으로 재현된 것은 아니며, Apiiro는 이런 문제를 잡아 주는 제품을 파는 회사입니다. 노출된 키가 지금도 유효한지는 시험하지 않았고, 실제로 살아 있다고 확인된 사례는 한 기업 한 건뿐이에요.

그래도 분모가 10만 개라는 점은 남습니다. 게다가 이번 조사는 깃허브만 셌는데, 같은 파일은 다른 길로도 나갑니다. Check Point가 지난 4월에 npm 패키지 약 46,500개를 들여다보다 428개에서 이 파일을 찾아냈고, 그 가운데 설정 파일 33개, 패키지로 치면 30개에 자격증명이 들어 있었습니다. npm publish는 폴더에 있는 것을 별말 없이 싣고, 도커 빌드 컨텍스트나 CI 아티팩트도 사정이 다르지 않죠. 예측은 아니고 가정입니다만, 정작 더 많이 쌓여 있는 쪽은 비공개 저장소일 거라고 봅니다. 거기서는 아무도 세지 않고, 외주 인력에게 읽기 권한을 주거나 저장소를 공개로 돌리는 날까지 그대로 남아 있을 테니까요.

오늘 해 볼 수 있는 건 생각보다 간단합니다. 저장소에서 git log --all -- '.claude/settings.local.json' 을 한 번 돌려 보세요. 이력에 걸리는 게 있다면 파일을 지우는 것보다 그 자격증명을 폐기하는 일이 먼저입니다. 포크와 클론은 되돌릴 수 없으니까요. 그다음에 git rm --cached 로 추적에서 빼고, 전역 제외 목록이 아니라 저장소 자체 .gitignore에 경로를 넣습니다. 조직 차원에서는 시크릿 스캐너가 보는 범위를 한번 확인해 볼 만합니다. 애플리케이션 소스만 보고 있는지, 아니면 .claude/ 같은 에이전트 설정 디렉터리와 MCP 설정 파일, 저장된 대화 기록까지 보고 있는지요. 마지막으로 승인할 명령에 비밀번호를 리터럴로 넣지 않는 습관. 환경변수 참조나 시크릿 매니저를 거치면 애초에 적힐 것이 없습니다.

.env와 id_rsa가 어떤 파일인지 스캐너에게 가르치는 데 십 년 넘게 걸렸는데, 에이전트 도구들은 자격증명이 들어갈 자리를 도구마다 다른 이름으로, 릴리스마다 조금씩 바꿔 가며 만들고 있습니다. 다음엔 또 어디에 무엇이 적혀 있을까 싶네요.


커버 이미지: 에이전트의 명령 승인 프롬프트가 떠 있는 개발 환경 화면 — Unsplash, Bernd Dittrich

#에이전트 #보안 #시크릿관리 #깃 #개발도구