Mac에서 SSH 키로 Bitbucket 연동하고 vscode에서 Git clone 하는 법

개발

Mac에서 SSH 키로 Bitbucket 연동하고 vscode에서 Git clone 하는 법

jjangsh 2025. 5. 8. 15:51

1. macOS에 OpenSSH 설치

macOS에는 OpenSSH 버전이 미리 설치되어 있어야 한다.

OpenSSH가 설치되어 있는지 확인하려면 터미널을 열고 아래 명령어를 실행한다.

ssh -V

출력에는 설치된 OpenSSH 버전이 표시된다.

Homebrew를 사용하여 최신 버전의 OpenSSH를 설치하려면 아래 명령어를 실행한다.

brew install openssh

설치 후 다시 ssh -V 명령어를 통해 OpenSSH 버전을 확인해 본다.

2. SSH 에이전트 시작

SSH 키를 사용하려면 git 장치에서 SSH 에이전트를 실행해야 한다.

이미 실행 중인지 확인하려면 ps 명령을 실행한다.

ssh-agent가 이미 실행 중이면 아래와 같이 출력에 표시된다.

ps -ax | grep ssh-agent
19998 ??         0:00.20 /usr/bin/ssh-agent -l

에이전트를 시작하려면 아래의 명령어를 실행한다.

eval $(ssh-agent)

3. SSH 키 쌍 생성

SSH 키 쌍을 생성하려면 홈 또는 사용자 디렉토리로 이동한다.

ssh-keygen다음과 같은 명령을 사용하여 SSH 키 쌍을 생성한다.

ssh-keygen -t ed25519 -b 4096 -C "{username@emaildomain.com}" -f ~/.ssh/{ssh-key-name}

{username@emaildomain.com}는 Bitbucket Cloud 계정과 연결된 이메일 주소로, 회사 이메일 계정 등
{ssh-key-name} 키의 출력 파일 이름입니다. 식별 가능한 이름을 사용하는 것이 좋다.

암호 입력 메시지가 표시되면 암호를 입력하거나 비워둘 수 있다. 암호를 입력하면 Bitbucket Cloud에 접속하는 Git 명령(예: git push, git pull, git fetch)을 사용하는 등 SSH를 사용할 때마다 이 암호를 입력하라는 메시지가 표시된다. 암호를 입력하면 기기에 액세스 할 수 있는 다른 사용자가 키를 사용하는 것을 방지할 수 있다.

완료되면 ssh-keygen두 개의 파일이 출력된다.

{ssh-key-name}— 개인 키
{ssh-key-name}.pub— 공개 키

4. SSH 에이전트에 키를 추가

SSH 에이전트에 SSH 키를 추가하려면 아래의 명령을 실행한다.

ssh-add ~/.ssh/{ssh-key-name}

{ssh-key-name}을 개인 키의 이름으로 바꿉니다.

Bitbucket에 연결할 때 올바른 SSH 키가 사용되도록 하려면 ~/.ssh/config를 아래 설정으로 업데이트하거나 만들어야 한다.

Host bitbucket.org
  AddKeysToAgent yes
  IdentityFile ~/.ssh/{ssh-key-name}

5. Bitbucket Cloud에 공개 키를 제공

사용자 계정에 SSH 키를 추가하려면 :

(1) 상단 탐색 모음에서 설정 톱니바퀴를 선택

(2) 설정 드롭다운 메뉴에서 개인 Bitbucket 설정을 선택

(3) 보안에서 SSH 키를 선택

(4) 키 추가를 선택

(5) SSH 키 추가 대화 상자에서 추가할 키를 식별하는 데 도움이 되는 레이블을 입력

(6) 공개 키 입력

공개 키 예시 :

ssh-ed25529 LLoWYaPswHzVqQ7L7B07LzIJbntgmHqrE40t17nGXL71QX9IoFGKYoF5pJKUMvR+DZotTm user@example.com

( macOS는 pbcopy로 클립보드에 복사됨 )

cat ~/.ssh/{ssh-key-name}.pub | pbcopy

(7) 만료일에서 만료일을 설정하거나 만료 없음을 선택 (만료일의 기본 기간은 오늘 날짜로부터 1년으로 설정되어 있음)

(8) 키 추가를 선택 (키가 성공적으로 추가되면 대화 상자가 닫히고 키가 SSH 키 페이지에 나열된다)

6. SSH 인증이 작동하는지 확인

SSH 키가 성공적으로 추가되었는지 테스트하려면 장치에서 터미널을 열고 다음 명령을 실행

ssh -T git@bitbucket.org

처음이면 "Are you sure you want to continue connecting?" 나오면 → yes