Skip To Content

Generate Proxy Configuration

  • URL:https://<admin-root>/proxyGen(POST only)
  • Required Capability:Administrator
  • Version Introduced:10.9

Description

Generates an Apache HTTPD configuration file and can set the webContextURL and webSocketContextURL in Properties automatically when the correct topContext, proxyFQDN and setContextUrls are given.

Request Parameters

ParameterDescription
topContext

Required. String. the top level context of a proxy server to generate the proxy directives.

Example: your.proxy.com/thistopcontext

setContextUrls

Optional. Boolean. Sets the WebSocketContextURL and WebContextURL inProperties to the proxyFQDN provided.

proxyFQDN

Required whensetContextURLs=true. String. The FQDN of the reverse proxy to be configured with Mission Server.

Example:your.reverse.proxy.com

f

The response format. The default response format is html.

Values: html | json | file

Example usage

Below is a sample POST request for proxyGen:


POST /webadaptor/admin/proxyGen HTTP/1.1
Host: machine.domain.com
Content-Type: application/x-www-form-urlencoded
Content-Length: []

topContext=thistopcontext
setContextUrls=true
proxyFQDN=your.reverse.proxy.com
f=html

HTML Response example


### ArcGIS Mission Server Apache Proxy Configuration
###
### These Apache HTTPD directives configure Apache HTTP server to
### operate as a reverse proxy for ArcGIS Mission Server.
###
### Because 'setContextUrl' was set to true for proxy generation, these Mission Server
### properties have been set in admin/system/properties
### -------------------
### System Properties:
### {
###    "WebContextURL":"https://your.reverse.proxy/thistopcontext",
###    "WebSocketContextURL":"wss://your.reverse.proxy/thistopcontext"
###  }
### -------
###
### Instructions:
###
### Add these configuration directives within a
### <VirtualHost> container configured with SSL.
###
### Refer to the Apache documentation for your platform
### for the location of the Apache configuration files.
###
### For example, on CentOS/Red Hat Linux, add the directives
### below into /etc/httpd/conf.d/ssl.conf. 
### For Ubuntu, add the directives 
### to /etc/apache2/sites-enabled/default-ssl.conf
###
### Required Apache Version: 2.4.6 and later
###
### Required Apache Modules:
###
### LoadModule ssl_module modules/mod_ssl.so
### LoadModule proxy_module modules/mod_proxy.so
### LoadModule proxy_http_module modules/mod_proxy_http.so
### LoadModule proxy_wstunnel_module modules/mod_proxy_wstunnel.so
###
### 

## Enable proxy engine for SSL
SSLProxyEngine on

## Required if untrusted (self signed) certificates are in use.
## Can be commented out if certificate trust can be established.
SSLProxyVerify none

## Uncomment the below directive when troubleshooting
# LogLevel proxy:trace3 proxy_wstunnel:trace3

ProxyPass /thistopcontext/missions/ wss://your.reverse.proxy.com:20301/arcgis/missions/ disablereuse=On

ProxyPass /thistopcontext/ https://your.reverse.proxy.com:20443/arcgis/
ProxyPassReverse /thistopcontext/ https://your.reverse.proxy.com:20443/arcgis/

## Optional. Enable balancer manager. Requires mod_status.so
## 
## Do not enable balancer manager on a public facing system, unless
## you know what you are doing.
##
## If not already loaded, add
## LoadModule status_module modules/mod_status.so
#<Location "/balancer-manager">
# SetHandler balancer-manager
#</Location>

### End ArcGIS Mission Server Apache Proxy Config