- 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
Parameter | Description |
---|---|
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