GitHub API 키 유출 탐지 새 AI 모델: 푸시 차단 적용 범위와 비용

내 저장소에 필요한 보호를 빠르게 판단하기

아래는 본문의 공식 조건을 실제 작업으로 연결한 편집부 판단표입니다. 계정에서 확인한 결과가 아니므로 자신의 환경에서 조건과 증거를 기록하세요.

이 글의 실무 점검표 CSV 다운로드 — 설정·기대값·실제 결과·증거·후속 작업을 따로 기록하는 빈 양식입니다. 제품 지원 상태나 시험 성공을 증명하는 자료는 아닙니다.

GitHub 새 AI 모델은 무엇을 탐지하나요?

GitHub는 Microsoft Applied Sciences와 함께 만든 ModernBERT 기반 분류기를 소개했습니다. 인식 가능한 접두사가 있는 토큰은 패턴으로 찾기 쉽지만, 내부 서비스의 비밀번호는 문자열만 보고 판단하기 어렵습니다. 새 모델은 후보 값과 주변 코드의 관계를 함께 평가합니다. 답변이나 코드를 생성하는 챗봇과는 역할이 다릅니다.

공식 설명에는 데이터베이스 연결 URL, Kubernetes Secret manifest, Dockerfile 안의 비밀번호 같은 값과 changeme 같은 자리표시자를 구분하는 예시가 등장합니다. 따라서 “API 키 유출 탐지 강화”는 기존 공급자 토큰 탐지에 문맥 기반 자격증명 판단을 보완하는 변화로 이해하는 편이 정확합니다.

GitHub가 제시한 후보 묶음 평가 시간은 2밀리초 미만입니다. 이는 모델 평가 단계의 수치이며 네트워크와 다른 검사를 포함한 전체 git push 지연 시간이 아닙니다. 예방 가능한 비밀정보 수를 두 배 이상 늘릴 가능성도 회사의 설명이며, 모든 유출을 차단한다는 보장은 아닙니다. 근거: GitHub의 모델·성능 설명

AI 탐지 알림·푸시 차단·Copilot 리뷰 적용 범위

GHSP는 GitHub Secret Protection, GHAS는 GitHub Advanced Security입니다. github.com에서는 공개·비공개·internal 저장소도 AI 푸시 차단 대상이 될 수 있습니다. 데이터 레지던시를 사용하는 ghe.com의 AI 푸시 차단은 계획 단계입니다. Copilot 구독만으로 AI 푸시 차단 자격을 얻지는 않습니다.

새 검사는 옵트인 방식입니다. /security-review 실행 자체가 새 분류기 검사를 켜지는 않습니다. AI Credits 과금은 공개 미리보기 참여와 기능 활성화 이후 시작하는 것으로 안내됐습니다. 차단되지 않은 검사도 크레딧을 사용할 수 있으므로 도입 전에 예산을 확인하세요. 근거: 제공 범위·라이선스·과금 공식 변경 기록

공개 저장소 무료 푸시 보호와 무엇이 다른가요?

기존 푸시 보호는 지원하는 비밀정보를 저장소에 보내기 전에 막는 기능입니다. 공개 저장소의 푸시 보호는 무료로 제공되어 왔습니다. 공개 저장소 무료 제공 발표와 이번 AI 기능의 유료 적용 조건을 따로 확인해야 합니다.

일반 푸시 보호는 명령줄 push뿐 아니라 GitHub 웹 UI의 커밋·파일 업로드와 REST API 요청 등도 검사합니다. 저장소 보호를 우회하면 알림과 감사 기록을 남길 수 있으며, 관리자는 우회 승인 담당자를 제한할 수 있습니다. 이 설명은 일반 푸시 보호의 동작입니다. 새 AI 미리보기가 모든 입력 경로에서 같은 범위를 보장한다고 확대 해석하면 안 됩니다. 근거: 푸시 보호 유형·입력 경로·우회 문서

개발팀이 AI 푸시 차단 도입 전에 점검할 다섯 가지

다음은 발표 내용을 실제 도입 판단으로 연결하기 위한 편집부 점검 제안입니다. 특정 계정의 미리보기 접근이나 청구액을 확인한 결과는 아닙니다.

1. 서비스 환경: github.com, 데이터 레지던시 환경, 자체 운영 Server 중 어디인지 기록합니다. 같은 Enterprise라는 이름이어도 제공 상태가 다릅니다.
2. 라이선스와 접근: 조직의 보안 상품 구매 상태와 미리보기 초대를 확인합니다. 옵션이 보이지 않으면 관리자에게 접근 조건을 먼저 확인합니다.
3. 현재 보호 설정: 사용자 보호와 저장소 보호가 켜져 있는지 각각 확인합니다. 이미 사용하는 패턴 기반 보호를 기본 방어선으로 유지합니다.
4. 예산과 우회 정책: 비용 담당자와 검사 예산, 우회 승인 책임자를 정합니다. 차단 횟수만으로 검사 비용을 추정하지 않습니다.
5. 검증 기록: 제공되는 공식 테스트 방법이나 통제된 테스트 환경에서 결과를 기록합니다. 실제 운영 키를 공개 저장소에 올려 시험하지 않습니다.

검증표에는 날짜, 저장소 공개 범위, 활성화한 보호 종류, 검사 결과, 우회 여부, 담당자를 남기세요. 무작위 가짜 문자열이 통과했다고 기능이 꺼져 있다고 단정하거나, 한 번 차단됐다고 모든 자격증명을 보호한다고 판단하지 않는 것이 좋습니다.

API 키를 이미 GitHub에 올렸다면 대응 순서

파일에서 키를 지운 새 커밋만으로 유출이 해결되지는 않습니다. GitHub는 노출된 비밀정보를 침해된 것으로 간주하고 발급처에서 폐기할 것을 안내합니다. 저장소를 삭제하거나 비공개로 바꾸는 일도 기존 키의 사용 권한을 없애지는 못합니다.

1. 노출 대상 파악: 발급 서비스, 소유자, 권한, 운영 환경과 노출 시점을 확인합니다. 조사 문서에는 실제 키 대신 식별 가능한 마스킹 정보를 남깁니다.
2. 발급처에서 폐기·교체: 활성 운영 키나 공개 노출은 신속히 처리합니다. 서비스 중단 위험이 있다면 새 키를 배포하고 이전 키를 폐기하는 순서를 담당자와 조율합니다.
3. 사용처 수정: 애플리케이션·CI의 비밀정보 저장소를 새 값으로 갱신합니다. 소스에 키를 다시 적지 말고 환경 변수나 비밀정보 관리 수단으로 주입합니다.
4. 노출 흔적과 영향 조사: 커밋 기록과 복사본을 점검하고 발급 서비스의 사용 기록을 확인합니다. 키 폐기와 이력 정리를 별도 작업으로 관리합니다.
5. 재발 방지: 보호 설정과 우회 사유를 검토하고 해결 내용을 기록합니다.

공개 저장소에서 탐지된 일부 공급자 토큰은 발급처에 자동 통보되지만, 모든 키가 자동 폐기된다고 가정하면 안 됩니다. 직접 발급처에서 상태를 확인하세요. 근거: GitHub의 유출 비밀정보 대응 절차

자주 묻는 질문

AI 탐지에서 비밀정보가 나오지 않으면 안전한가요?

탐지 결과와 안전성 판단은 구분해야 합니다. 어떤 보호를 켰는지, 대상 저장소와 검사 범위가 무엇인지 확인하고 키를 소스에 저장하지 않는 개발 방식도 함께 적용하세요.

푸시가 차단되면 바로 우회해도 되나요?

먼저 해당 값이 실제 자격증명인지 확인하세요. 실제 키라면 제거하고, 이미 노출됐다면 발급처에서 폐기합니다. 오탐이나 테스트 값은 조직의 우회 승인 정책에 따라 근거를 남깁니다.

AI 에이전트가 만든 PR에도 도움이 되나요?

에이전트가 생성한 코드도 사람이 작성한 코드처럼 검사해야 합니다. 비밀정보 검사는 기능 테스트와 목적이 다르므로 함께 운영하세요. GitHub Actions PR 검증 가이드에서 lint·테스트·빌드와 권한 경계를 확인할 수 있습니다.

다음에 다시 확인할 변경 사항

이 글의 기능 상태 확인일은 2026년 10월 9일입니다. AI 푸시 차단의 공개 미리보기 전환, 새 Copilot 검사 제공, Enterprise Server 3.23 출시와 실제 크레딧 과금 조건이 바뀌면 공식 변경 기록을 다시 확인해야 합니다. 모델 설명과 적용 범위를 분리해 읽으면 이후 업데이트에서도 자신의 저장소에 필요한 조건을 판단하기 쉽습니다.