Copilot, Claude Code, Cursor, Devin, Codex 같은 코딩 에이전트는 이제 스스로 풀 리퀘스트를 엽니다. 여전히 사람이 이를 리뷰하며, 그 사람은 diff를 읽습니다. 로직, 테스트, 이름 짓기를 봅니다. 이 리뷰는 할 가치가 있지만, 공급망 위험의 대부분이 드러나는 곳은 아닙니다.
가장 큰 피해를 줄 수 있는 변경은 diff에 가장 잘 드러나지 않는 변경입니다. 매니페스트의 한 줄 수정으로 아무도 들어 보지 못한 패키지가 들어올 수 있습니다. 잠금 파일 변경은 수백 줄에 달하고 아무도 읽지 않습니다. 설치 스크립트는 diff에 아예 나타나지 않으며, 빌드 중에 다운로드되는 파일도 마찬가지입니다. 이 글에서는 팀이 에이전트의 풀 리퀘스트와 릴리스 사이에 둘 수 있는 점검과, 각 점검이 무엇을 잡아내는지 다룹니다.
공급망 위험을 찾기에 diff는 잘못된 곳입니다
코드 리뷰는 사람이 작성하고 설명할 수 있는 코드를 위해 만들어졌습니다. 에이전트가 작성자라면 왜 그 패키지를 골랐는지 설명해 줄 수 없고, 리뷰어는 컴파일되고 테스트를 통과하는 변경을 승인하고 싶어집니다. 다음 네 가지 변경은 지금 받는 것보다 더 많은 주의를 기울일 만합니다.
- 새로 추가되거나 바뀐 종속성. 매니페스트의 한 줄은 짧지만, 그것이 들여오는 것은 짧지 않습니다.
- 잠금 파일의 대량 변경. 수백 개의 확정된 버전과 해시로, 리뷰 UI에서는 보통 기본적으로 접혀 있습니다.
- 리포지토리에 들어 있는 것이 아니라 빌드가 하는 일. 설치 스크립트, 다운로드를 수행하는 빌드 스크립트, 베이스 이미지, 워크플로 단계 안의
curl입니다. - 워크플로 파일.
.github/workflows/를 변경하면 시크릿을 가지고 실행되는 것이 바뀝니다.
이 중 어느 것도 에이전트가 침해되어야만 일어나는 일이 아닙니다. 그럴듯한 코드를 쓰는 모델은 그럴듯한 패키지 이름도 쓰며, 공격자에게 필요한 것은 그럴듯한 이름뿐입니다.
새 종속성: 패키지가 실제로 존재하는지 확인하기
언어 모델은 때때로 존재하지 않는 패키지를 제안합니다. USENIX Security 2025에서 발표된 연구는 16개 모델로 576,000개의 코드 샘플을 생성했으며, 상용 모델이 제안한 패키지의 최소 5.2%, 오픈 소스 모델이 제안한 패키지의 21.7%가 존재하지 않았고, 지어낸 고유 이름이 205,474개였다는 사실을 발견했습니다. 이런 이름을 등록해 두고 기다리는 수법을 슬롭스쿼팅이라고 합니다. 오타 없는 타이포스쿼팅이며, 스스로 패키지를 설치하는 에이전트는 이를 알아챘을지도 모르는 사람을 빼 버립니다.
종속성을 추가하는 풀 리퀘스트를 병합하기 전에 다음을 확인하세요.
- 존재하며 의도한 패키지인지. 에이전트가 사용하려던 프로젝트와 이름을 한 글자씩 비교하세요.
- 얼마나 오래되었는지. 며칠 전에 게시된 패키지나 버전은 의심해 볼 만합니다. pnpm의
minimumReleaseAge설정은 전이적 종속성을 포함해, 게시된 지 정해진 시간(분)이 지나지 않은 버전을 거부합니다. - 누가 관리하는지. 연결된 소스 리포지토리, 릴리스 이력, 둘 이상의 메인테이너가 있다고 안전이 증명되지는 않지만, 이것들이 없다면 경고 신호입니다.
- 정말 필요했는지. 에이전트는 표준 라이브러리나 기존 종속성이 이미 하는 일을 위해 패키지를 추가합니다. 종속성을 줄이는 것이 가장 저렴한 통제 수단입니다.
GitHub의 dependency review action은 풀 리퀘스트에서 실행되어 종속성 변경을 나열하고, 알려진 취약점이나 허용되지 않은 라이선스가 있으면 검사를 실패시킬 수 있습니다. 하지만 어제 게시되어 권고가 없는 패키지는 알지 못하므로, 위의 점검을 대체하는 것이 아니라 보완합니다.
잠금 파일 변경: 읽고, 무엇이 빠지는지 알아 두기
잠금 파일은 패키지 관리자가 확정한 정확한 버전과 무결성 해시를 고정합니다. 에이전트의 풀 리퀘스트에서 잠금 파일은 무엇이 바뀌었는지 보여 주는 가장 정확한 기록이므로, 잘 보이게 하세요. 리뷰에서 펼쳐 보고, 잠금 파일과 매니페스트가 일치하지 않으면 빌드를 실패시키세요(npm ci, pnpm install --frozen-lockfile).
살펴볼 점은 두 가지입니다.
- 바뀐 소스. 내부 레지스트리에서 확정되던 패키지가 이제 공개 레지스트리에서 확정된다면, 이는 종속성 혼동의 배후에 있는 패턴입니다. 내부 패키지의 범위를 내부 레지스트리로 지정해 공개 레지스트리에는 아예 요청이 가지 않게 하세요.
- 전이적 종속성의 큰 변동. 작은 직접 종속성 업그레이드 하나가 수십 개의 전이적 패키지를 움직일 수 있습니다. 그것들은 아무도 고르지 않은 버전입니다.
그래도 잠금 파일은 패키지 관리자가 확정한 것만 기록합니다. 설치 스크립트가 무엇을 다운로드하는지, Rust 빌드 스크립트가 무엇을 가져오는지, Dockerfile이 어떤 베이스 이미지를 가져오는지, 워크플로 단계가 curl로 무엇을 가져오는지에 대해서는 아무것도 말해 주지 않습니다. 이것들은 숨은 종속성이며, 그래도 제품에 함께 실려 출시됩니다.
설치 스크립트는 누군가 리뷰하기 전에 실행됩니다
불편한 사실은 이렇습니다. CI는 풀 리퀘스트에 대해 실행됩니다. 에이전트의 브랜치가 빌드되는 순간 새 종속성이 설치되고, 그 preinstall 및 postinstall 스크립트가 작업이 접근할 수 있는 모든 것을 가지고 실행됩니다. 리뷰는 그다음입니다.
2025년 8월의 Nx 침해 사고는 이것이 어디로 이어지는지 보여 주었습니다. npm에 올라온 악성 Nx 버전에는 postinstall 스크립트가 들어 있었고, 메인테이너의 사후 분석에 따르면 이 스크립트는 Claude와 Gemini 같은 로컬 AI 도구를 이용해 머신에서 민감한 파일을 찾으려 했습니다.
범위를 좁히는 방법은 다음과 같습니다.
- 라이프사이클 스크립트를 기본적으로 실행하지 마세요. pnpm은 종속성 빌드 스크립트를 허용하기 전까지 리뷰되지 않은 것으로 취급합니다. npm에서는
--ignore-scripts로 끌 수 있습니다. - 에이전트의 풀 리퀘스트에서는 누군가 확인할 때까지 CI를 보류하세요. GitHub의 Copilot 클라우드 에이전트는 기본적으로 이렇게 합니다. 쓰기 권한이 있는 사용자가 실행을 승인할 때까지 워크플로가 트리거되지 않습니다.
- 풀 리퀘스트 작업에 시크릿을 두지 마세요. 테스트 작업에 게시용 토큰이 필요한 경우는 드뭅니다. GitHub Actions 시크릿: 유출 경로와 보호 방법을 참조하세요.
빌드가 가져온 것을 직전 릴리스와 비교하기
가장 강력한 게이트는 풀 리퀘스트를 전혀 보지 않습니다. 빌드가 한 일, 즉 작업이 실제로 어떤 패키지와 파일을 어디에서 가져왔는지를 봅니다. 빌드 시점 SBOM은 빌드가 실행되는 동안 이를 기록하므로, 잠금 파일에서 빠지는 숨은 종속성까지 포함합니다.
이를 직전 릴리스의 SBOM과 비교하면 질문이 구체적이 됩니다.
- 어떤 구성 요소가 새로 생겼고, 어떤 구성 요소의 버전이 바뀌었는가?
- 다른 소스에서 오기 시작한 패키지가 있는가?
- 빌드가 이전에 한 번도 접속하지 않은 호스트에서 무언가를 다운로드했는가?
새로운 것에는 이를 설명하는 한 줄이 풀 리퀘스트 설명에 있어야 합니다. 아무도 설명할 수 없는 구성 요소가 바로 멈춰야 할 지점입니다. CI에서 SBOM을 생성하는 방법은 GitHub Actions에서 SBOM을 생성하는 방법을 참조하세요.
워크플로 파일에는 별도의 담당자가 필요합니다
워크플로를 편집하는 에이전트는 토큰과 시크릿을 가지고 실행되는 것을 바꿀 수 있습니다. .github/workflows/를 별도의 리뷰어가 있는 보안상 민감한 코드로 다루세요. GitHub의 보안 사용 참조 문서는 이 디렉터리를 CODEOWNERS 아래에 두라고 권장합니다.
/.github/workflows/ @your-org/platform-security
이런 변경에서는 다음을 살펴보세요.
- 넓어진 권한. 새로 추가된
contents: write나id-token: write에는 이유가 있어야 합니다. GITHUB_TOKEN 권한을 참조하세요. - 새 트리거.
pull_request_target은 포크에서 온 풀 리퀘스트에서도 읽기 및 쓰기 토큰과 리포지토리의 시크릿을 가지고 실행됩니다. - 고정되지 않은 액션. 전체 커밋 SHA가 아니라 태그로 참조한 새 액션은 모르는 사이에 바뀔 수 있습니다.
- 새로운 곳의 시크릿. 이전에는 필요 없던 단계에 전달된 시크릿입니다.
빌드가 접근할 수 있는 범위 제한하기
위의 모든 점검은 놓칠 수 있습니다. 갓 나온 악성 패키지는 권고가 없고, 그럴듯한 이름을 가졌으며, diff도 깨끗합니다. 그것에 필요한 것은 네트워크 연결입니다. 2단계 페이로드를 가져오거나, 시크릿을 어딘가로 보내기 위해서입니다.
이그레스 정책은 빌드가 필요한 레지스트리와 호스트에만 접근하도록 허용하고 그 밖의 접근은 허용하지 않습니다. 공격을 미리 알고 있어야 하는 것이 아니므로, 새로운 공격이 파이프라인에서 처음 실행될 때도 작동합니다.
승인 경로에 사람을 남겨 두기
에이전트는 자신의 작업을 승인할 수 없어야 하며, 작업을 요청한 사람도 마찬가지입니다. GitHub의 Copilot 클라우드 에이전트는 풀 리퀘스트 생성을 요청한 사용자가 이를 승인하지 못하게 하며, 기존 브랜치 보호와 필수 검사도 그대로 적용됩니다.
기본 브랜치의 룰셋으로 모든 에이전트에 똑같이 적용하세요.
- 풀 리퀘스트를 필수로 하고 최소 한 건의 승인을 요구하세요.
- 코드 소유자의 리뷰를 필수로 하여 워크플로와 종속성 변경이 적절한 사람에게 전달되게 하세요.
- 새 커밋으로 diff가 바뀌면 기존 승인을 무효화하세요. 에이전트는 리뷰 후에도 계속 푸시하기 때문입니다.
- 상태 검사를 필수로 하세요. 위의 종속성 및 SBOM 점검도 포함합니다.
게이트를 더 앞으로 옮기는 도구도 있습니다. 예를 들어 AI CodeOps는 바로 그 버전에서 테스트 스위트가 통과하고, diff에 대한 AI 리뷰에서 문제가 없으며, 사람이 승인한 뒤에야 풀 리퀘스트를 엽니다.
병합뿐 아니라 릴리스에도 게이트를 두기
병합 게이트는 변경 하나를 봅니다. 릴리스 게이트는 직전 릴리스 이후 바뀐 모든 것을 보며, 여기에는 병합 당시에는 문제가 없었지만 이후 취약점이 발견된 종속성도 포함됩니다. 출시하기 전에 다음을 하세요.
- 릴리스의 구성 요소를 최신 권고와 대조해 다시 점검하고, 알려진 심각한 취약점과 알려진 악성 릴리스가 있으면 차단하세요.
- 직전 릴리스 이후 새로 추가된 모든 것의 라이선스를 확인하세요.
- 릴리스 빌드가 가져온 것의 기록을 보관해 나중에 "우리도 영향을 받았나?"라는 질문에 답할 수 있게 하세요. 우리도 영향을 받았을까? 새 CVE를 빌드 전반에서 평가하는 방법을 참조하세요.
CRACI의 역할
CRACI는 에이전트가 작성한 코드를 리뷰하지 않습니다. 새로운 악성 패키지를 탐지하지도 않으므로, 새 종속성은 위의 점검으로 검증하세요. CRACI가 다루는 것은 빌드입니다.
CRACI는 GitHub Actions 작업을 자체 러너에서 실행하며, GitHub 호스팅 러너보다 약 2배 빠릅니다. runs-on을 craci로 바꾸면 되고, 실행 내역은 여전히 GitHub에 표시됩니다. 각 작업이 실행되는 동안 CRACI는 CI 캐시에서 복원된 패키지와 npm 설치 훅이 다운로드한 코드 같은 숨은 종속성을 포함해, 작업이 실제로 가져온 모든 패키지를 기록합니다. 스캐너가 아니라 기록기입니다. 각 작업의 SBOM에는 CRACI가 볼 수 없었던 부분을 표시하는 완전성 상태가 있으며, CycloneDX 또는 SPDX로 내보낼 수 있어 풀 리퀘스트 빌드를 직전 릴리스와 비교할 수 있습니다. 내장 릴리스 비교 기능은 로드맵에 있습니다.
러너에서는 이그레스 정책이 작업이 접근할 수 있는 호스트를 결정합니다. 정책은 작업 시작 전에 검증되고, 실패 시 차단(fail closed)되며, 기본 거부로 설정할 수 있습니다. 따라서 에이전트의 풀 리퀘스트에 들어 있는 악성 종속성은, 아무도 그 공격을 본 적이 없더라도 빌드에 필요 없는 호스트에 접근할 수 없습니다. 정책 위반 시 알림이 발생합니다. 정책 게이트는 특정 CVE가 포함된 빌드를 비롯해 발견 사항에 따라 빌드를 차단할 수 있으며, 라이선스 정책 규칙으로 라이선스에 따라 빌드를 차단할 수도 있습니다. 릴리스 이후에도 CRACI는 모니터링하는 SBOM을 새 권고와 대조해 계속 재평가하며, 빌드 기록을 통해 어떤 빌드에 취약한 종속성이 포함되었는지 확인할 수 있습니다.
데모를 예약하고 여러분의 빌드 하나의 기록을 확인해 보세요.
