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

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

- 주소: https://copyandrun.com/blog/git-credential-security-overview/
- 분야: DevSecOps
- 발행일: 2026-11-14
- 태그: git, credential helper, Git Credential Manager, 토큰, 평문 저장

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에 설정된 도우미와 설정 파일 위치를 확인합니다.

```bash
git config --show-origin --get-all credential.helper
git credential-manager --version
```

```text
file:C:/Program Files/Git/etc/gitconfig	manager
2.7.3+5fa7116896c82164996a609accd1c5ad90fe730a
```

시스템 설정 파일에 `manager`가 지정되어 있습니다. `manager`는 토큰을 운영체제 자격 증명 저장소에 두므로 평문 파일이 생기지 않습니다. 사용자 설정에서 `store`로 바꾸면 이 보호가 사라집니다.

## 2. 존재하지 않는 호스트 조회

저장된 자격 증명이 없는 호스트를 조회하면 Git은 사용자 이름을 묻습니다. 자동화 환경에서는 이 질문이 실패로 끝납니다.

```bash
printf 'protocol=https\nhost=example.invalid\n\n' | git credential fill
```

```text
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`로 바꿉니다. 저장 파일도 실습 디렉터리 안으로 지정합니다.

```bash
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
```

```text
store --file=.../cred-lab/creds
```

가짜 토큰을 저장합니다.

```bash
printf 'protocol=https\nhost=example.invalid\nusername=lab-user\npassword=FAKE-TOKEN-123\n' | git credential approve
cat cred-lab/creds
```

```text
https://lab-user:FAKE-TOKEN-123@example.invalid
```

토큰이 URL 형식 그대로 한 줄 평문으로 저장되었습니다. 이 파일을 읽을 수 있는 사람이나 프로그램은 토큰을 바로 쓸 수 있습니다. 디스크 암호화나 파일 권한이 없으면 백업, 동기화 도구, 공유 폴더로도 새어 나갈 수 있습니다.

## 4. 저장된 값 조회와 삭제

Git은 같은 호스트를 조회할 때 이 파일의 값을 돌려줍니다. 아래 명령은 출력의 비밀번호를 가려서 보여 줍니다.

```bash
printf 'protocol=https\nhost=example.invalid\n\n' | git credential fill | sed 's/password=.*/password=<hidden>/'
```

```text
protocol=https
host=example.invalid
username=lab-user
password=<hidden>
```

토큰을 폐기하거나 교체할 때는 `reject`로 저장된 항목을 지웁니다.

```bash
printf 'protocol=https\nhost=example.invalid\nusername=lab-user\n' | git credential reject
wc -c < cred-lab/creds
```

```text
0
```

실습이 끝나면 `GIT_CONFIG_GLOBAL`을 해제합니다. 저장 파일 위치를 실습 디렉터리로 지정했으므로 사용자 홈의 `.git-credentials`는 바뀌지 않습니다.

## 5. 점검 항목

| 점검 | 확인 명령 | 기준 |
| --- | --- | --- |
| 도우미 종류 | `git config --show-origin --get-all credential.helper` | `manager` 또는 `wincred` 같은 OS 저장소 |
| 평문 파일 | `~/.git-credentials` 존재 여부 | 없어야 함 (있다면 내용을 확인하고 토큰 폐기) |
| 토큰 권한 | 저장소 호스트의 토큰 설정 화면 | 최소 범위, 만료일 지정 |
| 커밋 이력 | `gitleaks`로 이력 스캔 | 토큰이 한 번이라도 커밋되었다면 폐기 |

커밋 이력에 남은 비밀값을 찾는 방법은 [gitleaks로 저장소의 시크릿을 찾고 커밋 전에 막기](/blog/gitleaks-secret-scan/) 글을 참고합니다.

## 6. 확인 체크리스트

- [x] 시스템 설정의 자격 증명 도우미가 `manager`인 것을 확인했습니다.
- [x] `store` 도우미로 가짜 토큰을 저장하면 평문 한 줄이 남는 것을 확인했습니다.
- [x] `fill`로 조회하고 `reject`로 삭제한 뒤 파일 크기가 0이 되는 것을 확인했습니다.
- [x] 저장 파일을 실습 디렉터리로 지정해 사용자 홈의 자격 증명 파일을 바꾸지 않았습니다.
