{"meta":{"title":"GitHub Copilot에 대한 네트워크 설정 구성","intro":"HTTP 프록시를 GitHub Copilot 통해 연결하고 사용자 지정 인증서를 사용할 수 있습니다.","product":"GitHub Copilot","breadcrumbs":[{"href":"/ko/copilot","title":"GitHub Copilot"},{"href":"/ko/copilot/how-tos","title":"방법"},{"href":"/ko/copilot/how-tos/configure-personal-settings","title":"개인 설정 구성"},{"href":"/ko/copilot/how-tos/configure-personal-settings/configure-network-settings","title":"네트워크 설정 구성"}],"documentType":"article"},"body":"# GitHub Copilot에 대한 네트워크 설정 구성\n\nHTTP 프록시를 GitHub Copilot 통해 연결하고 사용자 지정 인증서를 사용할 수 있습니다.\n\n
\n\n> \\[!NOTE] GitHub Copilot은(는) 현재 Mac용 Visual Studio를 통해 사용할 수 없습니다.\n\n
\n\nHTTP 프록시를 Copilot 통해 연결하고 사용자 지정 인증서를 사용할 수 있습니다. 프록시 서버가 필요한 회사 네트워크에서 작업하거나 '보안 연결의 Copilot콘텐츠를 검사해야 하는 경우 유용합니다.\n[GitHub Copilot에 대한 네트워크 설정](/ko/copilot/concepts/network-settings) 참조하세요.\n\n## Copilot에 대한 프록시 설정 구성\n\n선택한 편집기에서 HTTP 프록시를 Copilot 구성할 수 있습니다. 편집기에 대한 지침을 보려면 이 문서 상단의 탭을 사용하세요.\n\n
\n\n1. JetBrains IDE에서 **파일** 메뉴(Windows) 또는 메뉴 모음(macOS)에서 애플리케이션의 이름을 클릭한 다음 설정\\*\\* 클릭합니다\\*\\*.\n2. **모양 및 동작**에서 **시스템 설정** 클릭한 다음 **HTTP 프록시**를 클릭합니다.\n3. **수동 프록시 구성**을 선택한 다음 **HTTP**를 선택합니다.\n4. \"호스트 이름\" 필드에 프록시 서버의 호스트 이름을 입력하고 \"포트 번호\" 필드에 프록시 서버의 포트 번호를 입력합니다.\n5. 필요에 따라 인증서 오류를 무시하도록 구성 Copilot 하려면 왼쪽 사이드바에서 **모양 및 동작**을 클릭하고 **시스템 설정을** 클릭한 다음 **서버 인증서**를 클릭한 다음 **신뢰할 수 없는 인증서 허용을 자동으로** 선택하거나 선택 취소합니다.\n\n > \\[!WARNING] 인증서 오류를 무시하면 보안 문제가 발생할 수 있으므로 권장하지 않습니다.\n\n프록시를 구성했지만 여전히 연결 오류가 발생하는 경우 [GitHub Copilot에 대한 네트워크 오류 문제 해결](/ko/copilot/how-tos/troubleshoot-copilot/troubleshoot-network-errors#troubleshooting-proxy-errors) 참조하세요.\n\n### 기본 인증\n\nCopilot JetBrains는 기본 인증을 지원합니다. 인증하려면 \"수동 프록시 구성\" 페이지에서 프록시 인증\\*\\*을 선택한 \\*\\*다음 자격 증명을 입력할 수 있습니다.\n\n이렇게 하면 자격 증명이 편집기 설정에 일반 텍스트로 저장됩니다. 또는 프록시 URL(예: `http://USERNAME:PASSWORD@10.203.0.1:5187/`)에 자격 증명을 포함하고 이 URL을 [프록시 설정 Copilot](/ko/copilot/concepts/network-settings#proxy-settings-for-copilot)에 나열된 지원되는 환경 변수 중 하나로 설정하는 것이 좋습니다.\n\n
\n\n
\n\n1. **파일** 메뉴에서 **기본 설정**으로 이동하고 **설정**을 클릭합니다.\n\n ![Visual Studio Code 설정의 스크린샷입니다.](/assets/images/help/copilot/vsc-settings.png)\n2. 설정 탭의 왼쪽 패널에서 **\\[응용 프로그램]** 을 클릭한 다음 **\\[프록시]** 을 선택합니다.\n3. \"Proxy\" 아래의 텍스트 상자에 프록시 서버의 주소를 다음과 같이 입력합니다 `http://localhost:3128`.\n4. 필요에 따라 인증서 오류를 무시하도록 구성 Copilot 하려면 \"프록시 엄격한 SSL\"에서 확인란을 선택하거나 선택 취소합니다.\n\n > \\[!WARNING] 인증서 오류를 무시하면 보안 문제가 발생할 수 있으므로 권장하지 않습니다.\n\n프록시를 구성했지만 여전히 연결 오류가 발생하는 경우 [GitHub Copilot에 대한 네트워크 오류 문제 해결](/ko/copilot/how-tos/troubleshoot-copilot/troubleshoot-network-errors#troubleshooting-proxy-errors) 참조하세요.\n\n### 기본 인증\n\nCopilot용 VS Code는 기본 인증을 지원합니다. 인증하려면 다음과 같이 `http://USERNAME:PASSWORD@10.203.0.1:5187/`프록시 URL에 자격 증명을 포함할 수 있습니다. 이 URL은 설정 VS Code 또는 [프록시 설정 Copilot](/ko/copilot/concepts/network-settings#proxy-settings-for-copilot)에 나열된 환경 변수 중 하나에 저장할 수 있습니다.\n\n
\n\n
\n\nCopilot용 Visual Studio는 Windows에서 프록시 설정을 읽습니다. Windows에서 프록시 설정을 구성하는 방법에 대한 자세한 내용은 Microsoft 설명서에서 Windows[의 프록시 서버 사용에서 ](https://support.microsoft.com/en-us/windows/use-a-proxy-server-in-windows-03096c53-0554-4ffe-b6ab-8b1deee8dae1)\"프록시 서버 연결을 수동으로 설정하려면\"의 지침을 참조하세요.\n\n프록시를 구성했지만 여전히 연결 오류가 발생하는 경우 [GitHub Copilot에 대한 네트워크 오류 문제 해결](/ko/copilot/how-tos/troubleshoot-copilot/troubleshoot-network-errors#troubleshooting-proxy-errors) 참조하세요.\n\n### 기본 인증\n\nCopilot가 Windows에서 Visual Studio의 프록시 설정을 읽어 오더라도, 해당 Windows 설정에서 인증 자격 증명은 가져오지 않습니다.\n\n프록시에 인증해야 하는 경우 아래 중 하나를 시도해 볼 수 있습니다.\n\n1. 환경 변수 `COPILOT_USE_DEFAULTPROXY`을(를) `true`로(으로) 설정하여 기본 프록시 자격 증명 전달을 사용하도록 설정합니다.\n * **Windows 예**:명령 프롬프트를 열고 다음 명령을 실행합니다.\n\n ```bash\n setx COPILOT_USE_DEFAULTPROXY true\n ```\n\n 이를 통해 사용자 계정에 대한 변수가 영구적으로 설정됩니다. 이 변수를 사용해야 하는 애플리케이션을 다시 시작합니다.\n2. 프록시 URL(예: `http://USERNAME:PASSWORD@10.203.0.1:5187/`)에 자격 증명을 포함한 다음, 이 URL을 [프록시 설정 Copilot](/ko/copilot/concepts/network-settings#proxy-settings-for-copilot)에 나열된 지원되는 환경 변수 중 하나로 설정할 수 있습니다.\n\n
\n\n
\n\n### VS Code에서 기본 SPN 재정의\n\n1. VS Code Command Palette Shift+명령+P(Mac) /Ctrl+Shift+P(Windows/Linux)를 눌러 엽니다.\n2. `settings`를 입력한 다음 **기본 설정: 사용자 설정 열기(JSON)** 을 클릭합니다.\n3. JSON 개체에서 프록시 서비스에 대한 올바른 SPN으로 대체 `YOUR-SPN` 하여 다음 최상위 속성을 추가합니다.\n\n ```json copy\n \"http.proxyKerberosServicePrincipal\": \"YOUR-SPN\",\n ```\n\n
\n\n
\n\n### JetBrains IDE에서 기본 SPN 재정의\n\n1. JetBrains IDE에서 **파일** 메뉴(Windows) 또는 메뉴 모음(macOS)에서 애플리케이션의 이름을 클릭한 다음 설정\\*\\* 클릭합니다\\*\\*.\n\n2. 왼쪽 사이드바에서 **툴**을 클릭하고 **GitHub Copilot** 를 클릭합니다.을 클릭한 다음 **네트워크를** 클릭합니다.\n\n3. \"Kerberos 프록시 서비스 주체 이름 재정의\" 필드에 프록시 서비스에 대한 SPN을 입력합니다.\n\n
\n\n## 사용자 지정 인증서 설치\n\n일반적으로 회사 장비를 사용하는 경우, 회사의 IT 부서에서 이미 필요한 인증서를 사용자 기기에 설치했을 것입니다. 인증서를 설치해야 하는 경우 다음 안내를 참조하세요.\n\n> \\[!WARNING] 사용자 지정 인증서를 설치하는 것은 컴퓨터가 인증서 작성자를 신뢰하도록 지시하는 것으로, 인증서 작성자가 컴퓨터의 모든 인터넷 트래픽을 가로채도록 허용할 수 있습니다. 올바른 인증서를 설치하고 있는지 매우 주의해서 확인해야 합니다.\n\n* Windows의 경우 Microsoft 설명서에서 신뢰할 수 있는 루트 인증서[ 설치를 참조](https://learn.microsoft.com/en-us/skype-sdk/sdn/articles/installing-the-trusted-root-certificate)하세요.\n* macOS의 경우 [ Mac에서 키 집합 Access 사용하여 키 집합에 인증서 추가](https://support.apple.com/en-gb/guide/keychain-access/kyca2431/mac) 키 집합 Access 사용자 가이드를 참조하세요.\n* Linux의 경우 Ubuntu 설명서 [의 신뢰 저장소에 루트 CA 인증서 설치](https://ubuntu.com/server/docs/how-to/security/install-a-root-ca-certificate-in-the-trust-store/) 를 참조하세요. 대부분의 Linux 배포판에도 비슷한 지침이 적용되어야 합니다.\n\n인증서를 설치했지만 Copilot 검색하지 않는 경우 [GitHub Copilot에 대한 네트워크 오류 문제 해결](/ko/copilot/how-tos/troubleshoot-copilot/troubleshoot-network-errors#troubleshooting-certificate-related-errors)을 참조하세요."}