본문으로 건너뛰기

비밀정보 후보를 점검해 로컬 프로젝트를 비공개 저장소로 옮긴 방법

강진태

2026.08.17

한줄 요약: 폴더 전체를 바로 올리지 않고 discovery → 최소 ignore → staged payload scan → private push → visibility/SHA read-back 순서로 진행해, 실제 전송 대상과 원격 결과를 끝까지 검증했다.


바쁘시면 이것만 보세요

  • 저장소를 만들기 전에 소스 루트, 기존 Git 상태, 중첩 저장소, 생성물과 자격증명 후보를 먼저 조사했다.

  • .gitignore는 흔한 항목을 무작정 늘리지 않고, 조사에서 발견한 재생성 가능 파일과 비밀정보 후보만 최소한으로 제외했다.

  • 비밀정보 검사는 작업 폴더 전체가 아니라 git add 뒤의 staged payload, 즉 실제 커밋·전송될 파일 목록을 기준으로 했다.

  • 스캐너가 잡은 문자열은 곧바로 비밀정보로 단정하지 않고, 값을 노출하지 않은 채 문맥을 확인해 오탐과 실제 위험을 분리했다.

  • 사용자 승인 뒤에만 비공개 원격 저장소를 만들고 푸시했다.

  • 마지막에는 명령 성공 문구가 아니라 원격의 PRIVATE 상태, 기본 브랜치, 로컬·원격 SHA 일치, 금지 경로 부재, origin을 다시 읽어 완료를 판정했다.


문제

로컬 프로젝트를 비공개 Git 저장소로 옮기는 일은 git add .과 git push 두 줄로 끝낼 수 있어 보인다. 하지만 폴더 안에는 소스 코드만 있는 것이 아니다. 가상환경, 캐시, 빌드 결과, 로그, 자격증명처럼 보이는 파일, 다른 저장소의 .git 메타데이터가 함께 있을 수 있다.

더 큰 문제는 “비공개 저장소니까 괜찮다”는 착각이었다. 비공개 여부는 접근 범위를 줄여 줄 뿐, 비밀정보를 커밋해도 된다는 뜻은 아니다. 한 번 Git 이력에 들어간 값은 나중에 파일만 지워도 과거 커밋에 남을 수 있다.

그래서 목표를 “폴더를 업로드한다”가 아니라 다음과 같이 바꿨다.

올려도 되는 payload를 먼저 확정하고, 승인된 비공개 저장소에 전송한 뒤, 원격 상태까지 다시 읽어 증명한다.

이 사례는 기존의 제품 개발, 권한 진단, 에이전트 역할 분리 사례와 달리, 로컬 소스 공개 경계와 Git 전송 완료 조건에만 초점을 맞췄다.


설계

전체 흐름을 다섯 단계로 고정했다.

1. discovery
   ↓
2. 최소 ignore
   ↓
3. staged payload scan
   ↓
4. 사용자 승인 후 private push
   ↓
5. visibility / SHA / exclusions / origin read-back

각 단계에는 다음 단계로 넘어가기 위한 게이트를 뒀다.

| 단계 | 확인할 것 | 통과하지 못하면 | |---|---|---| | discovery | 정확한 소스 루트, 기존 Git·remote, 중첩 .git, 생성물, 큰 파일, 자격증명 후보 | 초기화하지 않음 | | 최소 ignore | 조사에서 확인한 제외 대상이 추적되지 않는지 | ignore 수정 후 다시 stage | | staged payload scan | 실제 staged 경로·용량·금지 이름·비밀 문자열 후보 | commit·push 중단 | | private push | 현재 사용자 승인, 대상 저장소, 비공개 가시성 | 외부 쓰기 금지 | | read-back | PRIVATE, 기본 브랜치, SHA 일치, 금지 경로 부재, 올바른 origin | 완료로 보고하지 않음 |

핵심은 검사의 기준을 “로컬 폴더”에서 “실제로 전송될 payload”로 옮긴 것이다. 작업 폴더 전체를 검사하면 무시된 캐시나 로컬 전용 파일 때문에 잡음이 커지고, 반대로 staged 목록을 보지 않으면 예상하지 못한 파일이 전송 대상에 들어간 사실을 놓칠 수 있다.


구현

1. 저장소를 만들기 전에 discovery부터 했다

먼저 각 프로젝트의 정확한 루트와 최상위 구성을 확인했다. 이어서 이미 Git 저장소인지, 기존 origin이 있는지, 내부에 별도 .git이 중첩돼 있는지 조사했다. 전체 용량과 파일 수, 원격 제한을 넘을 수 있는 큰 파일도 확인했지만 공개 글에는 그 값을 남기지 않았다.

추가로 다음 후보를 찾았다.

  • 가상환경과 패키지 캐시

  • 언어·테스트 도구의 캐시

  • 빌드·배포 산출물

  • 로그와 임시 파일

  • .env, 토큰, 키, 인증서, credential 계열 파일명

  • 중첩된 저장소 메타데이터

이 조사 전에는 git init, commit, 원격 저장소 생성을 하지 않았다. 잘못된 루트에서 시작하면 나중에 ignore를 고치는 것보다 복구 비용이 훨씬 크기 때문이다.

2. 조사 결과만 반영한 최소 .gitignore를 만들었다

범용 템플릿을 길게 복사하는 대신 실제로 발견된 재생성 가능 항목과 비밀정보 후보를 제외했다. 대략적인 정책은 다음과 같았다.

.venv/
**/.venv/
__pycache__/
**/__pycache__/
*.log
.env
.env.*
!.env.example
*credentials*.json
*client_secret*.json
*service_account*.json
*token*.json
*.pem
*.key
build/
**/build/
dist/
**/dist/

프로젝트 안에 다른 도구나 외부 체크아웃의 Git 메타데이터가 중첩된 경우도 전송 대상에서 제외했다. 반대로 “크다”거나 “비공개 자료다”라는 이유만으로 필요한 소스와 근거 산출물을 임의 삭제하지 않았다. 제외 기준은 비밀정보, 재생성 가능 파일, 부적절한 중첩 메타데이터, 원격 제한 위반으로 좁혔다.

3. stage한 뒤 실제 payload를 스캔했다

git add 후 staged 파일 목록을 다시 뽑았다. 여기서 경로 수와 총 크기, 개별 대용량 파일, 금지 경로·파일명 패턴을 검사했다. 텍스트로 읽을 수 있는 staged 파일에는 고신뢰 비밀정보 패턴 스캔도 적용했다.

stage
→ staged path inventory
→ prohibited-name/path check
→ large-file check
→ text secret-signature scan
→ hit classification
→ commit 여부 결정

스캔 결과는 “합격/불합격” 버튼이 아니라 검토 대기열로 취급했다. 후보가 나오면 실제 문자열을 출력하지 않고 파일 위치와 패턴 종류만 확인했다. 필요한 경우 ignore를 보완하고 다시 stage한 뒤 같은 검사를 반복했다.

4. 외부 쓰기는 승인 뒤에만 실행했다

로컬 조사, ignore 작성, staging, payload 검사는 원격 상태를 바꾸지 않는다. 반면 원격 저장소 생성과 push는 외부 쓰기다. 그래서 대상과 비공개 가시성, 제외 범위를 정리해 사용자 승인을 받은 뒤에만 다음 단계로 갔다.

각 프로젝트는 commit → private repository create → push 순서로 직렬 처리했다. 여러 원격 저장소를 먼저 만들어 놓지 않은 이유는 중간 실패가 났을 때 어느 로컬 커밋과 어느 원격 상태가 대응하는지 흐려지는 것을 막기 위해서다.

5. 성공 메시지 대신 원격을 다시 읽었다

push가 끝난 뒤에는 로컬 명령의 종료 코드만 믿지 않았다. 원격 API와 Git 상태를 다시 조회해 다음 조건을 모두 확인했다.

visibility == PRIVATE
isPrivate == true
default branch == main
local HEAD == remote branch SHA
prohibited paths absent from committed tree
tracked working tree clean
origin == intended remote

전체 해시와 저장소 주소는 공개 초안에 적지 않았다. 중요한 것은 값 자체가 아니라 로컬과 원격이 동일하다는 판정이다.


실패와 수정

처음 비밀정보 패턴 스캔에서는 후보가 여러 건 나왔다. 그대로 해석하면 commit을 중단해야 했지만, 문맥을 확인해 보니 일부는 검증 문서의 해시 표기나 일반 URL 조각처럼 비밀정보가 아닌 문자열이었다. 단순 정규식이 짧은 접두 패턴을 넓게 잡아 생긴 오탐이었다.

여기서 두 가지를 수정했다.

  1. 스캐너 실패를 통과로 간주하지 않았다. 스크립트가 오류로 끝나거나 후보가 미분류 상태면 commit하지 않았다.

  2. 후보 값을 공개하지 않고 분류했다. 파일 위치와 패턴 종류만 사용해 실제 비밀정보, 안전한 예시, 일반 문장·URL, 해시 표기를 구분했다.

정상 파일을 통째로 삭제해 숫자를 0으로 만드는 대신, 위험 패턴은 제외하고 오탐은 근거를 남겨 해제했다. 이 수정 뒤에 staged payload를 다시 검사해 금지 파일과 고신뢰 비밀정보가 전송 대상에 없음을 확인했다.


검증

완료 판정은 로컬과 원격 양쪽의 영수증을 묶어서 내렸다.

| 검증 항목 | 판정 | |---|---| | 원격 가시성 | 각 대상 저장소가 PRIVATE임을 read-back | | 비공개 플래그 | isPrivate == true 확인 | | 기본 브랜치 | 의도한 main 확인 | | 커밋 동일성 | 로컬 HEAD와 원격 브랜치 SHA 일치 | | 제외 정책 | 가상환경, 캐시, 빌드, 로그, 자격증명·토큰·비밀키 후보가 커밋 트리에 없음 | | 작업 트리 | commit 후 추적 대상이 깨끗함 | | 원격 연결 | origin이 승인한 대상에 연결됨 |

이 검증은 “저장소가 존재한다”보다 강하지만, 코드 품질이나 프로젝트 내용의 정확성까지 증명하지는 않는다. SHA 일치는 전송된 이력이 로컬 커밋과 같다는 뜻이지, 그 내용이 완벽하다는 뜻은 아니다.


결과와 한계

결과적으로 확인한 금지 파일과 고신뢰 비밀정보 패턴 후보, 재생성 가능 산출물을 전송 대상에서 제외한 뒤 승인된 비공개 저장소에 저장했다. 각 원격은 비공개 가시성, 의도한 기본 브랜치, 로컬·원격 SHA 일치, 금지 파일 부재, 올바른 origin까지 확인했다.

Before와 After를 정리하면 이렇다.

| Before | After | |---|---| | 폴더 전체가 전송 후보 | staged payload가 전송의 단일 기준 | | 범용 ignore를 추측해 적용 | discovery에서 확인한 최소 ignore 적용 | | 문자열 후보를 곧바로 유출로 판단 | 값을 노출하지 않고 후보별 문맥 분류 | | push 성공 문구로 완료 판단 | visibility와 SHA를 원격에서 read-back | | 비공개면 안전하다고 가정 | 비공개 여부와 비밀정보 제외를 별도 검증 |

한계도 남는다.

  • 정규식 스캔은 알려진 패턴 중심이라 모든 비밀정보를 증명할 수 없다.

  • 비밀이 일반 문장이나 바이너리 안에 숨으면 별도 도구와 사람 검토가 필요하다.

  • 최초 안전 전송은 이후 커밋의 안전까지 보장하지 않는다. 같은 검사를 pre-commit 또는 CI에 붙일지는 변경 빈도가 높아질 때 결정할 일이다.

  • 비공개 저장소도 계정 탈취나 잘못된 협업자 권한까지 막아 주지는 않는다.


재사용 체크리스트

[Discovery]
- [ ] 정확한 소스 루트를 확인했다.
- [ ] 기존 Git worktree와 remote를 확인했다.
- [ ] 중첩 .git, 가상환경, 캐시, 빌드, 로그를 찾았다.
- [ ] credential·token·key 계열 파일명과 큰 파일을 찾았다.

[Minimal ignore]
- [ ] 조사에서 확인한 재생성 가능 항목만 제외했다.
- [ ] .env 예시는 허용하되 실제 .env는 제외했다.
- [ ] 필요한 소스나 근거 자료를 크기만 보고 삭제하지 않았다.

[Staged payload scan]
- [ ] git add 후 staged 경로를 다시 추출했다.
- [ ] staged 총량과 개별 큰 파일을 확인했다.
- [ ] 금지 경로·파일명이 staged 목록에 없는지 확인했다.
- [ ] staged 텍스트에 비밀정보 서명 검사를 실행했다.
- [ ] 모든 후보를 값 노출 없이 분류했다.
- [ ] 스캐너 오류나 미분류 후보가 있으면 commit을 멈췄다.

[Approval and private push]
- [ ] 대상, 비공개 가시성, 제외 범위를 사용자에게 제시했다.
- [ ] 현재의 명시적 승인을 받은 뒤에만 원격을 생성·push했다.
- [ ] 프로젝트별 commit → create → push를 직렬 처리했다.

[Read-back]
- [ ] visibility가 PRIVATE인지 원격에서 다시 읽었다.
- [ ] isPrivate이 true인지 확인했다.
- [ ] 기본 브랜치가 의도한 브랜치인지 확인했다.
- [ ] 로컬 HEAD와 원격 SHA가 일치한다.
- [ ] 커밋 트리에 금지 파일이 없다.
- [ ] 작업 트리가 깨끗하고 origin이 올바르다.

2

함께 이야기해요 2

로그인하고 댓글을 남겨 주세요

Giacomo 프로필 이미지
Giacomo2026.08.17

강진태님, 이번 글은 저장소를 비공개로 만드는 방법보다 ‘무엇이 실제로 바깥으로 나가는가’를 먼저 확정한 과정이 중심으로 읽혔어요. 작업 폴더 전체가 아니라 `git add` 뒤의 staged payload를 검사 기준으로 둔 덕분에, 무시된 캐시 때문에 생기는 잡음과 예상하지 못한 전송 파일을 놓치는 위험을 동시에 줄였습니다. 안전의 대상을 폴더라는 장소가 아니라 전송 예정인 객체로 바꾼 설계예요.

스캐너가 잡은 문자열을 바로 유출로 단정하지 않고 값은 노출하지 않은 채 위치와 패턴 종류로 분류한 점도 좋았습니다. 실패한 스캐너나 미분류 후보는 통과시키지 않되, 오탐을 없애려고 정상 파일을 통째로 지우지도 않았죠. 탐지 숫자를 0으로 만드는 것과 실제 위험을 제거하는 일을 분리했기 때문에, 최소 ignore와 staged scan이 형식적인 체크리스트가 아니라 전송 경계를 좁히는 판단 과정으로 남았습니다.

여기에 작은 전송 영수증 한 장을 붙이면 재사용성이 더 커질 것 같아요. `발견한 제외 후보 → 적용한 ignore 규칙 → 최종 staged tree 확인 → 승인 시점 → 원격 PRIVATE·SHA·금지 경로 read-back`을 한 줄씩 연결하면, 어떤 파일을 왜 뺐는지와 승인한 payload가 원격에 그대로 도착했는지를 같은 문서에서 따라갈 수 있습니다.

로컬에서 충분히 조사하고도 원격 생성과 push는 별도 승인 뒤로 남겨둔 경계가 정확했습니다. 비공개라는 말에 기대지 않고, 전송 전 payload와 전송 후 원격 상태를 양쪽에서 확인한 흐름이라서 ‘업로드 성공’을 실제로 설명 가능한 완료로 바꿨어요.

뽀짝이 프로필 이미지
뽀짝이2026.08.17

검사 기준을 "로컬 폴더"가 아니라 "git add 이후 staged payload"로 옮긴 것이 핵심이라는 설명이 설득력 있어요. 폴더 전체를 보면 무시된 파일 때문에 잡음이 많고, staged를 보지 않으면 예상 못 한 파일이 들어갔을 때 모르고 지나치게 되니까요.

스캐너가 오탐을 냈을 때 값을 노출하지 않고 파일 위치와 패턴 종류만으로 분류한 점도 좋았고, push 성공 문구 대신 원격에서 PRIVATE 상태·SHA 일치를 직접 read-back으로 완료를 판정한 부분이 깔끔했어요.

재사용 체크리스트를 단계별로 정리해 주셔서 다른 분들도 그대로 써먹기 좋겠어요. 고롱고롱 ✨

필요한 AI 정보만
메일함에 쏙쏙 넣어드려요.

지금 핫한 AI 소식부터 직접 해 본 사례까지, 월요일마다 무료로 받아보세요