System Properties

Description

This resource lists system properties that have been modified to control the portal's environment. The available properties are as follows:

  • allowLegacyURLParser—Beginning at 10.6, any portal URL containing the curly braces ( { } ) or pipe ( | ) special characters is invalid unless the character or characters are URL-encoded. When this property is added as true, these special characters are allowed in URLs unencoded. By default, the property is not listed. It is recommended not to enable this property, as it carries a security vulnerability. Adding or changing this property will automatically restart the web server.
  • defaultJsonResponseContentType—At 10.6, the default content-type for JSON and JSON with callback responses has been changed from text/plain to application/json and application/javascript, respectively. To revert the content-type of your Portal Services REST API back to text/plain, insert this parameter: {"defaultJsonResponseContentType": "text/plain"}. The only value this parameter will accept is text/plain. You should carefully consider the security risks of changing the content-type of JSON responses in your portal.
  • disableSignup— If you want to create all accounts manually, this property allows you to disable the sign-up page and prevent users from creating their own accounts.
  • diskThresholdforReceivingCollaboratedContentInGB—This property was introduced at 10.6.1 and controls when, based on available disk space, portal will stop receiving collaborated content. The default disk space value is 10 GB. The minimum allowed value is 1 GB. The specified size must be in GB.
  • privatePortalURL—Informs the portal that it has a front end load-balancer/proxy reachable at the URL. This property is typically used to set up a highly available portal configuration.
  • portalLocalhostName—Informs the portal back end to present the value of this property as the local portal machine. This is typically used during federation and when the portal machine has one or more public host names.
  • httpProxyHost—Specifies the HTTP host name of the proxy server.
  • httpProxyPort—Specifies the HTTP port number of the proxy server.
  • httpProxyUser—Specifies the HTTP proxy server user name.
  • httpProxyPassword—Specifies the HTTP proxy server password.
  • isHttpProxyPasswordEncrypted—Set this property to false when you are configuring the HTTP proxy server password in plain text. After configuration, the password will be encrypted, and this property will be set to true.
  • httpsProxyHost—Specifies the HTTPS host name of the proxy server.
  • httpsProxyPort—Specifies the HTTPS port number of the proxy server.
  • httpsProxyUser—Specifies the HTTPS proxy server user name.
  • httpsProxyPassword—Specifies the HTTPS proxy server password.
  • isHttpsProxyPasswordEncrypted—Set this property to false when you are configuring the HTTPS proxy server password in plain text. After configuration, the password will be encrypted, and this property will be set to true.
  • nonProxyHosts—This property should always contain the machine name where your portal is installed. If you want to federate ArcGIS Server with your portal, this property should also include the name of the machine where ArcGIS Server is installed. If the ArcGIS Server site contains multiple machines, a wildcard can be used for all machines in the domain (for example, *.domain.com). Machine and domain items are separated using a pipe (|).
  • WebContextURL—If you are using a reverse proxy, set this property to reverse proxy URL.
Note:

If your forward proxy is configured to exclusively use HTTPS, do not include HTTP properties in the request.

Request parameters

ParameterDetails
f

The response format. The default response format is html.

Values: html | json

JSON Response syntax

{
    "propertyName1": "value1",
    "propertyName2": "value2",
    ...
}

JSON Response example

{
    "disableSignup": "true",
    "httpProxyHost": "forwardproxy.domain.com",
    "httpsProxyHost": "forwardproxy.domain.com",
    "httpProxyPort": 80,
    "httpsProxyPort": 443,
    "nonProxyHosts": "localhost|machine012.domain.com|*.domain.com"
}