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

GitHub 계정에 새 SSH 키 추가

이 문서의 내용

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

계정에 GPG 키 추가 정보

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

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

사전 요구 사항

GitHub Enterprise Server 인스턴스의 계정에 새 SSH 키를 추가하기 전에 다음 단계를 완료합니다.

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

계정에 새 SSH 키 추가

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

참고: 기본적으로 GitHub Enterprise Server 3.6 이상에서는 2022년 8월 1일, UTC로 자정에 해당하는 컷오프 날짜를 기준으로 다음 조건을 둘 다 충족하는 SSH 연결이 실패합니다.


  • RSA 키는 2022년 8월 1일 UTC 자정 이후에 GitHub Enterprise Server 인스턴스의 사용자 계정에 추가되었습니다.
  • SSH 클라이언트는 SHA-1 해시 함수를 사용하여 연결 시도에 서명합니다.

GitHub Enterprise Server 3.6 이상에서는 DSA, HMAC-SHA-1 또는 CBC 암호화를 사용하는 SSH 연결도 지원하지 않습니다. 컷오프 날짜 이전에 업로드된 RSA SSH 키는 유효한 상태로 유지되는 한, SHA-1 해시 함수를 사용하여 계속 인증할 수 있습니다. 사용하는 GitHub Enterprise Server의 버전을 찾는 방법에 대한 자세한 내용은 "AUTOTITLE"을 참조하세요.

사이트 관리자는 RSA-SHA-1을 사용하여 연결의 컷오프 날짜를 조정할 수 있으며 RSA-SHA-1을 사용하여 모든 연결을 차단할 수 있습니다. 자세한 내용은 사이트 관리자에게 문의하거나 "AUTOTITLE"을 참조하세요.

  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. SSH 키 추가를 클릭합니다.

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

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

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

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