GitHub Copilot의 네트워크 설정 구성하기

HTTP 프록시를 통해 Copilot에 연결하고 사용자 지정 인증서를 사용할 수 있습니다.

누가 이 기능을 사용할 수 있나요?

GitHub Copilot Individual 또는 GitHub Copilot Business.

이 문서의 내용

Note

GitHub Copilot은(는) 현재 Mac용 Visual Studio를 통해 사용할 수 없습니다.

소개

기본적으로 Copilot은(는) 보안 HTTPS 연결을 통해 사용자 환경에서 GitHub의 서버에 직접 연결합니다. 데이터 변수 Copilot를 사용하기 위해 추가 네트워크 설정을 구성할 필요는 없습니다.

일부 네트워크에서는 HTTP 프록시 서버를 사용하여 인터넷 트래픽을 가로채서 의도한 위치로 전송합니다. 기업에서는 의심스러운 트래픽을 탐지하거나 네트워크에 유입되는 콘텐츠를 제한하기 위해 HTTP 프록시를 사용하는 경우가 많습니다. 회사 네트워크에서 작업하는 경우 HTTP 프록시를 통해 연결하도록 Copilot를 구성해야 할 수 있습니다.

Note

또한 프록시 서버 또는 방화벽 관리자는 Copilot이(가) 예상대로 작동하도록 네트워크 설정을 구성해야 합니다. "Copilot에 대한 프록시 서버 또는 방화벽 구성" 항목을 참조하세요.

데이터 변수에 대한 프록시 설정 구성 GitHub Copilot

GitHub Copilot은 기본 HTTP 프록시 설정을 지원합니다. 프록시에 인증해야 하는 경우 GitHub Copilot은 기본 인증 또는 Kerberos를 사용한 인증을 지원합니다. 프록시 URL이 https://시작되면 프록시는 현재 지원되지 않습니다.

선택한 편집기에서 GitHub Copilot에 대한 HTTP 프록시를 구성할 수 있습니다. 편집기에 대한 지침을 보려면 이 문서 상단의 탭을 사용하세요.

편집기에서 직접 프록시를 구성하지 않으면 GitHub Copilot은 우선순위가 높은 순서대로 나열된 다음 환경 변수 중 하나에 프록시 URL이 설정되어 있는지 확인합니다.

  • HTTPS_PROXY
  • https_proxy
  • HTTP_PROXY
  • http_proxy

Note

이러한 변수 중 하나를 사용하여 표준 HTTP 프록시의 URL을 저장할 수 있습니다. 표준 사용 http 에서 이러한 변수의 일부 및 https 부분은 프록시 자체의 URL이 아니라 수행되는 요청 유형을 나타냅니다. GitHub Copilot은(는) 이 규칙을 따르지 않으며, 우선순위가 가장 높은 변수에 저장된 URL을 HTTP 및 HTTPS 요청 모두에 대한 프록시로 사용합니다.

프록시를 구성했지만 연결 오류가 여전히 발생하는 경우 "GitHub Copilot의 네트워크 오류 문제 해결하기" 항목을 참조하세요.

JetBrains IDE에서 프록시 구성하기

  1. JetBrains IDE에서 파일 메뉴(Windows) 또는 메뉴 모음(macOS)에서 애플리케이션의 이름을 클릭한 다음 설정** 클릭합니다**.

  2. 모양 및 동작에서 시스템 설정 클릭한 다음 HTTP 프록시를 클릭합니다.

  3. 수동 프록시 구성을 선택한 다음 HTTP를 선택합니다.

  4. "호스트 이름" 필드에 프록시 서버의 호스트 이름을 입력하고 "포트 번호" 필드에 프록시 서버의 포트 번호를 입력합니다.

  5. 필요에 따라 인증서 오류를 무시하도록 Copilot을(를) 구성하려면 왼쪽 사이드바에서 도구를** 클릭하고 서버 인증서를 클릭한 다음 신뢰할 수 없는 인증서 수락을 자동으로 선택하거나 선택 취소**합니다.

    Warning

    인증서 오류를 무시하면 보안 문제가 발생할 수 있으므로 권장하지 않습니다.

기본 인증

JetBrains용 GitHub Copilot은 기본 인증을 지원합니다. 인증하려면 "수동 프록시 구성" 페이지에서 프록시 인증**을 선택한 **다음 자격 증명을 입력할 수 있습니다.

이렇게 하면 자격 증명이 편집기 설정에 일반 텍스트로 저장됩니다. 또는 프록시 URL(예: http://USERNAME:PASSWORD@10.203.0.1:5187/)에 자격 증명을 포함하고 이 URL을 "GitHub Copilot에 대한 프록시 설정 구성"에 나열된 지원되는 환경 변수 중 하나로 설정하는 것이 좋습니다.

데이터 변수에 프록시 구성하기 Visual Studio Code

  1. 파일 메뉴에서 기본 설정으로 이동하고 설정을 클릭합니다.

    Visual Studio Code 설정의 스크린샷입니다.

  2. 설정 탭의 왼쪽 패널에서 [응용 프로그램] 을 클릭한 다음 [프록시] 을 선택합니다.

  3. "프록시" 아래의 텍스트 상자에 프록시 서버의 주소를 다음과 같이 입력합니다 http://localhost:3128.

  4. 선택 사항으로 인증서 오류를 무시하도록 Copilot를 구성하려면 "Proxy Strict SSL" 아래에서 확인란을 선택하거나 선택을 취소합니다.

    Warning

    인증서 오류를 무시하면 보안 문제가 발생할 수 있으므로 권장하지 않습니다.

기본 인증

데이터 변수 GitHub Copilot에 대한 VS Code은(는) 기본 인증을 지원합니다. 인증하려면 다음과 같이 http://USERNAME:PASSWORD@10.203.0.1:5187/프록시 URL에 자격 증명을 포함할 수 있습니다. 이 URL은 VS Code 설정 또는 "GitHub Copilot에 대한 프록시 설정 구성"에 나열된 환경 변수 중 하나에 저장할 수 있습니다.

데이터 변수에 프록시를 구성하는 중 Visual Studio입니다.

데이터 변수에 대한 GitHub Copilot Visual Studio에 대한 프록시 설정을 Windows에서 읽습니다. Windows에서 프록시 설정을 구성하는 방법에 대한 자세한 내용은 Microsoft 설명서에서 Windows의 프록시 서버 사용에서 "프록시 서버 연결을 수동으로 설정하려면"의 지침을 참조하세요.

기본 인증

데이터 변수 GitHub Copilot에 대한 Visual Studio이(가) Windows 설정에서 인증 자격 증명을 검색하지 못했습니다. 프록시에 인증해야 하는 경우 프록시 URL에 자격 증명을 포함할 수 있습니다(예: http://USERNAME:PASSWORD@10.203.0.1:5187/). 그런 다음 이 URL을 "GitHub Copilot에 대한 프록시 설정 구성"에 나열된 지원되는 환경 변수 중 하나로 설정합니다.

Kerberos를 사용한 인증

Kerberos는 사용자와 서비스가 서로의 신원을 증명할 수 있는 인증 프로토콜입니다. 사용자가 인증에 성공하면 인증 서비스는 사용자에게 일정 기간 동안 서비스에 액세스할 수 있는 티켓을 부여합니다. 네트워크 관리자는 더 안전하고 암호화되지 않은 자격 증명을 전송할 필요가 없기 때문에 기본 인증보다 Kerberos를 선호할 수 있습니다.

GitHub Copilot은 Kerberos를 사용하여 프록시에 대한 인증을 지원합니다. Kerberos를 사용하려면 컴퓨터에 설치된 운영 체제에 적합한 krb5 라이브러리와 프록시 서비스에 대한 활성 티켓(kinit 명령을 사용하여 수동으로 만들거나 다른 애플리케이션에 의해 생성됨)이 있어야 합니다. 프록시 서비스에 대한 티켓이 klist 있는 경우 이 명령을 사용하여 검사 수 있습니다.

Kerberos는 SPN(서비스 주체 이름)을 사용하여 서비스 인스턴스를 고유하게 식별합니다. 기본적으로 SPN은 프록시 URL에서 파생됩니다. 예를 들어 URL이 http://proxy.example.com:3128인 경우 HTTP/proxy.example.com는 입니다.

기본 SPN이 프록시에 맞지 않는 경우 VS Code 및 JetBrains IDE에서 SPN을 재정의할 수 있습니다. 현재 Visual Studio에서 기본 SPN을 재정의할 수 없습니다. 그러나 환경 변수 AGENT_KERBEROS_SERVICE_PRINCIPAL을 사용하여 Visual Studio 및 JetBrains IDE에 대한 SPN을 재정의할 수 있습니다.

데이터 변수 VS Code에서 기본 SPN 재정의하기

  1. Shift+Command+P (Mac) / Ctrl+Shift+P (Windows/Linux)를 눌러 VS Code Command Palette을 엽니다.

  2. 를 입력 settings한 다음 기본 설정을 클릭합니다. JSON(사용자 설정 열기).

  3. JSON 개체에서 프록시 서비스에 대한 올바른 SPN으로 대체 YOUR-SPN 하여 다음 최상위 속성을 추가합니다.

    JSON
    "http.proxyKerberosServicePrincipal": "YOUR-SPN",

JetBrains IDE에서 기본 SPN 재정의

  1. JetBrains IDE에서 파일 메뉴(Windows) 또는 메뉴 모음(macOS)에서 애플리케이션의 이름을 클릭한 다음 설정** 클릭합니다**.
  2. 왼쪽 사이드바에서 [언어 및 프레임워크] 를 클릭한 다음 GitHub Copilot를 클릭합니다.
  3. "고급" 섹션의 "Kerberos 프록시 서비스 주체 이름 재정의" 필드에 프록시 서비스의 SPN을 입력합니다.

데이터 변수 GitHub Copilot에서 사용자 지정 인증서를 사용하도록 허용하기

Copilot은(는) 사용자의 컴퓨터에 설치된 사용자 지정 SSL 인증서를 읽을 수 있습니다. 이를 통해 프록시 서버를 Copilot의 보안 연결의 의도된 수신자로 식별할 수 있으므로 네트워크 트래픽을 검사할 수 있습니다. 사용자 지정 인증서가 없으면 HTTP 프록시를 사용하여 Copilot의 연결을 모니터링, 라우팅 및 종료할 수 있지만 트래픽의 내용은 검사할 수 없습니다.

Copilot는 운영 체제의 신뢰 저장소에서 인증서를 읽습니다. 또한 표준 Node.js 환경 변수 NODE_EXTRA_CA_CERTS로 지정된 파일에서 추가 인증서를 읽습니다. 자세한 내용은 Node.js 설명서 항목을 참조하세요.

Copilot은(는) 사용자 컴퓨터에 프록시가 직접 구성되어 있는지 여부에 관계없이 인증서를 읽을 수 있습니다. 따라서 Copilot은(는) 투명 프록시 또는 Zscaler와 같은 설정을 지원할 수 있습니다.

사용자 지정 인증서 설치

일반적으로 회사 장비를 사용하는 경우, 회사의 IT 부서에서 이미 필요한 인증서를 사용자 기기에 설치했을 것입니다. 인증서를 설치해야 하는 경우 다음 안내를 참조하세요.

Warning

사용자 지정 인증서를 설치하는 것은 컴퓨터가 인증서 작성자를 신뢰하도록 지시하는 것으로, 인증서 작성자가 컴퓨터의 모든 인터넷 트래픽을 가로채도록 허용할 수 있습니다. 올바른 인증서를 설치하고 있는지 매우 주의해서 확인해야 합니다.

인증서를 설치했지만 Copilot이(가) 검색되지 않는 경우 "GitHub Copilot의 네트워크 오류 문제 해결하기" 항목을 참조하세요.