From 06de1fb17ba3ffa29e303d98a78f2df0f34d0622 Mon Sep 17 00:00:00 2001 From: Joost Verhoog Date: Fri, 27 Feb 2026 15:42:12 +0100 Subject: [PATCH 1/2] Improve proxy settings --- .../runtime/custom-settings/_index.md | 21 ++++++++++---- .../runtime/custom-settings/_index.md | 29 ++++++++++++------- .../runtime/custom-settings/_index.md | 23 ++++++++++++--- 3 files changed, 53 insertions(+), 20 deletions(-) diff --git a/content/en/docs/refguide/runtime/custom-settings/_index.md b/content/en/docs/refguide/runtime/custom-settings/_index.md index 292d41630f4..181721cdf34 100644 --- a/content/en/docs/refguide/runtime/custom-settings/_index.md +++ b/content/en/docs/refguide/runtime/custom-settings/_index.md @@ -302,11 +302,16 @@ The settings below configure metrics through [micrometer](https://micrometer.io/ ## Proxy Settings {#proxy-settings} -The settings below allow you to use a proxy. +### Http(s) Connections -{{% alert color="warning" %}} -These settings have to be set as JVM properties, not as custom Runtime settings. -{{% /alert %}} +The settings below configure the app to use a proxy for http(s) connections used in: + + 1. Integration microflow activities [call web service](/refguide/call-web-service-action/), [call REST service](/refguide/call-rest-action/), [send REST request](/refguide/send-rest-request) and [call external action](/refguide/call-external-action/). + 2. External object microflow activities [send external object](/refguide/send-external-object/) and [delete external object](/refguide/delete-external-object/). + 3. Retrieving external entity data using a [consumed OData service](/refguide/consumed-odata-service/). + 4. Mendix runtime API [Core.Http().executeHttpRequest](https://apidocs.rnd.mendix.com/11/runtime/com/mendix/http/Http.html) and [HttpConfiguration.getInstance().getProxyConfiguration()]. + +These settings can be set either as JVM properties or as custom Runtime settings. | Name | Description | Default Value | | --- | --- | --- | @@ -314,9 +319,13 @@ These settings have to be set as JVM properties, not as custom Runtime settings. | http.proxyPort | Defines the port number of the HTTP proxy server. | | | http.proxyUser | Defines the user of the HTTP proxy server. | | | http.proxyPassword | Defines the password of the HTTP proxy server. | | + +### License Server + +The settings below configure the app to use a proxy to reach the Mendix license server. These settings have to be set as JVM properties, not as custom Runtime settings. + | https.proxyHost | Defines the hostname of the HTTPS proxy server. | | | https.proxyPort | Defines the port number of the HTTPS proxy server. | | | https.proxyUser | Defines the user of the HTTPS proxy server. | | | https.proxyPassword | Defines the password of the HTTPS proxy server. | | - -{{% alert color="info" %}} `http.nonProxyHosts` only affects the license server. {{% /alert %}} +| https.nonProxyHosts | Defines a list of hosts that should be reached directly, bypassing the proxy. This is a list of patterns separated by '|'. The patterns may start or end with a '*' for wildcards. | | diff --git a/content/en/docs/refguide10/runtime/custom-settings/_index.md b/content/en/docs/refguide10/runtime/custom-settings/_index.md index 68d80e20b7e..f92f8291c94 100644 --- a/content/en/docs/refguide10/runtime/custom-settings/_index.md +++ b/content/en/docs/refguide10/runtime/custom-settings/_index.md @@ -304,21 +304,30 @@ The settings below configure metrics through [micrometer](https://micrometer.io/ ## Proxy Settings {#proxy-settings} -The settings below allow you to use a proxy. +### Http(s) Connections -{{% alert color="warning" %}} -These settings have to be set as JVM properties, not as custom Runtime settings. -{{% /alert %}} +The settings below configure the app to use a proxy for http(s) connections used in: + + 1. Integration microflow activities [call web service](/refguide/call-web-service-action/), [call REST service](/refguide/call-rest-action/), [send REST request](/refguide/send-rest-request) and [call external action](/refguide/call-external-action/). + 2. External object microflow activities [send external object](/refguide/send-external-object/) and [delete external object](/refguide/delete-external-object/). + 3. Retrieving external entity data using a [consumed OData service](/refguide/consumed-odata-service/). + 4. Mendix runtime API [Core.Http().executeHttpRequest](https://apidocs.rnd.mendix.com/11/runtime/com/mendix/http/Http.html) and [HttpConfiguration.getInstance().getProxyConfiguration()]. + +These settings can be set either as JVM properties or as custom Runtime settings. | Name | Description | Default Value | | --- | --- | --- | -| http.proxyHost | Defines the hostname of the HTTP proxy server. | | -| http.proxyPort | Defines the port number of the HTTP proxy server. | | +| http.proxyHost | Defines the hostname of the HTTP proxy server. | | +| http.proxyPort | Defines the port number of the HTTP proxy server. | | | http.proxyUser | Defines the user of the HTTP proxy server. | | | http.proxyPassword | Defines the password of the HTTP proxy server. | | -| https.proxyHost | Defines the hostname of the HTTPS proxy server. | | -| https.proxyPort | Defines the port number of the HTTPS proxy server. | | + +### License Server + +The settings below configure the app to use a proxy to reach the Mendix license server. These settings have to be set as JVM properties, not as custom Runtime settings. + +| https.proxyHost | Defines the hostname of the HTTPS proxy server. | | +| https.proxyPort | Defines the port number of the HTTPS proxy server. | | | https.proxyUser | Defines the user of the HTTPS proxy server. | | | https.proxyPassword | Defines the password of the HTTPS proxy server. | | - -{{% alert color="info" %}} `http.nonProxyHosts` only affects the license server. {{% /alert %}} +| https.nonProxyHosts | Defines a list of hosts that should be reached directly, bypassing the proxy. This is a list of patterns separated by '|'. The patterns may start or end with a '*' for wildcards. | | diff --git a/content/en/docs/refguide9/runtime/custom-settings/_index.md b/content/en/docs/refguide9/runtime/custom-settings/_index.md index 3134fac5e5a..1d3767a37c5 100644 --- a/content/en/docs/refguide9/runtime/custom-settings/_index.md +++ b/content/en/docs/refguide9/runtime/custom-settings/_index.md @@ -248,15 +248,30 @@ The settings below configure metrics through [micrometer](https://micrometer.io/ ## Proxy Settings -The settings below allow you to use a proxy. +### Http(s) Connections -{{% alert color="warning" %}} -These settings have to be set as JVM properties, not as custom Runtime settings. -{{% /alert %}} +The settings below configure the app to use a proxy for http(s) connections used in: + + 1. Integration microflow activities [call web service](/refguide/call-web-service-action/), [call REST service](/refguide/call-rest-action/), [send REST request](/refguide/send-rest-request) and [call external action](/refguide/call-external-action/). + 2. External object microflow activities [send external object](/refguide/send-external-object/) and [delete external object](/refguide/delete-external-object/). + 3. Retrieving external entity data using a [consumed OData service](/refguide/consumed-odata-service/). + 4. Mendix runtime API [Core.Http().executeHttpRequest](https://apidocs.rnd.mendix.com/11/runtime/com/mendix/http/Http.html) and [HttpConfiguration.getInstance().getProxyConfiguration()]. + +These settings can be set either as JVM properties or as custom Runtime settings. | Name | Description | Default Value | | --- | --- | --- | | http.proxyHost | Defines the hostname of the HTTP proxy server. | | | http.proxyPort | Defines the port number of the HTTP proxy server. | | +| http.proxyUser | Defines the user of the HTTP proxy server. | | +| http.proxyPassword | Defines the password of the HTTP proxy server. | | + +### License Server + +The settings below configure the app to use a proxy to reach the Mendix license server. These settings have to be set as JVM properties, not as custom Runtime settings. + | https.proxyHost | Defines the hostname of the HTTPS proxy server. | | | https.proxyPort | Defines the port number of the HTTPS proxy server. | | +| https.proxyUser | Defines the user of the HTTPS proxy server. | | +| https.proxyPassword | Defines the password of the HTTPS proxy server. | | +| https.nonProxyHosts | Defines a list of hosts that should be reached directly, bypassing the proxy. This is a list of patterns separated by '|'. The patterns may start or end with a '*' for wildcards. | | From 89ee5a4543eac220ed14ff514438ceecdb160e81 Mon Sep 17 00:00:00 2001 From: Joost Verhoog Date: Thu, 5 Mar 2026 14:10:29 +0100 Subject: [PATCH 2/2] Clarify http and http differences even more --- .../en/docs/refguide/runtime/custom-settings/_index.md | 8 ++++++-- .../en/docs/refguide10/runtime/custom-settings/_index.md | 8 ++++++-- .../en/docs/refguide9/runtime/custom-settings/_index.md | 8 ++++++-- 3 files changed, 18 insertions(+), 6 deletions(-) diff --git a/content/en/docs/refguide/runtime/custom-settings/_index.md b/content/en/docs/refguide/runtime/custom-settings/_index.md index 181721cdf34..652604dd314 100644 --- a/content/en/docs/refguide/runtime/custom-settings/_index.md +++ b/content/en/docs/refguide/runtime/custom-settings/_index.md @@ -304,14 +304,14 @@ The settings below configure metrics through [micrometer](https://micrometer.io/ ### Http(s) Connections -The settings below configure the app to use a proxy for http(s) connections used in: +The settings below configure the app to use a proxy for all connections, whether they are http or https connections, in: 1. Integration microflow activities [call web service](/refguide/call-web-service-action/), [call REST service](/refguide/call-rest-action/), [send REST request](/refguide/send-rest-request) and [call external action](/refguide/call-external-action/). 2. External object microflow activities [send external object](/refguide/send-external-object/) and [delete external object](/refguide/delete-external-object/). 3. Retrieving external entity data using a [consumed OData service](/refguide/consumed-odata-service/). 4. Mendix runtime API [Core.Http().executeHttpRequest](https://apidocs.rnd.mendix.com/11/runtime/com/mendix/http/Http.html) and [HttpConfiguration.getInstance().getProxyConfiguration()]. -These settings can be set either as JVM properties or as custom Runtime settings. +These settings can be set either as JVM properties or as custom Runtime settings. When set as both a JVM propery and a custom runtime setting, the app uses the custom runtime setting. | Name | Description | Default Value | | --- | --- | --- | @@ -320,6 +320,8 @@ These settings can be set either as JVM properties or as custom Runtime settings | http.proxyUser | Defines the user of the HTTP proxy server. | | | http.proxyPassword | Defines the password of the HTTP proxy server. | | +Note that the `http.` part of the names of these settings does not imply anything about `http` or `https` connections - it's just the name of the setting. + ### License Server The settings below configure the app to use a proxy to reach the Mendix license server. These settings have to be set as JVM properties, not as custom Runtime settings. @@ -329,3 +331,5 @@ The settings below configure the app to use a proxy to reach the Mendix license | https.proxyUser | Defines the user of the HTTPS proxy server. | | | https.proxyPassword | Defines the password of the HTTPS proxy server. | | | https.nonProxyHosts | Defines a list of hosts that should be reached directly, bypassing the proxy. This is a list of patterns separated by '|'. The patterns may start or end with a '*' for wildcards. | | + +Note that the `https.` part of the names of these settings does not imply anything about `http` or `https` connections - it's just the name of the setting. \ No newline at end of file diff --git a/content/en/docs/refguide10/runtime/custom-settings/_index.md b/content/en/docs/refguide10/runtime/custom-settings/_index.md index f92f8291c94..80eae95e037 100644 --- a/content/en/docs/refguide10/runtime/custom-settings/_index.md +++ b/content/en/docs/refguide10/runtime/custom-settings/_index.md @@ -306,14 +306,14 @@ The settings below configure metrics through [micrometer](https://micrometer.io/ ### Http(s) Connections -The settings below configure the app to use a proxy for http(s) connections used in: +The settings below configure the app to use a proxy for all connections, whether they are http or https connections, in: 1. Integration microflow activities [call web service](/refguide/call-web-service-action/), [call REST service](/refguide/call-rest-action/), [send REST request](/refguide/send-rest-request) and [call external action](/refguide/call-external-action/). 2. External object microflow activities [send external object](/refguide/send-external-object/) and [delete external object](/refguide/delete-external-object/). 3. Retrieving external entity data using a [consumed OData service](/refguide/consumed-odata-service/). 4. Mendix runtime API [Core.Http().executeHttpRequest](https://apidocs.rnd.mendix.com/11/runtime/com/mendix/http/Http.html) and [HttpConfiguration.getInstance().getProxyConfiguration()]. -These settings can be set either as JVM properties or as custom Runtime settings. +These settings can be set either as JVM properties or as custom Runtime settings. When set as both a JVM propery and a custom runtime setting, the app uses the custom runtime setting. | Name | Description | Default Value | | --- | --- | --- | @@ -322,6 +322,8 @@ These settings can be set either as JVM properties or as custom Runtime settings | http.proxyUser | Defines the user of the HTTP proxy server. | | | http.proxyPassword | Defines the password of the HTTP proxy server. | | +Note that the `http.` part of the names of these settings does not imply anything about `http` or `https` connections - it's just the name of the setting. + ### License Server The settings below configure the app to use a proxy to reach the Mendix license server. These settings have to be set as JVM properties, not as custom Runtime settings. @@ -331,3 +333,5 @@ The settings below configure the app to use a proxy to reach the Mendix license | https.proxyUser | Defines the user of the HTTPS proxy server. | | | https.proxyPassword | Defines the password of the HTTPS proxy server. | | | https.nonProxyHosts | Defines a list of hosts that should be reached directly, bypassing the proxy. This is a list of patterns separated by '|'. The patterns may start or end with a '*' for wildcards. | | + +Note that the `https.` part of the names of these settings does not imply anything about `http` or `https` connections - it's just the name of the setting. diff --git a/content/en/docs/refguide9/runtime/custom-settings/_index.md b/content/en/docs/refguide9/runtime/custom-settings/_index.md index 1d3767a37c5..104d679e205 100644 --- a/content/en/docs/refguide9/runtime/custom-settings/_index.md +++ b/content/en/docs/refguide9/runtime/custom-settings/_index.md @@ -250,14 +250,14 @@ The settings below configure metrics through [micrometer](https://micrometer.io/ ### Http(s) Connections -The settings below configure the app to use a proxy for http(s) connections used in: +The settings below configure the app to use a proxy for all connections, whether they are http or https connections, in: 1. Integration microflow activities [call web service](/refguide/call-web-service-action/), [call REST service](/refguide/call-rest-action/), [send REST request](/refguide/send-rest-request) and [call external action](/refguide/call-external-action/). 2. External object microflow activities [send external object](/refguide/send-external-object/) and [delete external object](/refguide/delete-external-object/). 3. Retrieving external entity data using a [consumed OData service](/refguide/consumed-odata-service/). 4. Mendix runtime API [Core.Http().executeHttpRequest](https://apidocs.rnd.mendix.com/11/runtime/com/mendix/http/Http.html) and [HttpConfiguration.getInstance().getProxyConfiguration()]. -These settings can be set either as JVM properties or as custom Runtime settings. +These settings can be set either as JVM properties or as custom Runtime settings. When set as both a JVM propery and a custom runtime setting, the app uses the custom runtime setting. | Name | Description | Default Value | | --- | --- | --- | @@ -266,6 +266,8 @@ These settings can be set either as JVM properties or as custom Runtime settings | http.proxyUser | Defines the user of the HTTP proxy server. | | | http.proxyPassword | Defines the password of the HTTP proxy server. | | +Note that the `http.` part of the names of these settings does not imply anything about `http` or `https` connections - it's just the name of the setting. + ### License Server The settings below configure the app to use a proxy to reach the Mendix license server. These settings have to be set as JVM properties, not as custom Runtime settings. @@ -275,3 +277,5 @@ The settings below configure the app to use a proxy to reach the Mendix license | https.proxyUser | Defines the user of the HTTPS proxy server. | | | https.proxyPassword | Defines the password of the HTTPS proxy server. | | | https.nonProxyHosts | Defines a list of hosts that should be reached directly, bypassing the proxy. This is a list of patterns separated by '|'. The patterns may start or end with a '*' for wildcards. | | + +Note that the `https.` part of the names of these settings does not imply anything about `http` or `https` connections - it's just the name of the setting.