맥에서 깃허브에 코드를 푸시할 때마다 매번 계정 비밀번호를 입력하려니 너무 번거롭고 시간 낭비라고 느껴질 때가 많으실 겁니다.
이는 깃허브의 기본 HTTPS 인증 방식 때문에 생기는 문제로, 매번 보안 검증이 필요하기 때문입니다.
이 글에서는 맥에서 SSH 키를 생성하고 깃허브에 등록하여 단 한 번의 설정으로 비밀번호 입력 없이 편리하게 코드를 관리하는 방법을 단계별로 안내합니다.
– SSH 키를 생성하여 깃허브 인증 절차를 간소화합니다.
– 맥 터미널에서 SSH 키를 만들고, 공개 키를 깃허브에 등록합니다.
– SSH 연결 테스트를 통해 번거로운 비밀번호 입력을 영구적으로 없앱니다.
맥에서 깃허브 이용 시 매번 비밀번호를 입력할 필요 없이, SSH 키를 생성하고 연결하여 쉽고 안전하게 연동하는 방법을 설명합니다.
SSH, 왜 필요한가요? (기존 방식의 문제점)
맥에서 깃허브에 코드를 푸시할 때마다 계정 비밀번호를 입력하는 불편함은 HTTPS 인증 방식의 한계 때문입니다. 매번 인증 절차를 거쳐야 하므로 개발 흐름을 끊고 귀중한 시간을 낭비하게 됩니다.
SSH(Secure Shell)는 이러한 반복적인 인증 문제를 해결하는 효율적인 프로토콜입니다. 공개 키와 비공개 키 쌍을 사용하여 한 번의 설정으로 비밀번호 없이 깃허브와 안전하게 통신할 수 있습니다.
| 구분 | HTTPS 방식 | SSH 방식 |
|---|---|---|
| 인증 | 매번 비밀번호 입력 | 초기 설정 후 비밀번호 불필요 |
| 편의성 | 불편함 | 매우 편리함 |
| 보안 | 비밀번호 노출 위험 | 키 기반 암호화로 안전 |
Photo by Tima Miroshnichenko on Pexels
맥에서 SSH 키 생성하기 (단 3단계)
이제 맥 터미널에서 SSH 키를 생성하는 과정을 진행합니다. 이 과정은 단 3단계로 이루어지며, 대부분의 경우 기본 설정으로 진행하는 것이 가장 간단합니다.
- 기존 SSH 키 확인 — 터미널에 `ls -al ~/.ssh`를 입력하여 `.ssh` 디렉토리 내 파일들을 확인합니다.
- 새로운 SSH 키 생성 — `ssh-keygen -t ed25519 -C “당신의 깃허브 이메일”` 명령어를 실행합니다. 파일 저장 경로와 passphrase 질문에는 모두 엔터 키를 눌러 기본값으로 진행합니다.
- SSH 에이전트에 키 추가 — `eval “$(ssh-agent -s)”`로 에이전트를 시작하고, `ssh-add ~/.ssh/id_ed25519`로 새로 만든 비공개 키를 에이전트에 추가합니다.
passphrase는 SSH 키 사용 시 추가 비밀번호를 묻는 기능입니다. 편리성을 위해 대부분 설정하지 않지만, 보안 강화를 원한다면 설정하는 것이 좋습니다.
Photo by Jakub Zerdzicki on Pexels
깃허브에 공개 키 등록하기
키 생성을 완료했다면, 이제 이 키의 “공개 부분”을 깃허브에 등록할 차례입니다. 이 과정은 내 맥을 깃허브가 신뢰할 수 있는 장치로 인식하게 하는 중요한 단계입니다.
- 공개 키 내용 복사 — 터미널에서 `pbcopy < ~/.ssh/id_ed25519.pub` 명령어로 공개 키의 내용을 클립보드에 복사합니다. (맥OS 전용 명령어)
- 깃허브 설정 접속 — 깃허브 웹사이트에 로그인 후, 우측 상단 프로필 > Settings > SSH and GPG keys 메뉴로 이동합니다.
- 새 SSH 키 추가 — ‘New SSH key’ 버튼을 클릭합니다. Title(예: My MacBook)을 입력하고, Key 필드에 복사한 공개 키 내용을 붙여넣은 후 ‘Add SSH key’ 버튼을 눌러 저장을 완료합니다.
여러 기기에서 깃허브에 접근해야 한다면, 각 기기마다 SSH 키를 생성하여 등록할 수 있습니다. 각 키의 Title을 명확히 구분하여 관리하는 것이 효율적입니다.
Photo by Tima Miroshnichenko on Pexels
SSH 연결 테스트 및 기존 리포지토리 변경
모든 설정이 올바르게 진행되었는지 확인하는 마지막 단계입니다. 깃허브와 맥 사이의 SSH 통신이 원활한지 테스트하고, 필요한 경우 기존 리포지토리의 원격 URL을 변경해야 합니다.
- SSH 연결 테스트 — 터미널에 `ssh -T git@github.com`를 입력합니다. 처음 연결 시 `Are you sure you want to continue connecting (yes/no/[fingerprint])?` 질문에 `yes`를 입력하세요.
- 성공 메시지 확인 — “Hi [당신의 깃허브 유저이름]! You’ve successfully authenticated…” 메시지가 보이면 성공적으로 연결된 것입니다.
- 기존 리포지토리 SSH URL로 변경 (선택) — 기존 HTTPS로 클론한 프로젝트가 있다면, 해당 프로젝트 폴더에서 `git remote set-url origin git@github.com:[유저이름]/[리포지토리이름].git` 명령어로 SSH 방식으로 변경합니다.
연결 테스트 실패 시, SSH 에이전트 실행 여부, `ssh-add` 명령어 실행 여부, 깃허브에 등록된 공개 키 내용이 올바른지 등 3가지 핵심 요소를 다시 한번 확인하는 것이 중요합니다.
맥에서 깃허브 비밀번호 반복 입력의 번거로움은 SSH 키 생성과 등록으로 해결할 수 있습니다. 단 3단계의 키 생성, 깃허브에 공개 키 등록, 그리고 SSH 연결 테스트를 통해 영구적으로 편리한 개발 환경을 구축했습니다. 이 과정은 약 5분 정도 소요되며, 이후 푸시 작업 효율을 80% 이상 높여줄 것입니다.
지금 바로 적용해 보세요.
- 새 SSH 키를 생성하고 ssh-agent에 추가 — 깃허브 공식 문서
- Git 서버 – SSH 프로토콜 — Git 공식 도서
동영상으로 보는 맥 SSH 키 생성 깃허브 연결
글로 충분하지 않다면 관련 영상을 함께 보세요. 클릭하면 YouTube에서 검색 결과로 이동합니다.
자주 묻는 질문
Q. 왜 매번 비밀번호를 입력하는 HTTPS 대신 SSH 키를 사용해야 하나요?
A. SSH 키는 보안성과 편리성 때문에 사용됩니다. 한 번 설정하면 비밀번호 입력 없이 깃허브와 안전하게 통신할 수 있으며, 이는 반복적인 인증 절차 없이 원활한 개발 작업 흐름을 가능하게 하여 작업 효율을 크게 높여줍니다.
Q. 맥에서 SSH 키를 어떻게 생성해야 하나요?
A. 터미널을 열고 `ssh-keygen -t ed25519 -C “your_email@example.com”` 명령어를 입력하면 됩니다. 이후 파일 저장 경로와 passphrase를 설정하라는 메시지가 나타나며, 대부분의 경우 기본 경로(`~/.ssh/id_ed25519`)를 사용하는 것이 좋습니다.
Q. SSH 키를 생성한 후, 깃허브에는 어떻게 등록해야 하나요?
A. 생성된 공개 키 파일(예: `~/.ssh/id_ed25519.pub`)의 내용을 복사하여 깃허브 ‘Settings’ -> ‘SSH and GPG keys’ 섹션에 추가해야 합니다. ‘New SSH key’ 버튼을 클릭하고 적절한 제목을 입력한 후, 복사한 공개 키 내용을 ‘Key’ 필드에 붙여넣으면 등록이 완료됩니다.
Q. 이미 HTTPS 방식으로 사용하던 기존 레포지토리도 SSH 방식으로 바꿔야 하나요?
A. 네, 기존 레포지토리가 HTTPS URL로 설정되어 있다면, SSH 방식으로 변경해야만 SSH 키 인증이 적용됩니다. 해당 레포지토리 폴더로 이동하여 `git remote set-url origin git@github.com:USERNAME/REPOSITORY.git` 명령어를 실행하여 원격 URL을 업데이트할 수 있습니다.
📚 함께 읽으면 좋은 글