Настройка параметров сети для GitHub Copilot

Вы можете подключиться к Copilot через HTTP-прокси и использовать пользовательские сертификаты.

Кто эту функцию можно использовать?

GitHub Copilot can be managed through personal accounts with GitHub Copilot Individual, through organization or enterprise accounts with GitHub Copilot Business, or through enterprise accounts with GitHub Copilot Enterprise.

GitHub Copilot is free to use for verified students, teachers, and maintainers of popular open source projects. For more information, see "About billing for GitHub Copilot."

В этой статье

Примечание. GitHub Copilot в настоящее время недоступен для использования с Visual Studio для Mac.

Введение

По умолчанию GitHub Copilot подключается к серверу GitHubнепосредственно из среды через безопасное подключение HTTPS. Вам не обязательно нужно настроить дополнительные параметры сети для использования Copilot.

Некоторые сети используют прокси-сервер HTTP для перехвата интернет-трафика перед отправкой его в предполагаемое расположение. Компании часто используют HTTP-прокси для обнаружения подозрительного трафика или ограничения содержимого, входящего в свои сети. Если вы работаете в корпоративной сети, может потребоваться настроить Copilot для подключения через прокси-сервер HTTP.

Настройка параметров прокси-сервера для GitHub Copilot

GitHub Copilot поддерживает базовые настройки прокси-сервера HTTP. Если необходимо пройти проверку подлинности на прокси-сервере, GitHub Copilot поддерживает обычную проверку подлинности или проверку подлинности с помощью Kerberos. Если начинается URL-адрес https://прокси-сервера, прокси-сервер в настоящее время не поддерживается.

Прокси-сервер HTTP можно настроить для GitHub Copilot в выбранном редакторе. Чтобы просмотреть инструкции для редактора, используйте вкладки в верхней части этой статьи.

Если прокси-сервер не настроен непосредственно в редакторе, GitHub Copilot проверка, если URL-адрес прокси-сервера задан в любой из следующих переменных среды, перечисленных от самого высокого до низкого приоритета.

  • HTTPS_PROXY
  • https_proxy
  • HTTP_PROXY
  • http_proxy

Примечание. Для хранения URL-адреса стандартного HTTP-прокси можно использовать любую из этих переменных. В стандартном использовании http и https части этих переменных ссылаются на тип выполняемого запроса, а не URL-адрес самого прокси-сервера. GitHub Copilot не соответствует этому соглашению и использует URL-адрес, хранящийся в переменной с наивысшим приоритетом в качестве прокси-сервера для запросов HTTP и HTTPS.

Если вы настроили прокси-сервер, но по-прежнему сталкиваются с ошибками подключения, см. раздел "Устранение неполадок сети для GitHub Copilot".

Настройка прокси-сервера в интегрированной среде разработки JetBrains

  1. В интегрированной среде разработки JetBrains выберите меню "Файл" (Windows) или имя приложения в строке меню (macOS), а затем щелкните Параметры.

  2. В разделе "Внешний вид" щелкните системный Параметры и щелкните HTTP-прокси.

  3. Выберите конфигурацию прокси-сервера вручную и выберите HTTP.

  4. В поле "Имя узла" введите имя узла прокси-сервера и в поле "Номер порта" введите номер порта прокси-сервера.

  5. При необходимости, чтобы настроить Copilot, чтобы игнорировать ошибки сертификатов, на левой боковой панели нажмите кнопку "Сервис", выберите пункт " Сертификаты сервера", а затем выберите или отмените выбор ненадежных сертификатов автоматически.

    Предупреждение. Игнорировать ошибки сертификата могут вызвать проблемы с безопасностью и не рекомендуется.

Обычная проверка подлинности

GitHub Copilot для JetBrains поддерживает базовую проверку подлинности. Чтобы пройти проверку подлинности, можно выбрать проверку подлинности прокси-сервера на странице "Конфигурация прокси-сервера вручную", а затем ввести учетные данные.

При этом учетные данные хранятся в виде обычного текста в параметрах редактора. Кроме того, вы можете включить учетные данные в 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, чтобы игнорировать ошибки сертификата, в разделе "Прокси-сервер Строгий SSL" выберите или отключите поле проверка box.

    Предупреждение. Игнорировать ошибки сертификата могут вызвать проблемы с безопасностью и не рекомендуется.

Обычная проверка подлинности

GitHub Copilot для VS Code поддерживает базовую проверку подлинности. Для проверки подлинности можно включить учетные данные в URL-адрес прокси-сервера, например: http://USERNAME:PASSWORD@10.203.0.1:5187/ Этот URL-адрес можно хранить в параметрах VS Code или в одном из переменных среды, перечисленных в разделе "Настройка параметров прокси-сервера для GitHub Copilot".

Настройка прокси-сервера в Visual Studio

GitHub Copilot для Visual Studio считывает параметры прокси-сервера из Windows. Сведения о настройке параметров прокси-сервера в Windows см. в разделе "Настройка подключения прокси-сервера вручную" в разделе "Использование прокси-сервера в 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) для уникальной идентификации экземпляра службы. По умолчанию имя субъекта-службы является производным от URL-адреса прокси-сервера. Например, если URL-адрес прокси-сервера имеет значение http://proxy.example.com:3128, имя субъекта-службы — HTTP/proxy.example.comэто .

Если имя субъекта-службы по умолчанию не правильно для прокси-сервера, вы можете переопределить имя участника-службы в VS Code и в идентификаторах JetBrains. В настоящее время невозможно переопределить имя субъекта-службы по умолчанию в Visual Studio. Однако можно использовать переменную AGENT_KERBEROS_SERVICE_PRINCIPAL среды для переопределения имени субъекта-службы для Visual Studio и идентификаторов JetBrains.

Переопределение имени субъекта-службы по умолчанию в VS Code

  1. Откройте VS Code Command Palette, нажав клавиши SHIFT COMMAND+P (Mac) / CTRL+SHIFT++P (Windows/Linux).

  2. Введите settingsи нажмите кнопку "Параметры": открыть Параметры пользователя (JSON).

  3. В объекте JSON добавьте следующее свойство верхнего уровня, заменив YOUR-SPN правильное имя субъекта-службы для прокси-службы.

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

Переопределение имени субъекта-службы по умолчанию в idEs JetBrains

  1. В интегрированной среде разработки JetBrains выберите меню "Файл" (Windows) или имя приложения в строке меню (macOS), а затем щелкните Параметры.
  2. На левой боковой панели щелкните Языки и платформы, а затем щелкните GitHub Copilot.
  3. В разделе "Дополнительно" в поле "Переопределение имени субъекта-службы прокси-службы Kerberos" введите имя субъекта-службы для прокси-службы.

Разрешение GitHub Copilot использовать пользовательские сертификаты

Copilot может считывать пользовательские SSL-сертификаты, установленные на компьютере пользователя. Это позволяет идентифицировать прокси-сервер как предполагаемый получатель Copilotбезопасного подключения, чтобы можно было проверить сетевой трафик. Без пользовательского сертификата прокси-сервер HTTP можно использовать для мониторинга, маршрутизации и завершения подключения Copilot, но не для проверки содержимого трафика.

Copilot считывает сертификаты из хранилища доверия операционной системы. Он также считывает дополнительные сертификаты из файла, указанного стандартной переменной NODE_EXTRA_CA_CERTSсреды Node.js. Дополнительные сведения см. в документации по Node.js.

Copilot может считывать сертификаты независимо от того, настроен ли прокси-сервер непосредственно на компьютере пользователя. Это позволяет Copilot поддерживать такие настройки, как прозрачные прокси-серверы или Zscaler.

Установка пользовательских сертификатов

Как правило, если вы используете оборудование компании, ИТ-отдел вашей компании должен уже установить на компьютере все необходимые сертификаты. Если вам нужно установить сертификат, ознакомьтесь со следующими инструкциями.

Предупреждение. Установка пользовательского сертификата — это инструкция для вашего компьютера, чтобы доверять создателю сертификата, что потенциально позволяет создателю перехватывать весь интернет-трафик с компьютера. Убедитесь, что вы устанавливаете правильный сертификат.

Если вы установили сертификат, но Copilot не обнаруживает его, см. раздел "AUTOTITLE".