[Git] GitHub HTTPS 인증 실패: "Support for password authentication was removed" 에러 해결 가이드

📘 GitHub HTTPS 인증 실패: "Support for password authentication was removed" 에러 해결 가이드

---

❗ 문제 현상

Git 명령어 실행 시 다음과 같은 에러가 발생합니다:

remote: Support for password authentication was removed on August 13, 2021.
remote: Please see https://docs.github.com/...
fatal: Authentication failed for 'https://github.com/<your-name>/<repo>.git'

---

🧠 에러 원인

이 에러는 GitHub가 더 이상 비밀번호 인증을 허용하지 않기 때문입니다.

🔐 배경 설명

• GitHub는 보안 강화를 위해 2021년 8월 13일부터 HTTPS를 이용한 비밀번호 인증을 폐지했습니다.
• 대신, 더 안전한 인증 수단인 Personal Access Token(PAT) 또는 SSH Key 인증 방식을 사용해야 합니다.
• 비밀번호 인증은 중간자 공격(MITM), 패스워드 누출 등 다양한 보안 위협에 취약하기 때문입니다.

---

✅ 해결 방법 1: Personal Access Token(PAT) 방식

HTTPS URL을 유지하면서 인증 방식을 비밀번호 대신 토큰으로 바꾸는 방법입니다.

1️⃣ 토큰 생성 방법 (GitHub Classic PAT)

1. GitHub 로그인 후 토큰 생성 페이지로 이동
2. “Generate new token (classic)” 클릭
3. 설정 항목:
   • Note: 토큰 이름 (예: "Git CLI token")
   • Expiration: 30일/90일/없음 등 유효 기간
   • Scopes: 최소 repo 권한 체크 (필요시 workflow, read:org 등 추가)
4. Generate token 클릭 후 생성된 문자열을 안전하게 복사

   ⚠️ 이 토큰은 생성 직후에만 보여지며, 다시 확인 불가

2️⃣ clone 시 토큰 사용

git clone https://<username>@github.com/<your-name>/<repo>.git

• 비밀번호 입력 창이 나오면, 비밀번호 대신 위에서 생성한 토큰을 붙여넣기 합니다.
• Git Credential Manager가 설치되어 있다면, 저장 여부를 물어보기도 합니다.

---

✅ 해결 방법 2: SSH Key 방식

토큰 입력 없이 자동 인증을 원한다면 SSH 방식이 더 편리합니다. 특히 자주 Git 작업을 하는 개발자에게 추천됩니다.

1️⃣ SSH 키 생성

ssh-keygen -t ed25519 -C "your_email@example.com"

• ~/.ssh/id_ed25519 (개인키)
• ~/.ssh/id_ed25519.pub (공개키)

✅ ed25519는 RSA보다 짧고 빠르면서도 안전한 알고리즘입니다.

2️⃣ SSH 공개키 등록 (GitHub)

1. GitHub 접속 → SSH and GPG keys
2. New SSH key 클릭
3. id_ed25519.pub 내용을 붙여넣고 저장

3️⃣ SSH 주소로 clone

git clone git@github.com:<your-name>/<repo>.git

→ 인증 없이 바로 클론됩니다.

---

📌 개념 정리: HTTPS vs SSH 인증 방식

구분	HTTPS + Token	SSH
사용방식	웹 브라우저처럼 URL 인증	공개키-개인키 기반 자동 인증
최초 설정	비교적 간단 (토큰 발급만)	초기 설정 필요 (키 생성 + 등록)
보안성	안전하지만 매번 입력 필요할 수 있음	매우 안전하고 자동화 가능
추천 대상	가끔 GitHub 쓰는 사용자	개발자, DevOps, 자동화 환경 등

---

🧼 기타 팁

• Git 인증 오류가 반복되면 아래 명령어로 캐시된 자격 증명을 삭제할 수 있습니다:

  git credential-manager uninstall
  git config --global --unset credential.helper

• macOS에서 Keychain Access, Windows에서는 Credential Manager를 통해 저장된 비밀번호나 토큰을 수정할 수도 있습니다.

---

✅ 결론

사용 환경	추천 인증 방식
단발성 사용, GUI 위주	Personal Access Token (HTTPS)
CLI 자주 사용, 자동화/스크립트 포함	SSH Key

---