[ Bitbucket ] SSH keys 설정 위치

 

 

Bitbucket에서 SSH 키를 설정할 수 있는 메뉴는 총 3가지로 나뉘며, 각각의 용도에 따라 위치가 다릅니다.
아래는 정확한 메뉴 위치와 각 항목의 용도입니다.

---

1. 사용자 계정 전체에 적용되는 SSH Key 설정

👉 내가 접근 권한이 있는 모든 리포지토리에 이 키로 접근 가능 (읽기/쓰기)
주로 개발자 개인이 로컬에서 Git 작업할 때 사용합니다.

메뉴 경로:

1. 우측 상단 설정 아이콘 클릭
2. Personal Bitbucket settings 클릭
3. 좌측 메뉴에서 "SSH keys" 클릭
4. ➕ Add key 버튼 클릭 → .pub 공개키 등록

---

2. 워크스페이스(조직) 수준 SSH Key 설정

👉 워크스페이스의 여러 리포지토리에서 공통적으로 사용되는 키
보통 배포 자동화 시스템이 여러 리포를 읽거나 쓸 때 사용합니다.

메뉴 경로:

1. 해당 Workspace를 선택해서 workspace로 이동
2. 상단 메뉴에서 Workspace settings 클릭 (좌측 상단 로고 옆)
3. 좌측 메뉴에서 "SSH keys" 클릭
4. ➕ Add key → 공개키 등록

 

3. Project(조직) 수준 SSH Key 설정

👉 워크스페이스의 여러 리포지토리에서 공통적으로 사용되는 키
보통 배포 자동화 시스템이 여러 리포를 읽거나 쓸 때 사용합니다.

메뉴 경로:

1. 원하는 Project로 이동
2. 좌측 메뉴에서 Project settings 클릭
3. 촤측 메뉴에서 Access keys 클릭
4. Add key → 공개키 등록

 

4. 리포지토리 전용 SSH Key (Deploy Key) 설정

👉 특정 리포지토리에만 접근 가능한 키 (보통 자동화, 배포용)
주로 CI/CD, 배포 서버가 clone/pull 하기 위한 목적으로 사용

메뉴 경로:

1. 원하는 Repository로 이동
2. 왼쪽 메뉴에서 Repository settings 클릭
3. Access keys 또는 SSH keys 메뉴 클릭
4. Add key → 공개키 등록 (선택: Allow write access)

 

5. 요약 정리

키 종류 설정 위치 용도 수익자

사용자 SSH 키	Personal Settings > SSH Keys	개인 Git 작업용	내계정
워크스페이스 SSH 키	Workspace Settings > SSH Keys	여러 리포 공용 키	조직 또는 배포 시스템
프로젝트 SSH 키	Project > Settings > Access Keys	여러 프로젝트 공용 키	조직 또는 배포 시스템
리포지토리 SSH 키	Repository > Settings > Access Keys	CI/CD, 자동화 배포	해당 리포

---