Copy & Run

Git 자격 증명 보안 점검: store 평문 저장과 Credential Manager 비교

이 PC의 Git 자격 증명 도우미 설정을 확인하고, store 도우미가 토큰을 평문 파일에 저장하는 과정을 가짜 값으로 재현합니다. 저장과 조회, 삭제까지 확인하고 Git Credential Manager와 비교해 점검 항목을 정리합니다.

실습 노트 · 2026-11-14 발행 · 5분 · 2026-11 확인

Git은 HTTPS 원격 저장소에 접근할 때 사용자 이름과 토큰을 자격 증명 도우미(credential helper)에 맡깁니다. 도우미가 store이면 토큰이 평문 파일에 그대로 남고, manager이면 운영체제 자격 증명 저장소에 들어갑니다. 이 글에서는 이 PC의 설정을 확인하고, store 도우미가 토큰을 어떻게 저장하는지 가짜 값으로 재현합니다.

준비물

항목 내용
Git 2.54.0.windows.1
Git Credential Manager 2.7.3 (Git for Windows에 포함)
실습 값 FAKE-TOKEN-123, 호스트 example.invalid (실제 계정과 토큰은 쓰지 않습니다)
실습 파일 임시 설정 파일 GIT_CONFIG_GLOBAL로 격리한 설정
예상 소요 시간 약 10분

1. 현재 자격 증명 도우미 확인

이 PC에 설정된 도우미와 설정 파일 위치를 확인합니다.

git config --show-origin --get-all credential.helper
git credential-manager --version
file:C:/Program Files/Git/etc/gitconfig	manager
2.7.3+5fa7116896c82164996a609accd1c5ad90fe730a

시스템 설정 파일에 manager가 지정되어 있습니다. manager는 토큰을 운영체제 자격 증명 저장소에 두므로 평문 파일이 생기지 않습니다. 사용자 설정에서 store로 바꾸면 이 보호가 사라집니다.

2. 존재하지 않는 호스트 조회

저장된 자격 증명이 없는 호스트를 조회하면 Git은 사용자 이름을 묻습니다. 자동화 환경에서는 이 질문이 실패로 끝납니다.

printf 'protocol=https\nhost=example.invalid\n\n' | git credential fill
warning: failed to probe 'https://example.invalid/' to detect provider
...
fatal: The remote name could not be resolved: 'example.invalid'
fatal: could not read Username for 'https://example.invalid': No such file or directory

호스트를 찾지 못하면 도우미가 탐지에 실패하는 것이 정상입니다. 이 결과는 자격 증명이 없다는 뜻입니다.

3. store 도우미로 토큰 저장하기

실습 설정을 임시 파일로 분리하고 도우미를 store로 바꿉니다. 저장 파일도 실습 디렉터리 안으로 지정합니다.

export GIT_CONFIG_GLOBAL="$PWD/cred-lab/gitconfig"
git config --global credential.helper "store --file=$PWD/cred-lab/creds"
git config --global --get credential.helper
store --file=.../cred-lab/creds

가짜 토큰을 저장합니다.

printf 'protocol=https\nhost=example.invalid\nusername=lab-user\npassword=FAKE-TOKEN-123\n' | git credential approve
cat cred-lab/creds
https://lab-user:FAKE-TOKEN-123@example.invalid

토큰이 URL 형식 그대로 한 줄 평문으로 저장되었습니다. 이 파일을 읽을 수 있는 사람이나 프로그램은 토큰을 바로 쓸 수 있습니다. 디스크 암호화나 파일 권한이 없으면 백업, 동기화 도구, 공유 폴더로도 새어 나갈 수 있습니다.

4. 저장된 값 조회와 삭제

Git은 같은 호스트를 조회할 때 이 파일의 값을 돌려줍니다. 아래 명령은 출력의 비밀번호를 가려서 보여 줍니다.

printf 'protocol=https\nhost=example.invalid\n\n' | git credential fill | sed 's/password=.*/password=<hidden>/'
protocol=https
host=example.invalid
username=lab-user
password=<hidden>

토큰을 폐기하거나 교체할 때는 reject로 저장된 항목을 지웁니다.

printf 'protocol=https\nhost=example.invalid\nusername=lab-user\n' | git credential reject
wc -c < cred-lab/creds
0

실습이 끝나면 GIT_CONFIG_GLOBAL을 해제합니다. 저장 파일 위치를 실습 디렉터리로 지정했으므로 사용자 홈의 .git-credentials는 바뀌지 않습니다.

5. 점검 항목

점검 확인 명령 기준
도우미 종류 git config --show-origin --get-all credential.helper manager 또는 wincred 같은 OS 저장소
평문 파일 ~/.git-credentials 존재 여부 없어야 함 (있다면 내용을 확인하고 토큰 폐기)
토큰 권한 저장소 호스트의 토큰 설정 화면 최소 범위, 만료일 지정
커밋 이력 gitleaks로 이력 스캔 토큰이 한 번이라도 커밋되었다면 폐기

커밋 이력에 남은 비밀값을 찾는 방법은 gitleaks로 저장소의 시크릿을 찾고 커밋 전에 막기 글을 참고합니다.

6. 확인 체크리스트

  • 시스템 설정의 자격 증명 도우미가 manager인 것을 확인했습니다.
  • store 도우미로 가짜 토큰을 저장하면 평문 한 줄이 남는 것을 확인했습니다.
  • fill로 조회하고 reject로 삭제한 뒤 파일 크기가 0이 되는 것을 확인했습니다.
  • 저장 파일을 실습 디렉터리로 지정해 사용자 홈의 자격 증명 파일을 바꾸지 않았습니다.

이 글의 다음 단계

이 내용을 팀 교육으로 진행하고 싶으신가요?

인원, 수준, 일정에 맞춰 실습 환경까지 준비해 진행합니다. 대상과 기간을 알려 주시면 구성을 제안해 드립니다.

교육 문의하기

교육 진행 순서와 자주 묻는 질문 보기

팀이나 교육 담당자에게 이 글 제안하기

메일로 보내실 수도 있습니다: fankh111@gmail.com

같은 카테고리의 글