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이 되는 것을 확인했습니다. - 저장 파일을 실습 디렉터리로 지정해 사용자 홈의 자격 증명 파일을 바꾸지 않았습니다.
이 글의 다음 단계
- OpenLDAP ACL 점검하기: 익명과 로그인 사용자가 비밀번호 해시를 읽을 수 있는지 확인OpenLDAP 2.6.15 컨테이너 두 개에 같은 사용자 항목을 넣고, 느슨한 ACL과 좁힌 ACL을 익명과 일반 사용자로 나누어 검색과 수정을 시도합니다. slapacl로 같은 질문을 설정 파일만으로 대조하고, 막혀야 하는 동작이 허용되는 건수를 종료 코드로 바꿉니다.
- Git Clone 방법 정리: HTTPS, 얕은 클론, 부분 클론 비교공개 저장소 Hello-World를 세 가지 방식으로 클론해 가져온 커밋 수, 원격 설정, 파일 내용 차이를 비교합니다. 전체 클론, --depth 1 얕은 클론, --filter=blob:none 부분 클론의 차이를 명령과 출력으로 확인합니다.
이 내용을 팀 교육으로 진행하고 싶으신가요?
인원, 수준, 일정에 맞춰 실습 환경까지 준비해 진행합니다. 대상과 기간을 알려 주시면 구성을 제안해 드립니다.
교육 문의하기메일로 보내실 수도 있습니다: fankh111@gmail.com