깃허브 API 키 숨기는 법, 이미 올렸다면 할 일

API 키를 깃허브에 올리지 않는 기본 설정과, 이미 올렸을 때 키 교체부터 기록 정리까지 순서대로 알려드려요. 내 레포에 키가 남았는지 확인하는 명령도 함께 정리했어요.

/ 4분 읽기

빠르게 만들다 보면 API 키가 깃허브에 같이 올라가는 일이 생겨요. 흔한 실수이고, 고치는 방법도 정해져 있어요. 이 글은 두 부분이에요. 처음부터 안 올리는 법, 그리고 이미 올렸을 때 할 일이에요.

API 키는 외부 서비스(OpenAI, 스트라이프, 수파베이스 등)가 "이 요청은 이 계정이 보낸 것"이라고 믿게 해 주는 문자열이에요. 비밀번호와 비슷하다고 생각하면 돼요.

키는 어떻게 생겼나

아래처럼 시작하는 문자열이 코드에 있으면 비밀키일 가능성이 높아요.

처음부터 안 올리는 법

  1. 키는 코드에 직접 쓰지 말고 .env.local 파일에 넣어요.
  2. .gitignore 파일에 아래 두 줄이 있는지 봐요.
.env
.env*.local
  1. 정말 무시되는지 확인해요.
git check-ignore -v .env.local
  1. 배포할 때는 Vercel 같은 호스팅의 환경변수 설정 화면에 키를 넣어요.

이미 올렸는지 확인하는 법

지금 코드에 남아 있는지:

git ls-files | grep -i "\.env"
git grep -n -E "sk_live_|sk-ant-|AKIA|ghp_"

예전 커밋에 남아 있는지(지웠어도 기록에는 남아요):

git log --all --oneline -S "sk_live_"

이미 올렸다면, 이 순서로

핵심은 하나예요. 삭제보다 교체가 먼저예요. 파일에서 지워도 과거 기록과, 이미 누군가 복사해 간 사본은 그대로예요. 키를 새로 발급하면 예전 키는 쓸모가 없어져요.

  1. 키 교체(회전): 해당 서비스 대시보드에서 기존 키를 폐기하고 새 키를 발급해요. 회전은 "옛 키를 끄고 새 키로 바꾼다"는 뜻이에요.
  2. 새 키 반영: .env.local과 호스팅 환경변수를 새 키로 바꾸고 다시 배포해요.
  3. 코드에서 제거: 하드코딩된 키를 지우고 환경변수로 읽게 바꿔요.
  4. 사용 기록 확인: 서비스 대시보드에서 내가 모르는 사용량이나 결제가 있었는지 봐요.
  5. 기록 정리(선택): 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 레포 검사는 로그인 후 내 레포를 연결하면 최신 코드 전체에서 비밀키를 찾아 파일과 줄 위치를 알려 줘요. 과거 커밋까지 보지는 않아요. 그래서 예전에 올린 적이 있다면 검사 결과와 상관없이 키를 교체하는 게 답이에요.

내 레포 무료 검사하기

무료로 검사해 보기 →