Generate Proxy Configuration

URL:
https://<admin-root>/proxyGen
Methods:
POST
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 in Properties to the proxyFQDN provided.

proxyFQDN

Required when setContextURLs=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 :

1
2
3
4
5
6
7
8
9
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

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
### 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

Your browser is no longer supported. Please upgrade your browser for the best experience. See our browser deprecation post for more details.

You can no longer sign into this site. Go to your ArcGIS portal or the ArcGIS Location Platform dashboard to perform management tasks.

Your ArcGIS portal

Create, manage, and access API keys and OAuth 2.0 developer credentials, hosted layers, and data services.

Your ArcGIS Location Platform dashboard

Manage billing, monitor service usage, and access additional resources.

Learn more about these changes in the What's new in Esri Developers June 2024 blog post.

Close