Bitbucket 전용 SSH Key 생성 & 설정 방법 (기존 키 유지)

Bitbucket은 SSH 키 중복 사용을 허용하지 않으며,
삭제한 키도 최대 30일간 재사용이 불가능하다.

따라서 기존 SSH 키를 덮어쓰지 말고
Bitbucket 전용 SSH 키를 새로 생성하는 것이 가장 안전한 방법이다.

 

1. Bitbucket 전용 SSH 키 생성

기존 키(id_rsa, id_ed25519)를 절대 건드리지 않는다.

 

ssh-keygen -t ed25519 -C "bitbucket-$(whoami)"

키 저장 경로 입력 시 새 파일명 지정:

Enter file in which to save the key:
/Users/username/.ssh/id_ed25519_bitbucket

패스프레이즈:

• 자동화/CI 환경 → 엔터 2회 (비움)
• 개인 PC → 선택 사항

2. Bitbucket에 공개키 등록

cat ~/.ssh/id_ed25519_bitbucket.pub

 

3. SSH config 설정 (가장 중요)

~/.ssh/config 파일 편집
(없으면 새로 생성)

vi ~/.ssh/config


Host bitbucket.org
  HostName bitbucket.org
  User git
  IdentityFile ~/.ssh/id_ed25519_bitbucket
  IdentitiesOnly yes

옵션 설명

Host	git clone 시 사용할 호스트
IdentityFile	Bitbucket 전용 SSH 키
IdentitiesOnly	지정한 키만 사용하도록 강제

 

4. 파일 권한 설정

SSH 키 권한이 올바르지 않으면 인증 실패 발생

chmod 700 ~/.ssh
chmod 600 ~/.ssh/id_ed25519_bitbucket
chmod 644 ~/.ssh/id_ed25519_bitbucket.pub

 

5. Bitbucket SSH 연결 테스트

ssh -T git@bitbucket.org


#정상출력
authenticated via ssh key.
You can use git to connect to Bitbucket. Shell access is disabled.