배포 설정 변경을 검토하던 담당자가 API 키가 들어 있던 파일을 발견합니다. 팀은 삭제 커밋을 올렸고, GitHub 기본 브랜치의 파일 목록도 깨끗해 보입니다. 이때 운영 담당자가 확인할 화면은 저장소에 하나, API 키 발급처에 하나 더 있습니다. 저장소에서는 어느 커밋에 키가 남았는지, 발급처에서는 그 키로 아직 요청을 인증할 수 있는지 확인합니다.

배포 설정 파일이 원격 저장소에 올라간 상황을 설명용 업무 장면으로 삼았습니다. 여기서 API 키는 서비스 호출을 인증하는 비밀 값입니다. 키를 폐기한 뒤에는 배포나 예약 작업이 새 키로 정상 동작하는지, 과거 커밋과 다른 복사본을 어디까지 정리할지 판단해야 합니다.
삭제 커밋 뒤에도 남는 이전 스냅샷
Git의 커밋은 해당 시점에 추적하던 파일 상태를 스냅샷으로 기록합니다. 키가 담긴 설정 파일을 커밋한 다음 별도 커밋에서 지우면, 최신 스냅샷에는 파일이 빠지고 이전 스냅샷에는 당시 파일 내용이 남습니다. GitHub 기본 브랜치에서 파일을 검색한 결과는 현재 상태를 확인하는 데 쓸 수 있습니다. 이력의 노출 범위는 최초로 키를 넣은 커밋과 그 커밋을 포함하는 브랜치·태그를 확인해야 파악할 수 있습니다. 근거 · Pro Git
공개 저장소에 올렸다가 비공개로 전환한 경우에는 공개됐던 시간도 확인합니다. 팀 내부 저장소였다면 당시 읽기 권한이 있던 사람과 연동 앱, 복제본을 확인 범위에 넣습니다. 풀 리퀘스트(PR)는 변경 사항을 병합하기 전에 검토하는 단위입니다. PR의 변경 내역이나 댓글에 키가 복사됐거나, 빌드 과정이 설정 내용을 출력했다면 CI/CD 로그나 보관된 빌드 산출물에도 별도 사본이 있을 수 있습니다. 저장소에서 키가 발견된 경로를 따라 실제로 생성된 사본부터 확인합니다. 근거 · GitHub의 저장소 노출 경로
아직 원격 저장소로 푸시한 적 없는 커밋이라면 먼저 해당 커밋이 로컬에만 있었는지 확인합니다. 로컬 자동 백업이나 팀 공유 폴더에 복사되지 않았고 전송 기록도 없다면, 문제가 된 로컬 이력을 수정한 뒤 푸시할 범위를 다시 확인할 수 있습니다. 반대로 기본 브랜치에 병합된 기록이 없어도 원격 작업 브랜치로 푸시했다면 이미 공유된 커밋입니다. 키가 어디까지 전달됐는지 확인할 수 없는 경우에는 발급처에 해당 키의 상태를 확인하고 폐기를 우선 검토합니다.

노출 범위에 따른 키 폐기와 서비스 전환
키의 유효 여부는 발급처의 관리 화면이나 관리 API에서 확인합니다. 발급 계정과 키 ID, 적용 환경, 권한 범위, 마지막 사용 시각을 확인하면 어떤 서비스가 영향을 받을지 좁힐 수 있습니다. 키 원문은 티켓이나 메신저에 붙이지 않고, 발급처가 제공한 식별자와 노출된 파일 경로, 커밋 ID로 대상을 기록합니다. GitHub에서 탐지 상태를 제공하는 키 유형도 있지만, 발급처에서 확인한 상태를 폐기의 근거로 남깁니다. 근거 · GitHub의 비밀정보 노출 대응
공개된 운영 키이거나 의심 호출이 확인된 키라면 즉시 폐기를 우선합니다. 연동 장애가 예상된다면 서비스를 맡은 담당자와 복구 작업을 병행합니다. 노출이 제한된 환경에서 구 키와 새 키를 잠시 함께 사용할 수 있고 업무 중단의 영향이 크다면, 새 키를 발급해 사용하는 곳을 먼저 전환한 뒤 구 키를 폐기하는 순서도 검토할 수 있습니다. 이때 구 키가 살아 있는 시간에는 노출 위험이 이어지므로 폐기 시각과 담당자를 정해 두고, 조사 중 의심 호출이 확인되면 즉시 폐기로 전환합니다. 근거 · GitHub의 위험도별 대응
서비스 전환은 키를 저장하는 곳과 키를 읽어 쓰는 곳을 함께 봐야 합니다. 배포 파이프라인의 비밀 저장소에 새 값을 넣어도 이미 실행 중인 앱이 시작 시점의 값을 메모리에 보관하는 구조라면 앱의 재로딩이나 재배포가 필요할 수 있습니다. 운영 앱과 같은 키를 쓰는 예약 작업이나 배치 작업은 각 실행 환경에서 새 값을 읽는지 확인합니다. 외부 API 호출이 포함된 배포나 예약 실행 결과를 확인하면, 설정 변경만 완료하고 실제 호출은 다음 실행까지 실패하는 상황을 줄일 수 있습니다.
원격 이력 재작성과 복사본 정리의 범위
원격 저장소의 이력 재작성은 과거 커밋을 정리된 새 커밋으로 바꾸는 작업입니다. 폐기된 키만 들어 있었고 발급처에서 사용 불가 상태가 확인됐다면, 이력 재작성의 효과와 협업 중단 비용을 비교할 수 있습니다. 같은 파일에 다른 유효한 비밀이나 삭제가 필요한 민감정보가 함께 있었거나, 내부 규정상 이력 제거가 필요한 경우에는 재작성을 별도 작업으로 잡습니다. 작업 범위에는 해당 커밋을 참조하는 브랜치와 태그, 파일명이 바뀐 경로를 포함할지 검토합니다. 근거 · GitHub의 민감정보 제거 지침
이력을 다시 쓰면 변경된 커밋과 영향을 받은 후속 커밋의 식별값이 바뀝니다. 배포 기준이 특정 커밋 ID에 고정돼 있거나, 진행 중인 PR이 예전 이력을 바탕으로 만들어졌다면 작업 전에 영향을 확인합니다. 재작성 시점에는 팀이 기존 이력에 새 작업을 추가하지 않도록 조율하고, 작업 뒤에는 협업자가 기존 복제본을 정리하거나 새로 복제할 수 있게 안내합니다. 기존 복제본으로 푸시하면 예전 이력이 다시 들어올 수 있으므로, 정상적인 개발 흐름으로 복귀하는 조건도 작업 계획에 넣습니다. 근거 · GitHub의 이력 재작성 영향
GitHub에서 원격 브랜치를 교체한 뒤에도 이전 커밋을 가리키는 PR, 캐시된 화면, 포크와 각자 복제한 저장소가 남을 수 있습니다. 포크는 별도 저장소이므로 소유자와 정리를 조율하고, 외부 복사본에 접근할 수 없다면 확인 가능한 범위와 미확인 범위를 기록합니다. GitHub Support의 PR 참조·캐시 정리 지원은 자격 증명 교체로 위험을 줄일 수 없는 민감정보 등에 적용 조건이 있습니다. 공개 시점에 만들어진 복사본 전체의 삭제 여부는 확인이 어려우므로, 기존 키 폐기 시각과 관리 가능한 저장소의 정리 결과를 각각 기록합니다. 근거 · GitHub의 복제본 및 캐시 범위
키 폐기와 배포 복구를 확인하는 기록
조치 기록에는 어떤 화면을 확인했고 그 화면이 어떤 상태를 보여 줬는지 남깁니다. 키 폐기의 증거는 발급처가 보여 준 기존 키의 비활성 또는 삭제 상태입니다. 배포 복구는 새 키가 적용된 실행 환경에서 권한 있는 정상 작업이 성공한 기록으로 확인합니다. 다음 표는 개발·운영·보안 담당자가 한 티켓에서 넘겨받을 수 있는 기록 예시입니다.
| 확인 항목 | 기록할 근거 | 후속 판단 |
|---|---|---|
| 기존 키 사용 차단 | 발급처의 키 ID와 비활성·폐기 상태, 변경 시각 | 관리 화면에서 키가 여전히 활성 상태면 전환 성공 여부와 별개로 폐기를 완료합니다. |
| 서비스 복구 | 운영 앱과 파이프라인의 새 키 적용 기록, 실제 호출이 포함된 실행 결과 | 배포가 성공해도 예약 작업을 실행하지 않았다면 다음 실행 결과를 확인 항목으로 남깁니다. |
| 노출 중 사용 | 발급처 감사·호출 로그의 확인 기간, 키 식별자, 요청의 시각과 대상 | 평소에 없는 호출이나 권한 변경은 별도로 조사합니다. 조회 가능한 기간이 짧으면 확인 범위를 기록합니다. |
| 저장 이력과 사본 | 최초 노출 커밋, 관련 브랜치·태그·PR, 정리 여부와 미확인 복사본 | 이력을 다시 썼다면 대상 참조와 재검사 결과를 남깁니다. 재작성을 보류했다면 판단 근거와 남은 범위를 남깁니다. |
감사 로그는 가장 이른 것으로 확인한 노출 시점부터 폐기가 적용된 시점까지를 출발점으로 확인합니다. 발급처가 키별 식별자를 기록하면 해당 키로 들어온 요청을 조회하고, 키별 기록이 없다면 계정·프로젝트 단위에서 확인 가능한 작업 유형이나 호출량을 살핍니다. 정상 배치가 돌아가던 시간대와 호출 대상을 비교하면 조사할 항목을 고르기 쉽습니다. 로그의 보존 기간이나 수집 항목이 제한됐다면, 결과에는 확인할 수 있었던 기간과 필드를 함께 남깁니다. 근거 · GitHub의 비인가 접근 조사
재발 방지 변경도 같은 작업에서 확인할 수 있습니다. 실제 값은 팀의 비밀 저장소에 넣고, 저장소에는 필요한 변수 이름과 예시 설정을 둡니다. 로컬 설정 파일을 추적하지 않도록 규칙을 추가할 때는 기존에 추적하던 파일이 대상인지도 확인합니다. .gitignore는 추적 중인 파일에 적용되지 않습니다. GitHub 푸시 보호를 사용한다면 지원하는 키 패턴과 적용 범위를 확인해, 운영 환경에서 사용하는 키 유형을 어느 단계에서 검사하는지 기록합니다. 근거 · Git의 gitignore 문서 · GitHub의 푸시 보호 적용 범위

결론
원격 저장소에 키를 올린 사실을 확인하면 발급처에서 해당 키의 상태와 권한부터 확인합니다. 공개됐거나 의심 사용이 있는 키는 폐기를 우선하고, 교체가 필요한 서비스는 실제 호출까지 점검합니다. 이력을 다시 쓸지는 같은 커밋에 남은 민감정보, 관리 가능한 복사본, 협업과 배포에 미치는 영향을 보고 결정합니다.
조치 티켓을 닫을 때는 기존 키가 사용 불가로 바뀐 시각, 새 키로 성공한 작업, 로그 조회 범위, 이력과 복사본의 정리 결과를 확인합니다. 각각의 근거가 있으면 담당자가 바뀌어도 어디까지 처리했고 무엇을 이어서 확인할지 알 수 있습니다.