깃허브 API 키 숨기는 법, 이미 올렸다면 할 일
API 키를 깃허브에 올리지 않는 기본 설정과, 이미 올렸을 때 키 교체부터 기록 정리까지 순서대로 알려드려요. 내 레포에 키가 남았는지 확인하는 명령도 함께 정리했어요.
/ 4분 읽기
빠르게 만들다 보면 API 키가 깃허브에 같이 올라가는 일이 생겨요. 흔한 실수이고, 고치는 방법도 정해져 있어요. 이 글은 두 부분이에요. 처음부터 안 올리는 법, 그리고 이미 올렸을 때 할 일이에요.
API 키는 외부 서비스(OpenAI, 스트라이프, 수파베이스 등)가 "이 요청은 이 계정이 보낸 것"이라고 믿게 해 주는 문자열이에요. 비밀번호와 비슷하다고 생각하면 돼요.
키는 어떻게 생겼나
아래처럼 시작하는 문자열이 코드에 있으면 비밀키일 가능성이 높아요.
sk_live_: 스트라이프 실결제 키sk-: OpenAI 키,sk-ant-: Anthropic 키AKIA: AWS 접근 키ghp_: 깃허브 개인 토큰- 수파베이스
service_role키 : 긴 문자열이고, 모든 보안 규칙을 건너뛰는 키예요
처음부터 안 올리는 법
- 키는 코드에 직접 쓰지 말고
.env.local파일에 넣어요. .gitignore파일에 아래 두 줄이 있는지 봐요.
.env .env*.local
- 정말 무시되는지 확인해요.
git check-ignore -v .env.local
- 파일 이름과
.gitignore줄 번호가 나오면 깃이 이 파일을 무시하는 거예요. - 아무것도 안 나오면 아직 올라갈 수 있는 상태예요.
- 배포할 때는 Vercel 같은 호스팅의 환경변수 설정 화면에 키를 넣어요.
이미 올렸는지 확인하는 법
지금 코드에 남아 있는지:
git ls-files | grep -i "\.env" git grep -n -E "sk_live_|sk-ant-|AKIA|ghp_"
예전 커밋에 남아 있는지(지웠어도 기록에는 남아요):
git log --all --oneline -S "sk_live_"
- 결과가 없으면 그 글자가 들어간 커밋은 없는 거예요.
- 커밋 목록이 나오면 그 키는 과거 기록에 남아 있는 거예요. 지금 파일에서 지웠어도 저장소를 내려받은 사람은 볼 수 있어요.
이미 올렸다면, 이 순서로
핵심은 하나예요. 삭제보다 교체가 먼저예요. 파일에서 지워도 과거 기록과, 이미 누군가 복사해 간 사본은 그대로예요. 키를 새로 발급하면 예전 키는 쓸모가 없어져요.
- 키 교체(회전): 해당 서비스 대시보드에서 기존 키를 폐기하고 새 키를 발급해요. 회전은 "옛 키를 끄고 새 키로 바꾼다"는 뜻이에요.
- 새 키 반영:
.env.local과 호스팅 환경변수를 새 키로 바꾸고 다시 배포해요. - 코드에서 제거: 하드코딩된 키를 지우고 환경변수로 읽게 바꿔요.
- 사용 기록 확인: 서비스 대시보드에서 내가 모르는 사용량이나 결제가 있었는지 봐요.
- 기록 정리(선택):
git filter-repo같은 도구로 과거 커밋에서 지울 수 있어요. 다만 이미 교체했다면 꼭 하지 않아도 돼요. 공개 저장소였다면 정리해도 복사본은 남을 수 있어서, 교체가 진짜 해결책이에요.
다음 실수를 막는 설정
깃허브의 비밀 스캐닝과 푸시 보호를 켜 두면, 알려진 형태의 키가 올라가려 할 때 미리 막아 줘요. 공개 저장소는 무료로 켤 수 있고, 저장소 Settings의 보안 관련 메뉴에 있어요. 비공개 저장소에서는 유료 기능(GitHub Secret Protection)이에요. 출처: GitHub 공식 블로그 "Push protection is generally available, and free for all public repositories", GitHub Docs "About push protection".
한 번에 확인하고 싶다면
Trust 레포 검사는 로그인 후 내 레포를 연결하면 최신 코드 전체에서 비밀키를 찾아 파일과 줄 위치를 알려 줘요. 과거 커밋까지 보지는 않아요. 그래서 예전에 올린 적이 있다면 검사 결과와 상관없이 키를 교체하는 게 답이에요.
내 레포 무료 검사하기
무료로 검사해 보기 →