21강. 보안: .env, API Key, 비밀 정보 유출 대응

?1. 이번 강의에서 해결할 문제

API 키를 삭제하는 새 커밋만 만들어도 과거 커밋과 원격 복제본에는 값이 남습니다. 예방 규칙과 실제 유출 시 대응 우선순위를 익힙니다.

✓2. 학습 목표

✓이 강의를 마치면

• 실제 비밀과 공유 가능한 환경 변수 예시를 분리합니다.
• 커밋 전 staged diff에서 비밀을 점검합니다.
• 유출 시 키 폐기부터 이력 정리까지 순서대로 대응합니다.

◇3. 핵심 개념

비밀은 저장소가 아니라 로컬 .env, OS 자격 증명 저장소, GitHub Actions Secrets 같은 전용 저장소에 둡니다. 공개 저장소에서 삭제 커밋은 유출 해결이 아닙니다. 가장 먼저 제공자 콘솔에서 키를 폐기·회전해 악용 가능성을 제거해야 합니다.

§4. 단계별 명령어와 예시

파일 경로: C:\dev\git-learning-site\.env.example 및 .gitignore

PowerShell

Set-Location C:\dev\git-learning-site
Add-Content .gitignore ".env"
"API_BASE_URL=https://api.example.com`nAPI_KEY=replace-me" | Set-Content -Encoding utf8 .env.example
git check-ignore -v .env
git status --short
git add .gitignore .env.example
git diff --staged
git commit -m "security: document environment variables safely"

유출을 발견했을 때 순서:

1. 해당 API 제공자에서 키를 즉시 폐기하고 새 키를 발급합니다.
2. 노출 범위, 시간, 사용 로그를 확인하고 관계자에게 알립니다.
3. .gitignore와 비밀 저장 방식을 고칩니다.
4. 과거 이력 정리가 필요한지 GitHub 공식 “Removing sensitive data” 절차와 저장소 관리자 정책을 확인합니다.
5. 이력 재작성은 모든 커밋 ID와 복제본에 영향을 주므로 백업·협업자 공지 후 진행합니다.

→5. 명령어가 동작하는 이유

.env.example은 변수 이름과 형식만 공유합니다. staged diff 검토는 push 전에 비밀이 커밋 스냅샷으로 들어가는 것을 막습니다. 키 폐기는 이미 복제되거나 캐시된 값도 더 이상 인증에 쓰이지 못하게 하는 유일한 즉시 조치입니다.

!6. 자주 하는 실수와 안전한 해결법

!자주 하는 실수

• 유출 커밋만 삭제: 키는 이미 복사됐을 수 있습니다. 먼저 폐기·교체합니다.
• 토큰을 채팅이나 Issue에 붙여 넣음: 공개 범위를 넓힙니다. 비밀 관리 채널을 사용합니다.
• 성급한 force push로 이력 정리: 협업자 브랜치와 태그를 망가뜨릴 수 있습니다. 공식 절차, 백업, 공지를 먼저 준비합니다.

✎7. 직접 실습

✎직접 실습

1. 가짜 키만 넣은 .env와 .env.example을 만듭니다.
2. .env는 무시되고 예시 파일만 stage되는지 확인합니다.
3. “폐기 → 조사 → 예방 수정 → 필요 시 이력 정리” 대응 체크리스트를 SECURITY.md에 작성합니다.

?8. 이해 점검 질문 3개

?이해 점검

1. 실제 API 키가 유출됐을 때 가장 먼저 할 일은 무엇인가요?
2. 삭제 커밋만으로 유출이 해결되지 않는 이유는 무엇인가요?
3. .env.example에는 어떤 값까지 넣어야 하나요?

■9. 핵심 요약

■핵심 요약

비밀은 처음부터 Git 밖에 두고 stage 내용을 확인합니다. 유출 시에는 이력 정리보다 키 폐기와 교체가 먼저이며, 과거 이력 재작성은 영향 범위를 관리한 뒤 수행합니다.