Communitygithub.com

Git Leak Prevention

민감한 파일, 비밀키, 빌드 산출물이 GitHub에 푸시되는 것을 방지합니다. .gitignore를 스캔, 감지, 자동 수정합니다.

Git Leak Prevention란 무엇인가요?

이 스킬은 Git 저장소에서 민감한 파일과 비밀 정보가 GitHub에 노출되는 것을 방지하기 위한 AI 에이전트 기능입니다. 주로 TypeScript, React 기반 웹 개발 프로젝트에서 사용되며, .env, 비밀키, 빌드 산출물, 캐시 파일 등이 실수로 커밋되는 것을 사전에 차단합니다. 지원 플랫폼은 명시되지 않았으나 Git이 설치된 모든 환경(Windows, macOS, Linux)에서 사용 가능한 명령어 기반으로 동작합니다. 주요 기능으로는 1) 추적된 파일 중 민감한 패턴 검사, 2) 하드코딩된 비밀키 탐색, 3) .gitignore 자동 업데이트, 4) 이미 추적된 파일의 Git 추적 해제, 5) 보안 보고서 생성 등이 포함됩니다. 이 스킬을 통해 개발자는 실수로 인한 정보 유출을 방지하고, 보안 모범 사례를 자동으로 준수할 수 있습니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add bilals2008/bilal-skills

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

Git Leak Prevention은(는) 무엇을 하나요?

목적

민감한 파일, 비밀키, 빌드 산출물이 GitHub에 푸시되는 것을 방지합니다. .gitignore를 스캔, 감지, 자동 수정합니다.

지침

단계 1 — 민감한 파일 스캔

다음 명령어로 GitHub에 있어서는 안 되는 파일들을 찾습니다:

git ls-files | findstr /i ".env .env.local .env.production .env.staging node_modules dist build releases *.key *.pem *.p12 secrets"

PowerShell 사용 시:

git ls-files | Select-String -Pattern "\.env|node_modules|dist|build|releases|\.key$|\.pem$|\.p12$|secrets|\.log$|\.cache$"

또한 추적되지 않은 민감한 파일도 확인합니다:

git status --porcelain

단계 2 — 일반적인 민감 패턴 확인

추적된 파일에서 다음 패턴들을 찾습니다:

패턴위험조치
.env / .env.*API 키, DB 비밀번호Git에서 제거 + .gitignore에 추가
node_modules/의존성 (방대함, 필요 없음)제거 + .gitignore
dist/ / build/컴파일된 산출물제거 + .gitignore
releases/바이너리 릴리스제거 + .gitignore
*.key / *.pem개인 키제거 + .gitignore
*.p12 / *.pfx인증서제거 + .gitignore
.DS_StoremacOS 메타데이터.gitignore
Thumbs.dbWindows 메타데이터.gitignore
*.log로그 파일.gitignore
.cache/캐시 폴더.gitignore
coverage/테스트 커버리지.gitignore
.turbo/ / .next/빌드 캐시.gitignore
*.sql데이터베이스 덤프 (때로는 비밀 포함)내용 확인

단계 3 — 코드 내 비밀키 확인

추적된 파일에서 하드코딩된 비밀키를 검색합니다:

rg -i "(api[_-]?key|secret|password|token|private[_-]?key)\s*[:=]\s*['\x22]" --type-add 'code:*.{ts,tsx,js,jsx,json,yaml,yml,env,config}' -t code

다음 패턴들을 찾습니다:

  • API_KEY=sk-...
  • SECRET=...
  • PASSWORD=...
  • PRIVATE_KEY-----BEGIN
  • token: "eyJ..."

단계 4 — .gitignore 자동 수정

민감한 파일이 발견되면 자동으로 .gitignore를 업데이트합니다:

# 현재 .gitignore 확인
cat .gitignore

누락된 항목을 추가합니다. 웹 프로젝트용 표준 .gitignore:

# 환경 파일
.env
.env.local
.env.production
.env.staging
.env.development

# 의존성
node_modules/

# 빌드 산출물
dist/
build/
release/
releases/

# 비밀키
*.key
*.pem
*.p12
*.pfx

# IDE
.vscode/settings.json
.idea/

# OS
.DS_Store
Thumbs.db

# 로그
*.log
npm-debug.log*

# 캐시
.cache/
.turbo/
.next/
.nuxt/

# 커버리지
coverage/

# 기타
*.swp
*.swo

단계 5 — Git 추적에서 민감한 파일 제거 (이미 추적된 경우)

민감한 파일이 이미 추적 중인 경우:

# 추적에서 제거하되 로컬에는 유지
git rm --cached .env
git rm --cached -r node_modules/
git rm --cached -r dist/
git rm --cached -r build/

# 그런 다음 .gitignore에 추가

경고: 비밀키가 GitHub에 푸시된 경우, 이미 유출된 것입니다. 사용자는 다음을 수행해야 합니다:

  1. 노출된 모든 키/비밀을 즉시 교체
  2. 같은 비밀을 다시 사용하지 않음

단계 6 — 사용자에게 보고서 표시

발견 사항을 명확하게 제시합니다:

🔍 보안 스캔 보고서

위험에 처한 파일:
  ❌ .env — 추적됨 (비밀 포함)
  ❌ node_modules/ — 추적됨 (무시되어야 함)
  ⚠️ dist/ — 추적됨 (빌드 산출물)

수행된 조치:
  ✅ .env를 .gitignore에 추가
  ✅ node_modules/를 .gitignore에 추가
  ✅ dist/를 .gitignore에 추가
  ✅ .env를 Git 추적에서 제거 (로컬에 유지)

⚠️ .env에 실제 비밀이 있었다면 지금 교체하세요.
   GitHub 히스토리에는 이전 버전이 그대로 남아 있습니다.

단계 7 — 수정 사항 커밋

git add .gitignore
git commit -m "chore(security): update gitignore to prevent secret leaks"

하지 말아야 할 것

  • ❌ 보고서에 실제 비밀값을 절대 표시하지 않음 (가림: sk-****...****)
  • ❌ "임시"라도 .env나 비밀을 절대 커밋하지 않음
  • ❌ 비밀이 이미 푸시되었는데 경고를 무시하지 않음
  • ❌ git ls-files 확인을 건너뛰지 않음 — 추적되지 않은 파일은 괜찮지만, 추적된 파일이 위험

예상 출력

다음을 보여주는 깔끔한 보안 보고서:

  1. 무엇이 위험에 처했는지
  2. 무엇이 자동으로 수정되었는지
  3. 사용자가 수동으로 해야 할 일 (키 교체)

관련 스킬