Bitbucket SSH 설정하기

개요

좋은 기회로 맥북을 새로 장만하여 개발 환경을 세팅하면서 기존에 리포지토리를 관리하고 사용하던 Bitbucket의 SSH 설정을 정리하고자 한다.

설정

일단 터미널에서 Bitbucket에서 지원하는 암호화 알고리즘으로 된 ssh key를 생성한다.

우리는 ed25519 암호화 알고리즘으로 생성해 보자.

passphrase를 입력하라고 하는 부분에서는 아무 입력 없이 엔터를 치고 넘어가면 된다.

windows의 경우 git을 설치하면 git bash로 터미널을 이용할 수 있다.

ssh-keygen -t ed25519 -b 256

Bitbucket에서 지원하는 ed25519 알고리즘으로 키를 생성한다.

키 생성이 완료되면 사용자 디렉토리에 .ssh 폴더가 생성되고,

폴더 내에 id_ed25519 파일과 id_ed25519.pub 파일이 생성되었을 것이다.

여기서 .pub가 붙은 파일이 공개키(public key)이고,

그렇지 않은 파일이 개인키(private key)이다.

.ssh 폴더 경로는 아래와 같다.
windows : C:\Users\user\.ssh (user는 컴퓨터 사용자 이름으로 된 폴더를 의미한다.)
Mac OS : ~/.ssh

 

키를 생성하는 부분에 대한 자세한 내용은 아래 공식 문서를 참고하자.

https://support.atlassian.com/bitbucket-cloud/docs/configure-ssh-and-two-step-verification/

Configure SSH and two-step verification | Bitbucket Cloud | Atlassian Support

---

2023년 5월 기준으로 곧 Bitbucket에서 RSA 호스트 키 교체 및 DSA 호스트 키를 제거한다는 공지가 올라왔다.
자세한 내용은 아래 더보기를 눌러서 확인할 수 있다.

Bitbucket의 SSH 호스트 키의 암호화된 사본이 제3자 자격 증명 관리 공급업체의 데이터 유출에 포함되었다는 공지가 5월 15일에 올라왔다.

따라서 Bitbucket 측에서는 호스트 키를 교체하여 이전 호스트 키에 대한 위험을 완화하기 위한 조치를 취하였다.

우리는 그에 맞춰 기존에 사용하던 키가 있다면 아래 공식 문서를 따라 조치를 취해야 한다.

https://bitbucket.org/blog/ssh-host-key-changes

ACTION REQUIRED: Update your Bitbucket Cloud SSH Host Keys - Bitbucket

---

그다음 Bitbucket에 로그인하고 오른쪽 상단의 Settings에서 Personal Bitbucket settings를 선택한다.

Personal settings 페이지에서 왼쪽의 SSH 키 메뉴에 들어가서 키 추가 버튼을 클릭한 뒤,

Key 부분에 id_ed25519.pub 파일의 내용을 붙여 넣는다.

다시 터미널로 돌아와서 key가 잘 인식되는지 확인해 보자.

ssh git@bitbucket.org host_key_info

최초에는 key 연결을 진행할 것인지 물어보는데, yes를 입력하면 키를 추가한다.

이후 다시 문제없이 호스트 키가 출력되면 key가 정상적으로 연결이 된 것이다.

이제 bitbucket에서 ssh를 통해 저장소에 접근할 수 있다.

 

참고) 추가로 sourcetree에서 저장소에 접근하고 싶은 경우 계정 설정에 들어가 프로토콜을 SSH로 바꿔주고 사용하자.

sourcetree에서는 SSH 키가 없다고 나타나도 Bitbucket 저장소 접근에는 문제가 없다.