Skip to main content

Configure a forward proxy server with ArcGIS Velocity

A forward proxy server is a computer on your local area network (LAN) that allows connections outside your network without compromising the security of your internal network. Organizations commonly use forward proxy servers in perimeter networks (also known as demilitarized zones [DMZs] or screened subnets) to protect the identity of internal machines. While most Velocity items do not need to connect outside the network, some items need to access external web services. For example, you may need a forward proxy server when configuring a WebSocket feed or an HTTP Poller feed or source. If your organization uses a forward proxy server to connect externally, configure Velocity to use it.

To configure a forward proxy server with Velocity, complete the following steps:

  1. Open a web browser and sign in to the Velocity Administrator directory at https://velocity.example.com:7143/arcgis/admin.

  2. Click System > Properties > Update Properties.

  3. On the Update Server Properties dialog box, paste the following JSON code and replace the example values with your forward proxy server information:

    {
      "httpProxyHost": "forwardproxy.example.com",
      "httpsProxyHost": "forwardproxy.example.com",
      "httpProxyPort": 8888,
      "httpsProxyPort": 8888,
      "nonProxyHosts": "portal.example.com"
    }
    

    If your forward proxy server requires authentication, include the username and password in the JSON string:

    {
      "httpProxyHost": "forwardproxy.example.com",
      "httpsProxyHost": "forwardproxy.example.com",
      "httpProxyPort": 8888,
      "httpsProxyPort": 8888,
      "httpProxyUser": "username",
      "httpsProxyUser": "username",
      "httpProxyPassword": "password",
      "httpsProxyPassword": "password",
      "nonProxyHosts": "portal.example.com"
    }
    
    Note:
    • All these properties are optional and do not appear in system properties until you configure them.

    • Each of the above properties should always be included, even if your forward proxy server is configured to exclusively use HTTPS.

    • The nonProxyHosts property identifies hosts that Velocity accesses directly instead of through the forward proxy. This property should always contain the machine name where Portal for ArcGIS is installed. Machine and domain items are separated using a pipe (|).

      For example,

      "nonProxyHosts": "portal.example.com|server.example.com|*.example.com"
      
  4. Click Update Properties.