Skip to main content

SSH 문제 해결

SSH를 사용하여 GitHub에 연결하고 인증하는 경우, 예기치 않은 문제가 발생하여 이를 해결해야 할 수 있습니다.

HTTPS 포트를 통해 SSH 사용

경우에 따라 방화벽은 SSH 연결을 완전히 허용하지 않습니다. 자격 증명 캐싱과 함께 HTTPS 복제를 사용할 수 없는 경우 HTTPS 포트를 통해 만들어진 SSH 연결을 사용하여 복제를 시도할 수 있습니다. 대부분의 방화벽 규칙은 이를 허용해야 하지만 프록시 서버가 방해할 수 있습니다.

SSH 키 암호 복구

SSH 키 암호를 분실한 경우 사용하는 운영 체제에 따라 SSH 키 암호를 복구하거나 새 SSH 키 암호를 생성해야 할 수 있습니다.

삭제되었거나 누락된 SSH 키

보안 예방 조치로서 GitHub는 1년 동안 사용되지 않은 SSH 키를 자동으로 삭제합니다.

오류: 호스트 키 검증 실패

보안 예방 조치로서, SSH는 이전에 본 호스트를 추적합니다.

오류: 권한이 거부됨(publickey)

“사용 권한이 거부됨” 오류는 서버가 연결을 거부했음을 의미합니다. 여러 이유가 있을 수 있으며 가장 일반적인 예시는 아래에 설명되어 있습니다.

오류: 잘못된 파일 번호

이 오류는 일반적으로 서버에 연결할 수 없음을 의미하며, 방화벽 및 프록시 서버로 인해 발생하는 경우가 많습니다.

오류: 키가 이미 사용 중임

이 오류는 이미 다른 계정 또는 리포지토리에 추가된 키를 추가 하려고 할 때 발생합니다.

오류: user/repo에 부여된 권한이 other-user에 거부됨

이 오류는 푸시에 사용하는 키가 리포지토리에 액세스할 수 없는 계정에 연결되어 있음을 의미합니다.

오류: user/repo에 부여된 권한이 user/other-repo에 거부됨

이 오류는 푸시에 사용하는 키가 다른 리포지토리에 배포 키로 연결되어 있으며 푸시하려는 리포지토리에 대한 액세스 권한이 없음을 의미합니다.

오류: 에이전트가 서명 실패를 인정했습니다.

드문 경우지만 Linux에서 SSH를 통해 GitHub에 연결하면 "Agent admitted failure to sign using the key" 오류가 발생합니다. 이 문제를 해결하려면 다음 단계를 수행합니다.

오류: ssh-add: illegal option -- apple-use-keychain

이 오류는 ssh-add의 버전이 macOS 키 집합 통합을 지원하지 않음을 의미하므로 키 집합에 암호를 저장할 수 있습니다.

오류: SSL 인증서 문제, CA 인증서가 정상인지 확인

이 오류는 CA 루트 인증서가 만료됨을 의미합니다. CA 루트 인증서를 업데이트해야 하는 경우 GitHub 리포지토리에서 푸시하거나 끌어올 수 없습니다.

오류: 알 수 없는 키 유형

이 오류는 사용한 SSH 키 형식이 인식되지 않거나 SSH 클라이언트에서 지원하지 않음을 의미합니다.

오류: SSH 키 감사를 수행하고 있음

이 오류는 Git 작업을 수행하는 데 사용하는 SSH 키가 확인되지 않음을 의미합니다.