Windows에서 Git 자격 증명 삭제 방법 총정리

 

개발을 하다 보면 누구나 한 번쯤 머리를 싸매게 만드는 순간이 있습니다. 코드를 열심히 수정하고 기분 좋게 'git push origin main' 명령어를 입력했는데, 화면에 새빨간 글씨로 'Permission to user A denied to user B'와 같은 인증 오류(Permission Denied)가 떨어지는 순간입니다. 특히 Windows 환경에서 작업하는 개발자라면 이런 경험이 유독 잦을 수 있습니다. 혼자 쓰는 노트북이라면 그나마 상관없을 수 있지만, '회사 계정과 개인 GitHub 계정을 한 PC에서 번갈아 가며 사용할 때', '이전 근무자나 동료가 쓰던 PC를 물려받아 개발 환경을 세팅할 때', '기존에 쓰던 비밀번호나 Personal Access Token(PAT)이 만료되어 새롭게 갱신해야 할 때', '국비지원 교육센터나 공용 실습실 PC에서 내 Repository에 접근하려고 할 때' 등등 상황에 직면하면 상황은 복잡해질 수 있습니다. 분명히 로컬 Git 설정(git config user.name)은 내 이름과 내 이메일로 올바르게 바꿨는데도 Git은 자꾸만 '이전 계정' 혹은 '회사 계정'의 권한을 내밀며 접근을 거부합니다. 아무리 config 파일을 뜯어고쳐도 해결되지 않는 이 기이한 현상 때문에 골머리를 썩은 적인 있을 겁니다. 

이 문제의 핵심 원인은 Git 자체의 설정 파일이 아니라, Windows 운영체제가 깊숙이 감추고 있는 'Git 자격 증명(Git Credential)'에 있습니다. Windows는 사용자의 편의를 위해 한 번 로그인에 성공한 Git 계정 정보를 시스템 내부 저장소에 안전하게 보관해 두는데, 새로운 계정으로 변경하려고 할 때 이 오래된 정보를 시스템 내부 저장소에 안전하게 보관해 두는데, 새로운 계정으로 변경하려고 할 때 이 오래된 정보가 자동으로 튀어나와 훼방을 놓는 겁니다. 

그래서 필자가 작성하는 이 글은 Windows 환경에서 개발하는 많은 개발자들이 Git 자격 증명이 무엇인지 원리부터 명확하게 짚고 계정 충돌이나 인증 오류가 발생했을 때 Windows에 숨겨진 Git 자격 증명을 찾아내어 삭제하는 방법을 GUI 방식부터 개발자 다운 CLI 방식까지 단계별로 알아보겠습니다. 

 

 

 

 

 

Git 자격 증명이란 무엇인가?

 

우리가 GitHub, GitLab, Bitbucket 같은 원격 저장소(Remote Repository)에 코드를 올리거나 가져올 때, 원격 서버는 반드시 '네가 이 Repository에 접근할 권한이 있는 사람이 맞아?'라는 신원 확인 과정을 거칩니다. 과거에는 오픈 프로젝트를 다룰 때 매번 아이디와 비밀번호를 타이핑해야 했습니다. 하지만 수시로 push와 pull을 반복하는 개발자들에게 매번 로그인을 요구하는 것은 엄청난 고역입니다. 그래서 등장한 도우미가 바로 Git 자격 증명 시스템입니다. 

 

 

Windows 환경에서는 기본적으로 GCM(Git Credentail Manager)이라는 오픈소스 도구가 Git 설치 시 함께 셋팅됩니다. GCM은 최초 1회 인증을 성공하면, 로그인 정보(사용자 이름, 패스워드 또는 보안 토큰)를 Windows 운영체제의 자체 보안 저장소인 'Windows 자격 증명 관리자'에 위임하여 저장합니다. 특히 GitHub은 보안 강화를 위해 일반 비밀번호 인증을 완전히 폐지하고, HTTPS 인증 기반의 PAT(Personal Access Token) 또는 OAuth 앱 인증만을 허용하고 있습니다. 이 복잡하고 긴 토큰 문자열을 개발자가 외워서 입력할 수 없기 때문에, GCM이 Windows 시스템 내부에 이 토큰을 숨겨두고 GIt 요청이 있을 때마다 대신 꺼내어 원격 서버에 던져주는 역할을 수행합니다.

 

 

 

 

 

왜 Git 자격 증명을 삭제해야 하는가?

 

Git은 자격 증명을 참조하는 우선순위 메커니즘이 있습니다. Git은 원격 저장소와 통신할 때, 현재 프로젝트 폴더의 '.git/config'에 적힌 'user.name' 보다 Windows 시스템 저장소에 등록된 인증 정보(GCM)를 최우선으로 신뢰합니다. 이로 인해서 아래와 같은 문제가 발생할 수 있습니다.

1. 인증 오류의 무한 루프
   GitHub 계정의 비밀번호를 변경했거나 토큰을 재발급받았을 때, Windows는 여전히 '과거의 옜날 토큰'을 들고 원격 서버에 접근합니다. 서버는 당연히 거부(401 UnAutorized) 하지만, 시스템은 자격 증명이 갱신되지 않았으므로 계속해서 틀린 정보를 밀어 넣는 악순환이 발생합니다.
2. 회사와 개인 계정의 충돌
   낮에는 회사의 GitLab 계정으로 일하고, 밤에는 개인 노트북이나 회사 PC에서 사이드 프로젝트(GitHub)를 하려고 할 때 발생합니다. Windows 자격 증명 관리자에 회사 계정이 메인으로 박혀 있으면, 개인 Repository에 Push 할 때도 회사 계정 권한으로 접근을 시도하다가 권한 거부 오류를 뿜어내게 됩니다.
3. 유령 커밋과 권한 불일치
   로컬 'git config' 상의 이메일과 자격 증명 관리자의 계정이 다르면, 잔디(Contribution)는 내 개인 계정으로 심어지는데 정작 Push 권한은 엉뚱한 계정의 토큰을 사용하는 기괴한 불일치 상태가 발생하여 협업 시 히스토리 관리가 꼬입니다.

따라서 꼬인 실타래를 푸는 가장 빠르고 편리한 방법은, Windows가 기억하고 있는 과거의 잘못된 자격 증명을 완전히 삭제하여 GIt이 새로운 로그인 창을 띄워 새로운 자격 증명을 만들 수 있도록 강제하는 것입니다.

 

 

 

 

 

보안적인 관점에서의 위험성

 

우리는 보안(Security) 관점에서 이 문제를 바라보아야 합니다. 많은 주니어 개발자분들이 간과하는 사실 중 하나는, Windows 자격 증명 관리자에 저장된 정보가 물리적/논리적 위협에 노출될 수 있다는 점입니다. 비록 암호화되어 보관된다고는 하지만, 시스템 권한이 탈취되거나 PC가 무방비 상태로 노출되면 이 자격 증명은 고스란히 공격자의 손에 들어갈 수 있습니다.

 

🚨 실제 발생할 수 있는 최악의 보안 사고 시나리오

1. 이직/퇴사 시 계정 정보 미삭제
전 직장에서 사용하던 업무용 노트북을 반납하거나 후임자에게 인계할 때, Git 자격 증명을 삭제하지 않으면 후임자가 전임자의 권한으로 회사의 프라이빗 저장소에 접근하거나 코드를 임의로 수정할 수 있게 됩니다.

2. 공용 PC에서의 토큰 노출
국비지원 실습실이나 카페의 공용 PC에서 소스코드 확인을 위해 로그인을 했다가 로그아웃을 잊은 경우, 다음에 그 자리에 앉은 타인이 내 GitHub 저장소를 통째로 삭제하거나 악성코드를 심어 Push 할 수 있습니다.

3. 노트북 분실 및 세션 탈취
개발용 노트북을 분실했을 때, Windows 로그인 패스워드가 취약하다면 습득자가 내부 자격 증명 관리자를 통해 회사의 소스코드가 담긴 Enterprise Repository 권한을 통째로 탈취하는 끔찍한 공급망 공격(Supply Chain Attack)의 시발점이 될 수 있습니다.

 

Git 토큰(PAT)은 단순한 비밀번호를 넘어 '해당 계정의 모든 권한을 대행하는 마스터키'와 같습니다. 사용하지 않거나 꼬여버린 자격 증명을 방치하는 것은 자물쇠 비밀번호를 포스트잇에 적어 문 앞에 붙여두는 것과 다름없습니다.

 

 

 

 

 

Windows에서 Git 자격 증명 삭제 방법 가이드

 

방법 1: Windows 자격 증명 관리자(GUI) 이용하기

---

1.  Windows 검색에서 '자격 증명 관리자'를 검색합니다.

 

 

 

 

 

 

2.  자격 증명 관리자에서 'Windows 자격 증명'을 선택 후, Git 관련 자격 증명이 있는지 확인합니다.

 

 

git:[https:/github.com], git:[https://gitlab.com] 등으로 시작하는 Git 항목을 찾습니다. 해당 항목이 자격 증명에서 삭제할 Git 항목입니다.

 

 

 

 

 

3.  Git 항목의 자격 증명을 열고 제거 버튼을 클릭합니다.

 

 

 

 

 

 

4.  일반 자격 증명 삭제 윈도우가 나타나면 '예'를 클릭해 자격 증명을 삭제합니다.

 

 

 

 

 

 

방법 2: Git Credential Manager(GCM) 이용하기

---

1.  Windows 터미널을 관리자 권한으로 실행합니다.

 

 

 

 

 

 

2.  터미널 실행 후, 'git credential-manager erase' 명령어를 입력합니다. 이때, 명령어를 입력하면 Enter가 쳐지면서 아래 커서가 깜빡입니다. 이후 3번의 명령어를 그대로 입력해 주세요.

 

 

 

 

 

 

3.  이어서 protocol과 host를 입력합니다. 그리고 마지막에 Enter를 한 번 더 입력해 주세요.

 

 

🚨 참고!

GCM을 이용하는 방법을 찾아보면 'git credential-manager clear'라는 명령어를 소개받을 수 있습니다. 해당 명령어는 존재하지 않는 명령어로 보통은 'get', 'store', 'erase', 'approve', 'reject' 등등의 명령어를 사용할 수 있습니다. clear는 기본 CLI 명령으로 정의되어 있지 않고 교육용 설명으로 주로 샘플링되어 있습니다.

 

 

 

 

 

방법 3: Git CLI 명령어 이용하기

---

1.  Git Bash를 실행합니다. 실행 후, 'git credential reject' 명령어를 입력합니다. 방법 2에서 입력했던 것처럼 protocol, host를 입력하고 Enter를 한번 더 입력합니다.

 

 

위 명령어는 Git에서 https 프로토콜의 'github.com' 호스트에 대해 기존에 저장되어 있던 모든 Credential 정보를 거부(reject)하고 지우도록 지시하는 명령어입니다. 해당 명령어를 통해 안전하고 완벽하게 내부 캐시까지 청소할 수 있습니다.

 

 

 

 

 

 

 

---

Windows 환경에서 Git 자격 증명 충돌 문제와 해결 방법에 대해서 알아보았습니다. 자격 증명을 삭제하고 나면, 다음번에 git push나 git pull을 시도할 때 Git은 새로운 로그인 창을 띄어줄 겁니다. 이때 변경된 올바른 계정 정보나 새로 발급받은 PAT 토큰을 입력하면 새로운 인증 체계로 정상화됩니다. 

 

 

 

 

 

@Junesker

---