Использование прокси-сервера для исходящего запроса
Начиная с версии 9.3.4, ThingWorx Platform поддерживает HTTP/HTTPS-прокси для большинства исходящих запросов. Некоторые области ThingWorx Platform, например ContentLoaderFunctions, поддерживают явный прокси. Если явный прокси не предоставлен, ThingWorx Platform использует прокси, сконфигурированный для ThingWorx Platform, если имеется.
 |
В настоящее время явный прокси поддерживается только для ThingWorx Platform. Использование поддержки прокси с решениями, такими как DPM, в настоящее время не поддерживается и может привести к непредвиденным результатам.
|
Функциональность прокси ThingWorx Platform не поддерживает прокси, для которых требуется аутентификация. Прокси в настоящее время не поддерживает единый вход и службу каталогов ActiveDirectory. Чтобы изменить поддержку прокси с помощью настроек JVM, перезапустите ThingWorx Platform после внесения изменений.
Конфигурация
Поддержка прокси использует базовую поддержку среды выполнения Java, заданную системными свойствами Java при запуске ThingWorx Platform. Добавьте системные свойства Java -Dkey=value системы в Apache Tomcat. Расположение для добавления свойств зависит от установленной операционной системы. Можно сконфигурировать несколько свойств прокси в зависимости от требуемой настройки прокси. Дополнительные сведения см. в документации Java.
HTTP/HTTPS-прокси
При запросе ресурсов HTTP в ThingWorx Platform используется сконфигурированный HTTP-прокси. Системные свойства Java http.proxyHost и http.proxyPort определяют хост-компьютер и порт соответственно. Задается http.nonProxyHosts, чтобы включить все ресурсы, которые не должны проходить через прокси. Полезно иметь только внутренние ресурсы, к которым требуется доступ ThingWorx Platform. Разделяйте значения с помощью вертикальной черты (|). Значение по умолчанию http.nonProxyHosts включает все варианты, которые используются для доступа к локальной системе (localhost|127.*|[::1]). Укажите значения по умолчанию вместе со всеми пользовательскими значениями, которые необходимо добавить.
ThingWorx Platform использует сконфигурированный HTTPS-прокси при запросе ресурсов HTTPS. Системные свойства Java https.proxyHost и https.proxyPort определяют хост-компьютер и порт соответственно. HTTPS-прокси использует тот же список хостов, не являющихся прокси, что и HTTP (http.nonProxyHosts).
|
|
PTC настоятельно рекомендует использовать https-прокси.
|
Использование настроек прокси хоста
В среде выполнения Java можно также использовать настройку прокси, определенную в хосте вместо непосредственного конфигурирования прокси-серверов HTTP/HTTPS. Чтобы включить конфигурации прокси в настройках операционной системы, в разделе CATALINA_OPTS задайте для системного свойства Java true значение java.net.useSystemProxies. Настройки операционной системы позволяют создавать комплексные настройки прокси, использующие файлы автоматической конфигурации прокси (PAC) и автообнаружение веб-прокси (WPAD), которые могут использоваться в хост-системе.
Если конфигурация ThingWorx Platform настроена на использование параметров прокси хост-компьютера, то во время выполнения прокси может измениться.
Использование настроек прокси хоста для контейнеров
У контейнера, работающего в среде Docker или Kubernetes, нет видимости для фактической системы хоста. Поэтому использование настроек прокси хоста может привести к непреднамеренным результатам. Если для контейнера требуется исходящий прокси, он должен быть сконфигурирован непосредственно через свойства HTTP/HTTPS-прокси для Apache Tomcat. Используйте переменную среды CATALINA_OPTS, чтобы сконфигурировать эти системные свойства Java.