[Solved]Bitbucket Cloud recently stopped supporting account passwords for Git authentication. (ssh키 설정하기, app 비밀번호 설정, git remote 추가 삭제)

 

[Problem]

원래 잘만 되던 BitBucket이 push를 하려고 하니, 갑자기 위와 같은 에러메시지를 내뱉기 시작했다. 

실제 에러메시지는 아래와 같았다.

 

 

[Solved]

위 에러 메시지에 따르면, 더이상 account passwords는 이용하지 못하니, app-password를 설정하고 그 비밀번호를 이용하라고 한다.

일반적으로 app-password를 설정하지 않은 사람이라고 한다면, 아래 [Solution1 - App Password 발급받은 적이 없는 경우] step을 따르면서 AppPW를 발급받고 해결 할 수 있다. 

 

만약 기존에 app-password를 발급받았거나, 새롭게 발급받은 App password임에도 불구하고 계속 위와 같은 혹은 비슷한 에러가 발생한다면 바로 [Solution2 - App Password 정상 발급 했음에도 에러 발생] 부분으로 가보자.

 

---

 

[Solution1 - App Password 발급받은 적이 없는 경우]

 

1. bitbucket 프로필 클릭후, settings > Personal settings에 들어간다.

2. App Passwords 클릭

Personal settings의 좌측 사이드바에 있는 App passwords를 클릭한다.

3. Password를 발급한다.

Create app paasword 버튼을 클릭하여 새로운 패스워드를 발급한다.

 

이때 팝업이 발생하며, password를 알려주는데 이 비밀번호는 한번만 보여주니 다른 곳에 저장 해놓기를 권장한다.

4. 발급받은 AppPW를 이용하여 인증 한다.

 

매우매우 간단하다.

 

---

 

 

[Solution2 - App Password 정상 발급 했음에도 에러 발생]

 

사실 나의 경우는 여기에 해당 했다. 

이전에 AppPassword를 정상발급받고 사용하고 있었고, 혹시 몰라 새롭게 발급 받았음에도 계속 에러가 발생했다.

(remote 주소가 제대로 매칭이 안되는 경우가 대부분인 것 같다.)

 

1. git remote -v 

위 명령어를 통해 git 주소가 어디를 바라보고 있는지 확인하자. 

여기서 자세히 봐야 할 것은 주소 앞에 명시된 git / https 이다.

git@bitbucket으로 시작하는 주소는 ssh 인증이 필요한 주소,

https로 시작하는 주소는 AppPassword 인증이 필요한 주소이다. 

 

따라서 위 주소를 보면 origin 은 ssh인증이, test/upstream은 AppPassword 인증이 필요함을 알 수 있다.

 

 

 

2. bitbucket 주소 확인하기

우리가 인증을 받고 접촉하려고 하는 bitbucket의 repository에 가서 clone 버튼을 눌러, 주소를 확인해보자.

그럼 아래처럼 SSH와 HTTPS의 경우, 주소가 달라져 나오는 것을 볼 수 있다.

 

 

APP Password를 사용하고자 한다면 HTTPS, SSH키 등록을 하여 사용하고자 한다면 SSH주소(git으로 시작하는)를 git remote에 등록해주자. 

 

---

 

3. git remote 등록 및 삭제

git remote -v 로 등록된 주소를 확인하고, 

git remote -v

필요없는 주소는 git remote rm [remote-name] 으로 삭제,

git remote rm

우리가 등록하고자 하는 주소는 git remote add [remote_name] [git 주소 - ssh or https]

명령어로 등록하자. 

git remote add

 

---

 

3. 인증하기(by AppPassword)

HTTPS 주소를 제대로 등록해준 후, 위에서 발급 받았던 AppPassword를 이용하여 인증해주면 정상 작동하는 모습을 볼 수 있다. 

 

 

3-1. 인증하기(by SSH키)

APP Password는 발급이 매우 편했지만, SSH키는 등록하기가 상대적으로 쪼오오오끔 까다롭지만, bitbucket에서 매우 자세히 설명이 되어 있으니, 따라하면 금발 할 수 있다. 운영체제에 따라 SSH키 발급받기  링크에 들어가면, window인지 mac인지에 따라 ssh키 generation 및 등록하는 방법이 있으니 따라하면 된다!

 

정상적으로 등록했다면, SSH 주소로 git pull / push 등을 해주면 비밀번호 입력 필요 없이 정상적으로 작동하는 모습을 볼 수 있다!