GitHub 계정에 새 SSH 키 추가

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

Platform navigation

Tool navigation

Connect to GitHub with SSH

전체 5개 중 4번째 문서
다음:SSH 연결 테스트

이 기사에서

계정에 SSH 키 추가에 대한 정보

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

SSH를 사용하여 커밋 및 태그에 서명할 수도 있습니다. 커밋 서명에 관한 자세한 내용은 커밋 서명 확인에 대한 안내을(를) 참조하세요.

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

필수 조건

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

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

계정에 새 SSH 키 추가

SSH 키를 추가하고 인증 또는 커밋 서명 또는 둘 모두에 사용할 수 있습니다. 인증 및 서명에 동일한 SSH 키를 사용하려면, 두 번 업로드해야 합니다.

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

참고

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

해당 날짜를 기준으로 DSA 키(ssh-dss)는 더 이상 지원되지 않습니다. GitHub에서 개인 계정에 새 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

참고

  • Linux용 Windows 하위 시스템(WSL)을 사용한다면 clip.exe을(를) 사용할 수 있습니다. clip이(가) 작동하지 않는 경우 숨겨진 .ssh 폴더를 찾고, 즐겨찾는 텍스트 편집기에서 파일을 열고, 클립보드에 복사할 수 있습니다.
  • Windows Terminal을 사용하는 최신 버전의 Windows 또는 PowerShell 명령줄을 사용하는 다른 위치에서는 The '&lt;' operator is reserved for future use.라고 하는 ParseError가 표시될 수 있습니다. 이 경우 다음과 같은 대체 clip 명령을 사용해야 합니다.
$ cat ~/.ssh/id_ed25519.pub | clip
# Copies the contents of the id_ed25519.pub file to your clipboard

$ 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 폴더를 찾고, 즐겨 찾는 텍스트 편집기에서 파일을 열고, 클립보드에 복사할 수 있습니다.

  1. GitHub의 페이지 오른쪽 상단에서 프로필 사진을 선택한 다음, Settings를 클릭합니다.

  2. 사이드바의 "Access" 섹션에서 SSH and GPG keys를 클릭합니다.

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

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

  5. 인증 또는 서명 중 키 유형 하나를 선택합니다. 커밋 서명에 관한 자세한 내용은 커밋 서명 확인에 대한 안내을(를) 참조하세요.

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

  7.        **SSH 키 추가**를 클릭합니다.

데이터 재사용 가능 항목.사용자-설정.수도-모드-팝업 %}

참고

GitHub CLI에 대한 자세한 내용은 GitHub CLI 정보을(를) 참조하세요.

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

GitHub 계정에 SSH 키를 추가하려면 공개 키를 지정하는 ssh-key add 하위 명령을 사용합니다. 인증 키의 경우 추가 범위를 요청하라는 프롬프트가 표시되면 명령줄의 지침을 따르세요.

gh ssh-key add KEY-FILE --type {authentication|signing}

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

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

          [AUTOTITLE](/authentication/connecting-to-github-with-ssh/generating-a-new-ssh-key-and-adding-it-to-the-ssh-agent)의 지침에 따라 SSH 키를 생성한 경우, 이 명령을 사용하여 계정에 키를 추가할 수 있습니다.

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

추가 참고 자료

  •         [AUTOTITLE](/authentication/authenticating-with-saml-single-sign-on/authorizing-an-ssh-key-for-use-with-saml-single-sign-on)
이전새 SSH 키 생성 및 ssh-agent에 추가다음SSH 연결 테스트