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_Store | macOS 메타데이터 | .gitignore |
Thumbs.db | Windows 메타데이터 | .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-----BEGINtoken: "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에 푸시된 경우, 이미 유출된 것입니다. 사용자는 다음을 수행해야 합니다:
- 노출된 모든 키/비밀을 즉시 교체
- 같은 비밀을 다시 사용하지 않음
단계 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확인을 건너뛰지 않음 — 추적되지 않은 파일은 괜찮지만, 추적된 파일이 위험
예상 출력
다음을 보여주는 깔끔한 보안 보고서:
- 무엇이 위험에 처했는지
- 무엇이 자동으로 수정되었는지
- 사용자가 수동으로 해야 할 일 (키 교체)