깃허브 remote: Invalid username or password 오류 해결

코드 저장을 위해서 github를 정말 많이 사용하는데요.

github는 홈페이지 내에서만 코드를 저장하는 게 아니라 원격 저장소를 이용하여 특정 명령어로 편하게 저장이 가능하죠.

remote: Invalid username or password

그런데 가끔씩 위와 같은 오류가 발생하더라고요.

이번 포스팅에서는 위의 오류가 발생하는 원인과 해결방법을 알려드릴게요.

오류 원인

위의 오류는 잘못된 인증 정보 입력, 캐시된 잘못된 자격 증명, github의 비밀번호 대신 PAT(Personal Access Token)필요, SSH키 미등록 또는 설정 오류, 저장소에 대한 권한 부족 등 굉장히 다양합니다.

이 원인들의 공통점을 살펴보면 사용자가 올바르게 인증되지 못한 것을 알 수 있죠.

보통 새로운 환경에서 특정 레파지토리로 push 할 때 등등 자주 발생하는 오류입니다.

 

해결 방법

해결 방법은 생각보다 간단합니다.

먼저 크게 토큰을 생성하고 적용시켜주면 됩니다.

 

1. 토큰 생성

먼저 github 사이트에 로그인해주세요.

우측 상단에 있는 본인 프로필을 누르시고, Settings를 클릭해 주세요.

가장 하단에 있는 Developer settings를 클릭해주세요.

Personal access tokens를 클릭해주세요.

여기서 Tokens를 클릭해주세요.

Generate new token을 클릭해주세요.

Note에는 아무 텍스트나 적어주시면 되고, expiration에는 만료 기간을 설정해 주시면 됩니다. 저는 No expiration을 설정했어요.

마지막으로 Select scopes는 repo를 체크해주시면 됩니다.

생성을 누르시면 위와 같이 토큰이 생성될 것입니다.

 

2. 토큰 적용

토큰 적용은 정말 쉽습니다.

git remote remove origin
git remote add origin https://[깃허브 이름]:[토큰]@github.com/[repository 경로]

위의 두 명령어를 터미널창에 입력해주시면 되는데요.

헷갈리실 것 같아서 예시로 적어드릴게요.

git remote add origin https://comgongnuna:[토큰값]@github.com/comgongnuna/comgongnuna.github.io.git

저런식으로 붙여주시면됩니다.

본인의 repository 경로를 새로 입력하는게 아니라 / 뒤에 그대로 이어서 작성해주시면 돼요!