소스트리에서 빗버킷 인증 문제 해결하기: SSH 키 등록 및 적용 (파트 3)

SSH 키 등록의 중요성

보안은 모든 개발 프로젝트의 핵심입니다. SSH 키를 사용하는 인증 방법은 비밀번호 기반 방식보다 훨씬 안전합니다. 공개 키 암호화를 사용하여 개인 키가 없으면 접근할 수 없도록 하는 것이죠. 이제 이 SSH 키를 Sourcetree와 Bitbucket에 어떻게 적용하는지 살펴보겠습니다.

SSH 키 생성 및 ppk 파일 형식으로 변환

1. SSH 키 생성:
   • 가장 먼저, SSH 키를 생성해야 합니다. Git Bash나 기타 터미널을 열고 아래 명령어를 입력하여 새 키를 생성합니다.

     ssh-keygen -t rsa -b 4096 -C "your_email@example.com"​

   • 프롬프트에서 키를 저장할 위치를 물어볼 때 Enter 키를 누르면 현재 위치에 저장됩니다. 위치를 지정하고 싶다면 cd 경로 명령어로 이동해주세요. passphrase를 설정하라는 메시지가 나타나면, 기억하기 쉬우면서도 안전한 문구를 입력합니다.
2. PuTTY Key Generator를 사용한 변환:
   • Sourcetree에서는 PuTTY의 .ppk 형식의 키가 필요합니다.
   • Sourcetree를 열고, 'Tools' > 'Create or Import SSH Keys'를 선택합니다.
   • PuTTY Key Generator가 열리면, 'Load' 버튼을 클릭하여 1번에서 생성한 개인 키(id_rsa)를 불러옵니다.
   • 필요한 경우 passphrase를 입력하고, 'Save private key' 버튼을 클릭하여 .ppk 형식으로 저장합니다.

 

 

빗버킷에 SSH 키 등록하기

• 생성한 공개 키(id_rsa.pub)를 Bitbucket 웹 인터페이스에 로그인한 후, '개인 설정' 메뉴의 'SSH 키' 섹션에 등록합니다.
• '새 SSH 키 추가' 버튼을 클릭하여 키의 내용을 복사해서 붙여넣고, 적절한 제목을 입력한 다음 저장합니다.

Sourcetree에 SSH 키 적용하기

1. Sourcetree 설정:
   • 이제 변환된 .ppk 파일을 Sourcetree에 적용해야 합니다.
   • 'Tools' > 'Options'으로 가서 'SSH Client Configuration' 섹션을 찾습니다.
   • 'SSH Key' 필드에서 'Browse' 버튼을 사용하여 변환된 .ppk 파일을 찾아 선택합니다.
2. 마무리:
   • 설정을 저장한 후 Sourcetree를 재시작합니다. 이제 Sourcetree는 새로운 SSH 키를 사용하여 Bitbucket과의 인증을 시도할 것입니다.

추가 팁

SSH 키를 사용할 때, passphrase를 매번 입력하고 싶지 않다면 ssh-agent를 활용할 수 있습니다. 이는 시스템 부팅 시 키를 메모리에 캐싱하여, Sourcetree가 SSH 키를 자동으로 인식하도록 도와줍니다. 이 내용은 복잡해서 개인적으로는 앱 비밀번호를 이용합니다. 한번 등록해두면 다시 비밀번호를 입력할 일이 없기 때문에 편하다고 느끼기 때문입니다.