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

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

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

GitHub Copilot Individual или GitHub Copilot Business.

В этой статье

Note

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

Введение

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

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

Note

Администратор прокси-сервера или брандмауэра также должен настроить параметры сети для Copilot для работы должным образом. См. раздел "Настройка прокси-сервера или брандмауэра для Copilot".

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

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

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

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

  • HTTPS_PROXY
  • https_proxy
  • HTTP_PROXY
  • http_proxy

Note

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

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

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

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

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

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

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

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

    Warning

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

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

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", установите или отключите флажок.

    Warning

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

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

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.

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

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

Warning

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

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