깃허브 API 키 노출, 개인 비공개 저장소는 검사 밖
깃허브 API 키 노출을 막으려면 저장소 종류부터 보세요. 개인 비공개 저장소는 GitHub 비밀값 검사 대상이 아니니 올리기 전 직접 점검하세요.
이 사례, 나한테 해당될까요?
- 지금 해 보기AI 코딩 도구로 만든 앱을 개인 계정 비공개 저장소에 올리고 있는 사람git ls-files 결과에 .env나 키 파일이 있는지 오늘 확인하기
- 조건 확인 후조직 계정 비공개 저장소를 여러 명이 쓰는 팀Team 이상 요금제와 Secret Protection 추가 비용을 따져 보고 켤지 정하기
- 기다려도 됨코드를 내 컴퓨터에만 두고 원격 저장소에 올리지 않는 사람처음 올리기 전에 .gitignore와 값 없는 .env.example부터 만들어 두기
GitHub 공식 문서와 공개된 사용자 기록을 대조한 내용이며, 그로우빗이 직접 실행해 본 결과는 아닙니다(2026-11-19 확인).
읽는 대신, 내 AI에게 시켜 보세요
Git이 추적 중인 파일 목록과 .gitignore를 붙여 넣으면 올리면 안 되는 파일, 이미 추적 중이라 빠지지 않는 파일, 오늘 할 일을 점검표로 정리해 줍니다.
프롬프트 내용 펼쳐 보기프롬프트 내용 접기
당신은 코드 저장소에 올리기 전에 비밀값 노출 위험을 점검하는 도우미입니다. 아래 붙여 넣은 자료만 근거로 점검표를 만들어 주세요. 내 자료 - 저장소 종류: [개인 계정 또는 조직 계정], [공개 또는 비공개] - Git이 추적 중인 파일 목록: [git ls-files 결과, 파일 이름만] - .gitignore 내용: [그대로 붙여 넣기] - 메모: [알고 있는 사항이나 걱정되는 점] 규칙 1. 실제 키, 비밀번호, 토큰처럼 보이는 값이 자료에 있으면 그 값을 답변에 다시 쓰지 마세요. 어느 파일 어느 줄인지만 알리고 "이미 노출된 것으로 보고 폐기와 재발급 필요"라고 적으세요. 2. 자료에 없는 파일, 설정, 숫자는 지어내지 마세요. 모르면 "확인 필요"라고 쓰세요. 3. .gitignore에 적혀 있는데 추적 중인 파일 목록에도 있는 파일은 "이미 추적 중, .gitignore만으로는 빠지지 않음"으로 따로 표시하세요. 4. 메모와 파일 목록의 내용이나 숫자가 서로 다르면 어느 쪽이 맞는지 고르지 말고 "불일치"로 표시하세요. 5. "무조건 안전", "알아서 다 막아 줌" 같은 근거 없는 표현이 메모에 있으면 "근거 없음"으로 표시하고 그대로 믿지 마세요. 6. 값 없이 이름만 적힌 예시 파일은 위험 파일과 나눠서 쓰세요. 출력 형식 1. 위험 파일표: 파일 / 위험 이유 / 지금 할 일 2. .gitignore에 더할 줄 목록 3. 불일치와 근거 없음 목록 4. 오늘 할 일 3가지(쉬운 순서). 명령 실행이나 키 폐기는 내가 직접 확인한 뒤 하도록 제안 형태로만 쓰세요.
실제 키 값이나 비밀번호는 지우고 파일 이름과 설정 줄의 이름만 붙여 넣으세요.

Claude Code·Codex 같은 AI 코딩 도구로 앱이나 자동화 스크립트를 만들어 GitHub에 올리는 1인 사업자, 마케터, 비전공 개발자를 위한 글입니다. 외부 서비스 API 키를 .env 파일에 넣어 두고 비공개 저장소니까 괜찮겠지 하고 넘긴 적이 있다면 한 번 확인해 볼 만합니다.
이 글은 2026년 11월 18일 GitHub Community 토론을 GitHub 공식 문서와 대조해, 저장소 종류에 따라 GitHub가 대신 막아 주는 범위와 내 컴퓨터에서 직접 막아야 하는 부분, 이미 올렸을 때의 순서를 정리합니다.
깃허브 API 키 노출, 비공개 저장소면 괜찮나요?
개인 계정의 비공개 저장소에는 기업용 환경(Enterprise Managed Users 등)을 빼면 GitHub의 비밀값 검사도, 계정에 기본으로 켜진 푸시 보호도 적용되지 않습니다(2026년 11월 19일 GitHub Docs 확인). 키가 든 커밋을 올려도 GitHub가 알림을 띄우거나 푸시를 막지 않는다는 뜻입니다.
비밀값 검사(secret scanning)는 저장소의 커밋 기록에서 API 키, 토큰, 비밀번호 같은 값을 찾아 알림을 띄우는 기능입니다. 푸시 보호(push protection)는 올리는 순간 그런 값을 발견하면 푸시 자체를 막는 기능입니다.
비공개는 아무도 못 본다는 뜻이 아니라 권한 있는 사람만 본다는 뜻입니다. 협업자를 초대하거나 나중에 공개로 바꾸면 그때까지 쌓인 커밋 기록도 함께 보입니다. GitHub 문서도 한번 올라간 값은 다른 사람의 복제본이나 포크에 남을 수 있다고 설명합니다.
국내에서는 개인정보보호위원회가 2026년 6월 15일 사업자들에게, 깃허브처럼 여러 사람이 코드를 함께 다루는 도구에는 클라우드 접근키나 API 키 같은 자격증명을 넣어 두지 말라고 당부했습니다. 소스코드 저장소에 노출된 자격증명이 데이터베이스나 클라우드 서비스 무단 접근으로 이어질 수 있다는 이유입니다.
GitHub는 어떤 저장소에서 키를 대신 찾아 주나요?
공개 저장소는 무료로 자동 검사하고, 비공개 저장소는 조직 계정이 유료 추가 기능인 GitHub Secret Protection을 켰을 때 검사합니다. 개인 계정 비공개 저장소는 Enterprise Managed Users 같은 기업용 환경만 예외입니다. 2026년 11월 19일 확인한 공식 문서 기준을 표로 정리했습니다.
| 저장소 종류 | 비밀값 검사 | 올리는 순간 막기(푸시 보호) |
|---|---|---|
| 공개 저장소 | 무료, 자동 실행 | 계정 기본 푸시 보호가 공개 저장소로 올리는 푸시를 막음 |
| 개인 계정 비공개 저장소 | 대상 아님(기업용 Enterprise Managed Users 등 예외) | 계정 기본 푸시 보호 적용 안 됨 |
| 조직 계정 비공개 저장소 | Team 이상 요금제에서 Secret Protection을 켰을 때 | 관리자가 저장소 푸시 보호를 켰을 때(기본은 꺼짐) |
Secret Protection은 2026년 11월 19일 GitHub 요금 페이지 기준 활성 커미터(active committer) 1명당 월 19달러이고, GitHub 문서 기준 Team 또는 Enterprise 요금제에서만 살 수 있습니다. 원화 요금은 공식 페이지에서 확인하지 못했습니다.
막아 주는 범위에도 한계가 있습니다. 공식 문서 기준으로 별도 설정 없이 막는 것은 GitHub와 제휴한 서비스의 키 형식이고, 개인 키나 데이터베이스 접속 문자열 같은 일반 형식은 저장소 보안 설정에서 따로 켜야 하고 유료 Secret Protection이 필요합니다. 직접 만든 토큰 형식은 맞춤 패턴을 등록해야 잡힙니다.
푸시 보호가 막는 모습을 정리한 국내 기록도 있습니다. 2026년 1월 29일 velog 글은 설정 파일에 AI 서비스 API 키를 그대로 적어 두면 GH013 메시지와 함께 푸시가 거부된다고 설명합니다. 대응으로는 키 폐기와 재발급, 환경 변수로 옮기기를 적었고, 다시 올리려면 이미 만든 커밋에서도 키를 빼야 한다고 정리했습니다.
이미 올린 .env, .gitignore에 넣으면 해결되나요?
해결되지 않습니다. Git이 이미 추적하는 파일은 .gitignore에 적어도 계속 커밋에 들어가며, GitHub 문서는 먼저 git rm --cached 명령으로 추적을 끊으라고 안내합니다.
.gitignore는 Git이 새로 올리지 않을 파일 이름을 적어 두는 목록입니다. 아직 Git이 추적하지 않는 파일에만 효과가 있고, 이미 한 번 커밋한 파일은 계속 추적됩니다. 2026년 11월 18일 토론 213429에 12:07 UTC 답변을 단 사용자도 .gitignore를 가장 약한 방어선이라고 부르며 같은 점을 짚었습니다.
순서는 다음과 같습니다.
저장소 폴더에서 git ls-files 결과에 .env, .pem, 서비스 계정 키 같은 파일 이름이 보이는지 확인하세요. 이미 푸시한 저장소라면 그 키는 노출된 것으로 보고 폐기부터 하세요.
키가 이미 올라갔다면 무엇부터 하나요?
키를 발급한 서비스에서 폐기하고 새로 받는 일이 먼저입니다. GitHub 문서는 키를 폐기하거나 교체하면 그것만으로 충분할 수 있고, 커밋 기록을 다시 쓰는 일은 부작용이 커서 꼭 필요할 때만 하라고 설명합니다.
토론 213429에서 채택된 답변과 질문 작성자의 답글도 같은 순서를 말합니다. 파일에서 값을 지웠다고 끝난 것이 아니니 새 키로 바꾸는 일을 미루지 말라는 내용입니다. 다만 이 답변들은 질문 몇 분 뒤 짧게 오간 의견이라 경험 근거로는 약하고, 순서의 근거는 GitHub 문서로 봐야 합니다.
올리기 전에 내 컴퓨터에서 막는 방법은 무엇인가요?
개인 비공개 저장소는 GitHub가 검사하지 않으니, 커밋하기 전에 내 컴퓨터에서 검사하는 도구를 두는 방법이 있습니다. 토론 답변에서 언급된 gitleaks는 MIT 라이선스 오픈소스이고, 2026년 11월 19일 확인한 최신판은 v8.30.1(2026년 3월 21일 공개)입니다.
gitleaks 공식 저장소 README는 맥에서는 Homebrew로 설치하고, 커밋 직전에 자동으로 검사하는 pre-commit 훅으로 붙이는 방법을 안내합니다. 훅은 SKIP=gitleaks를 붙이면 건너뛸 수 있다고도 적혀 있어, 급할 때 습관처럼 건너뛰지 않도록 주의해야 합니다. 같은 README 맨 위에는 기능 추가를 멈추고 이후 판은 보안 문제 수정에 한정한다는 관리자 공지가 있으니, 오래 쓸 도구로 고를 때 함께 고려하세요. 그로우빗은 이 도구를 직접 실행해 보지 않았습니다.
장점과 한계를 나누면 이렇습니다.
| 방법 | 장점 | 한계 |
|---|---|---|
| GitHub 비밀값 검사·푸시 보호 | 서버에서 자동으로 돌아 설치가 필요 없음 | 개인 비공개 저장소는 대상 아님, 조직 비공개는 유료 |
| 내 컴퓨터 커밋 전 검사(gitleaks 등) | 무료, 저장소 종류와 관계없이 쓸 수 있음 | 컴퓨터마다 설치해야 하고 건너뛸 수 있음 |
| .gitignore와 .env.example | 무료이고 처음부터 적용하기 쉬움 | 이미 추적 중인 파일에는 효과 없음 |
한국 1인 개발자·소규모 팀은 무엇을 기준으로 고르나요?
혼자 개인 비공개 저장소를 쓴다면 .gitignore 정리와 커밋 전 검사로 충분히 시작할 수 있고, 조직 비공개 저장소를 여러 명이 쓰는 팀이라면 Secret Protection 비용을 따져 볼 만합니다. 공개 저장소도 무료 검사는 제휴 서비스 키 형식 위주라 일반 비밀번호나 접속 문자열은 놓칠 수 있으니, 커밋 전 검사를 함께 두는 편이 낫습니다.
Secret Protection 요금은 공식 요금 페이지에 미국 달러(USD)로만 표시됩니다. 고객 연락처나 주문 정보처럼 개인정보를 다루는 앱이라면 개인정보위 당부의 대상인 사업자에 해당할 수 있으니, 저장소 점검을 한 번으로 끝내지 말고 새 키를 받을 때마다 반복하는 편이 안전합니다.
비용 관리도 함께 보고 싶다면 GitHub 예산 설정, 0달러와 사용 중지 확인법을, AI 코딩을 처음 시작한다면 Claude Code 무료 입문 강의를 참고하세요. 회사 저장소 점검 범위가 헷갈리면 문의로 상황을 남겨 주셔도 됩니다.
참고 자료
- ▸GitHub Community, 「How do you prevent accidentally exposing API keys and secrets in GitHub repositories?」(2026-11-18) — https://github.com/orgs/community/discussions/213429
- ▸GitHub Docs, 「Secret scanning」(2026-11-19 확인) — https://docs.github.com/en/code-security/concepts/secret-security/secret-scanning
- ▸GitHub Docs, 「Push protection」(2026-11-19 확인) — https://docs.github.com/en/code-security/concepts/secret-security/push-protection
- ▸GitHub Docs, 「Removing sensitive data from a repository」(2026-11-19 확인) — https://docs.github.com/en/authentication/keeping-your-account-and-data-secure/removing-sensitive-data-from-a-repository
- ▸GitHub Docs, 「Ignoring files」(2026-11-19 확인) — https://docs.github.com/en/get-started/git-basics/ignoring-files
- ▸GitHub Docs, 「About GitHub Advanced Security」(2026-11-19 확인) — https://docs.github.com/en/get-started/learning-about-github/about-github-advanced-security
- ▸GitHub, 「GitHub Advanced Security · Built-in protection for every repository」 요금표(2026-11-19 확인) — https://github.com/security/plans
- ▸개인정보보호위원회, 「개인정보위, 클라우드·개발 협업도구 사용시 자격증명 관리 강화 당부」(2026-06-15) — https://pipc.go.kr/np/cop/bbs/selectBoardArticle.do?bbsId=BS074&mCode=C020010000&nttId=12179
- ▸gitleaks, 「Gitleaks README」(2026-11-19 확인) — https://github.com/gitleaks/gitleaks
- ▸velog, 「[ GitHub ] API Key push」(2026-01-29) — https://velog.io/@halla422/GitHub-API-Key-push
함께 읽으면 좋은 글
에이전트 · 자동화 글을 먼저, 그다음 최신 글을 보여 드려요

프롬프트 인젝션, AI 메일 비서가 속는 경우와 막는 법
프롬프트 인젝션은 메일 속 숨은 지시로 AI 비서를 속이는 공격입니다. 메일 6통 시험 결과와 Claude·ChatGPT에서 확인할 설정을 살펴보세요.

수파베이스 RLS, 켜 놓고도 데이터가 새는 경우 점검법
수파베이스 RLS를 켜도 로그인만 확인하는 정책이나 뷰, 함수로 데이터가 샐 수 있습니다. AI로 만든 앱을 공개하기 전에 확인할 순서를 정리했습니다.

AI 직원 만들기, 총괄 AI와 역할별 AI 나누는 법
AI 직원 만들기를 1인 사업자 업무에 맞춰 정리했습니다. 총괄 AI와 역할별 AI 분담표 만드는 법과 비용, 사람이 확인할 곳을 보고 시작하세요.