아웃바운드 요청에 프록시 서버 사용
9.3.4부터 ThingWorx Platform에서 대부분의 아웃바운드 요청에 대해 HTTP/HTTPS 프록시를 지원합니다. ThingWorx Platform의 일부 영역에서는 명시적 프록시를 지원합니다(예: ContentLoaderFunctions). 명시적 프록시가 제공되지 않으면 ThingWorx Platform에서는 ThingWorx Platform용으로 구성된 프록시를 사용합니다(있는 경우).
 |
현재 명시적 프록시는 ThingWorx Platform에서만 지원됩니다. DPM과 같은 솔루션에 프록시 지원을 사용하는 것은 현재 지원되지 않으며 사용 시 예기치 않은 결과가 발생할 수 있습니다.
|
ThingWorx Platform 프록시 기능은 인증이 필요한 프록시를 지원하지 않습니다. 프록시 서버는 현재 Single Sign-On 및 ActiveDirectory DirectoryService를 지원하지 않습니다. JVM 설정을 사용하여 프록시 지원을 변경하려면 변경한 후 ThingWorx Platform을 다시 시작합니다.
구성
프록시 지원은 ThingWorx Platform을 시작할 때 Java 시스템 속성에 의해 지정된 Java 런타임의 기본 지원을 사용합니다. Java 시스템 속성을 Apache Tomcat에 -Dkey=value로 추가합니다. 이 속성을 추가할 위치는 설치된 운영 체제에 따라 다릅니다. 필요한 특정 프록시 설정에 따라 몇 가지 프록시 속성을 구성할 수 있습니다. 자세한 내용은 Java 설명서를 참조하십시오.
HTTP/HTTPS 프록시
ThingWorx Platform은 HTTP 리소스를 요청할 때 구성된 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)와 동일한 비프록시 호스트 목록을 사용합니다.
|
|
https 프록시를 사용하는 것이 가장 좋습니다.
|
호스트 프록시 설정 사용
또한 Java 런타임은 HTTP/HTTPS 프록시를 직접 구성하는 대신 호스트에 정의된 프록시 설정을 사용할 수 있습니다. 운영 체제 설정에서 프록시 구성을 활성화하려면 CATALINA_OPTS 아래에서 Java 시스템 속성 java.net.useSystemProxies를 true로 설정합니다. 운영 체제 설정을 통해 호스트 시스템에서 사용 중일 수 있는 PAC(프록시 자동 구성) 파일 및 WPAD(웹 프록시 자동 검색)에 의존하여 복잡한 프록시 설정을 활성화합니다.
ThingWorx Platform이 호스트 프록시 설정을 사용하도록 구성된 경우 런타임에 프록시가 변경될 수 있습니다.
컨테이너에 대한 호스트 프록시 설정 사용
Docker 또는 Kubernetes 환경에서 실행 중인 컨테이너는 실제 호스트 시스템을 볼 수 없습니다. 따라서 호스트 프록시 설정을 사용하면 의도한 대로 작동하지 않을 수 있습니다. 컨테이너에 아웃바운드 프록시가 필요한 경우 Apache Tomcat의 HTTP/HTTPS 프록시 속성을 통해 직접 구성해야 합니다. CATALINA_OPTS 환경 변수를 사용하여 이러한 Java 시스템 속성을 구성합니다.