Skip to main content
설명서에 자주 업데이트를 게시하며 이 페이지의 번역이 계속 진행 중일 수 있습니다. 최신 정보는 영어 설명서를 참조하세요.
All products
인증

GitHub 계정에 새 SSH 키 추가

이 문서의 내용

GitHub.com에서 새(또는 기존) SSH 키를 사용하도록 계정을 구성하려면 계정에 키를 추가해야 합니다.

계정에 GPG 키 추가 정보

SSH(Secure Shell Protocol)를 사용하여 GitHub.com의 리포지토리에서 데이터에 액세스하고 쓸 수 있습니다. SSH를 통해 연결할 때 로컬 머신에서 프라이빗 키 파일을 사용하여 인증합니다. 자세한 내용은 "SSH 정보.

SSH를 사용하여 커밋 및 태그에 서명할 수도 있습니다. 커밋 서명에 대한 자세한 내용은 "커밋 서명 확인 정보.

SSH 키 쌍을 생성한 후 GitHub.com에 공개 키를 추가하여 계정에 SSH 액세스를 사용하도록 설정해야 합니다.

사전 요구 사항

GitHub.com의 계정에 새 SSH 키를 추가하기 전에 다음 단계를 완료합니다.

  1. 기존 SSH 키를 확인합니다. 자세한 내용은 "기존 SSH 키 확인"을 참조하세요.
  2. 새 SSH 키를 생성하고 컴퓨터의 SSH 에이전트에 추가합니다. 자세한 내용은 "새 SSH 키 생성 및 ssh-agent에 추가"을 참조하세요.

계정에 새 SSH 키 추가

GitHub.com의 계정에 새 SSH 인증 키를 추가한 후 SSH를 사용하도록 로컬 리포지토리를 다시 구성할 수 있습니다. 자세한 내용은 "원격 리포지토리 관리"을 참조하세요.

참고: GitHub는 2022년 3월 15일에 이전의 안전하지 않은 키 형식을 삭제하여 보안을 향상시켰습니다.

해당 날짜를 기준으로 DSA 키(ssh-dss)는 더 이상 지원되지 않습니다. GitHub.com의 개인 계정에 새 DSA 키를 추가할 수 없습니다.

valid_after가 2021년 11월 2일 이전인 RSA 키(ssh-rsa)는 서명 알고리즘을 계속 사용할 수 있습니다. 해당 날짜 이후에 생성된 RSA 키는 SHA-2 서명 알고리즘을 사용해야 합니다. SHA-2 서명을 사용하려면 일부 이전 클라이언트를 업그레이드해야 할 수 있습니다.

  1. SSH 퍼블릭 키를 클립보드에 복사합니다.

    SSH 퍼블릭 키 파일에 예제 코드와 다른 이름이 있는 경우 현재 설정과 일치하도록 파일 이름을 수정합니다. 키를 복사할 때 줄 바꿈 또는 공백을 추가하지 마세요.

    $ pbcopy < ~/.ssh/id_ed25519.pub
  # Copies the contents of the id_ed25519.pub file to your clipboard

    팁: pbcopy가 작동하지 않는 경우 숨겨진 .ssh 폴더를 찾고, 즐겨찾는 텍스트 편집기에서 파일을 열고, 클립보드에 복사할 수 있습니다.

    $ clip < ~/.ssh/id_ed25519.pub
  # Copies the contents of the id_ed25519.pub file to your clipboard

    팁: WSL(Linux용 Windows 하위 시스템)을 사용하면 를 사용할 clip.exe수 있습니다. 그렇지 않으면 작동하지 않는 경우 clip 숨겨진 .ssh 폴더를 찾고 즐겨 찾는 텍스트 편집기에서 파일을 열고 클립보드에 복사할 수 있습니다.

    $ cat ~/.ssh/id_ed25519.pub
  # Then select and copy the contents of the id_ed25519.pub file
  # displayed in the terminal to your clipboard

    팁: 또는 숨겨진 .ssh 폴더를 찾고, 즐겨찾는 텍스트 편집기에서 파일을 열고, 클립보드에 복사할 수 있습니다.

  2. 페이지의 오른쪽 위 모서리에서 프로필 사진을 클릭한 다음 설정 클릭합니다.

    사용자가 프로필, 콘텐츠 및 설정을 보고 편집할 수 있는 옵션을 보여 주는 GitHub의 계정 메뉴 스크린샷 메뉴 항목 "설정"은 진한 주황색으로 표시됩니다.

  3. 사이드바의 "액세스" 섹션에서 SSH 및 GPG 키를 클릭합니다.

  4. 새 SSH 키 또는 SSH 키 추가를 클릭합니다.

  5. "제목" 필드에 새 키에 대한 설명이 포함된 레이블을 추가합니다. 예를 들어 개인용 노트북을 사용하는 경우 이 키를 “Personal laptop”이라고 부를 수 있습니다.

  6. 인증 또는 서명 중 키 유형 하나를 선택합니다. 커밋 서명에 대한 자세한 내용은 "커밋 서명 확인 정보.

  7. "키" 필드에 공개 키를 붙여넣습니다.

  8. SSH 키 추가를 클릭합니다.

  9. 메시지가 표시되면 GitHub에서 계정에 대한 액세스를 확인합니다. 자세한 내용은 "sudo 모드"을 참조하세요.

GitHub CLI에 대한 자세한 내용은 "AUTOTITLE"을 참조하세요.

GitHub CLI를 사용하여 계정에 SSH 키를 추가하려면 먼저 GitHub CLI에서 인증을 받아야 합니다. 자세한 내용은 GitHub CLI 설명서의 “gh auth login”을 참조하세요.

현재, GitHub CLI는 SSH 인증 키를 추가하는 데에만 사용할 수 있습니다. SSH 서명 키는 추가할 수 없습니다.

GitHub 계정에 SSH 인증 키를 추가하려면 공개 키를 지정하는 ssh-key add 하위 명령을 사용합니다.

gh ssh-key add KEY-FILE

새 키의 제목을 포함하려면 -t 또는 --title 플래그를 사용합니다.

gh ssh-key add KEY-FILE --title "personal laptop"

"새 SSH 키 생성 및 ssh-agent에 추가"의 지침에 따라 SSH 키를 생성한 경우 이 명령을 사용하여 계정에 키를 추가할 수 있습니다.

gh ssh-key add ~/.ssh/id_ed25519.pub

추가 참고 자료