# 오류: 권한이 거부됨(publickey)
“사용 권한이 거부됨” 오류는 서버가 연결을 거부했음을 의미합니다. 여러 이유가 있을 수 있으며 가장 일반적인 예시는 아래에 설명되어 있습니다.
## Git에서 `sudo` 명령 또는 상승된 권한을 사용해야 하나요?
Git에서 `sudo` 명령 또는 상승된 권한(예: 관리자 권한)을 사용하면 안 됩니다.
\_
\_를 사용해야 할 타당한 이유가 있는 경우 모든 명령에 사용하고 있는지 확인합니다. SSH 키를 [생성하지 않고](/ko/enterprise-server@3.22/authentication/connecting-to-github-with-ssh)`sudo` 그런 다음 `sudo git push` 사용하려고 하면, 생성한 것과 동일한 키를 사용하지 않게 됩니다.
## 올바른 서버에 연결하고 있는지 확인합니다.
올바른 도메인에 연결하고 있는지 확인하기 위해 다음 명령을 입력할 수 있습니다.
```shell copy
ssh -vT git@HOSTNAME
```
다음 출력이 표시됩니다.
```shell
> OpenSSH_8.1p1, LibreSSL 2.7.3
> debug1: Reading configuration data /Users/YOU/.ssh/config
> debug1: Reading configuration data /etc/ssh/ssh_config
> debug1: /etc/ssh/ssh_config line 47: Applying options for *
> debug1: Connecting to HOSTNAME port 22.
```
포트 22에서 연결해야 합니다.
## 항상 “git” 사용자 사용
원격 URL 연결을 비롯한 모든 연결은 “git” 사용자로 만들어야 합니다. GitHub 사용자 이름을 사용하여 연결하려고 하면 실패합니다.
```shell
$ ssh -T GITHUB-USERNAME@HOSTNAME
> Permission denied (publickey).
```
연결에 실패하고 GitHub 사용자 이름으로 원격 URL을 사용하는 경우 ["git" 사용자를 사용하도록 원격 URL을 변경](/ko/enterprise-server@3.22/get-started/git-basics/managing-remote-repositories)할 수 있습니다.
다음을 입력하여 연결을 확인해야 합니다.
```shell copy
ssh -T git@HOSTNAME
```
다음 출력이 표시됩니다.
```shell
> Hi USERNAME! You've successfully authenticated...
```
## 사용 중인 키가 있는지 확인합니다.
1. 터미널터미널Git Bash를 엽니다.
2. 프라이빗 키가 생성되어 SSH에 로드되었는지 확인합니다.
```shell
# start the ssh-agent in the background
$ eval "$(ssh-agent -s)"
> Agent pid 59566
$ ssh-add -l -E sha256
> 2048 SHA256:274ffWxgaxq/tSINAykStUL7XWyRNcRTlcST1Ei7gBQ /Users/USERNAME/.ssh/id_rsa (RSA)
```
[GitHub Desktop](https://desktop.github.com/)이 설치된 경우 이를 사용하여 리포지토리를 복제하고 SSH 키를 처리하지 않을 수 있습니다.
1. **Git Bash를 사용하는 경우** ssh-agent를 켭니다.
```shell
# start the ssh-agent in the background
$ eval "$(ssh-agent -s)"
> Agent pid 59566
```
[Git for Windows](https://git-for-windows.github.io/) 등의 **다른 터미널 프롬프트를 사용하는 경우** ssh-agent를 켭니다.
```shell
# start the ssh-agent in the background
$ eval $(ssh-agent -s)
> Agent pid 59566
```
> \[!NOTE]
> 위의 eval 명령은 사용자 환경에서 ssh-agent를 수동으로 시작합니다. ssh-agent가 이미 백그라운드 시스템 서비스로 실행 중이면 해당 명령이 작동하지 않을 수 있습니다. 이 경우 사용자 환경 관련 문서를 확인해 보세요.
2. 프라이빗 키가 생성되어 SSH에 로드되었는지 확인합니다.
```shell
$ ssh-add -l -E sha256
> 2048 SHA256:274ffWxgaxq/tSINAykStUL7XWyRNcRTlcST1Ei7gBQ /Users/USERNAME/.ssh/id_rsa (RSA)
```
1. 터미널터미널Git Bash를 엽니다.
2. 프라이빗 키가 생성되어 SSH에 로드되었는지 확인합니다.
```shell
$ ssh-add -l -E sha256
> 2048 SHA256:274ffWxgaxq/tSINAykStUL7XWyRNcRTlcST1Ei7gBQ /Users/USERNAME/.ssh/id_rsa (RSA)
```
`ssh-add` 명령은 숫자와 문자로 이루어진 긴 문자열을 출력해야 합니다. 아무것도 출력되지 않는 경우 [새 SSH 키를 생성](/ko/enterprise-server@3.22/authentication/connecting-to-github-with-ssh/generating-a-new-ssh-key-and-adding-it-to-the-ssh-agent)하여 GitHub와 연결해야 합니다.
> \[!TIP]
> 대부분의 시스템에서는 기본 프라이빗 키(`~/.ssh/id_rsa` 및 `~/.ssh/identity`)가 SSH 인증 에이전트에 자동으로 추가됩니다. 키를 생성할 때 파일 이름을 재정의하지 않는 한, `ssh-add path/to/key`를 실행할 필요는 없습니다.
### 자세한 정보 가져오기
`git@HOSTNAME`에 연결을 시도하여 키가 사용되고 있는지 확인할 수도 있습니다.
```shell copy
ssh -vT git@HOSTNAME
```
다음과 같은 출력이 표시됩니다.
```shell
> ...
> debug1: identity file /Users/YOU/.ssh/id_rsa type -1
> debug1: identity file /Users/YOU/.ssh/id_rsa-cert type -1
> debug1: identity file /Users/YOU/.ssh/id_dsa type -1
> debug1: identity file /Users/YOU/.ssh/id_dsa-cert type -1
> ...
> debug1: Authentications that can continue: publickey
> debug1: Next authentication method: publickey
> debug1: Trying private key: /Users/YOU/.ssh/id_rsa
> debug1: Trying private key: /Users/YOU/.ssh/id_dsa
> debug1: No more authentication methods to try.
> Permission denied (publickey).
```
이 예제에서는 SSH가 키를 찾지 못했습니다.
* “ID 파일” 줄의 끝에 있는 “-1”은 SSH에서 사용할 파일을 찾을 수 없었음을 의미합니다.
* “Trying private key(프라이빗 키 시도 중)” 줄은 파일을 찾을 수 없음을 나타냅니다.
파일이 있는 경우 해당 줄은 다음 출력과 같이 “1”과 “Offering public key(퍼블릭 키 제공 중)”가 됩니다.
```shell
> ...
> debug1: identity file /Users/YOU/.ssh/id_rsa type 1
> ...
> debug1: Authentications that can continue: publickey
> debug1: Next authentication method: publickey
> debug1: Offering RSA public key: /Users/YOU/.ssh/id_rsa
```
## 퍼블릭 키가 계정에 연결되었는지 확인합니다.
보안 연결을 설정하려면 GitHub에 퍼블릭 키를 제공해야 합니다.
GitHub에 퍼블릭 키가 표시되지 않는 경우 [GitHub에 SSH 키를 추가](/ko/enterprise-server@3.22/authentication/connecting-to-github-with-ssh/adding-a-new-ssh-key-to-your-github-account)하여 컴퓨터와 연결해야 합니다.
> \[!WARNING]
> GitHub에 익숙하지 않은 SSH 키가 표시되는 경우 즉시 삭제하고, 추가 도움이 필요하면 을 통해 Microsoft에 문의하세요. 식별되지 않은 퍼블릭 키는 가능한 보안 문제를 나타낼 수 있습니다. 자세한 내용은 [SSH 키 검토](/ko/enterprise-server@3.22/authentication/keeping-your-account-and-data-secure/reviewing-your-ssh-keys)을(를) 참조하세요.