Configuring HTTP proxy server settings

Configuring an HTTP proxy server on your appliance involves the following tasks:

Configuring the hostname or IP address of the proxy server.
Configuring the port for client communication, if you do not want to accept the default port (port 8080).
(Optional) Enabling basic authentication on the proxy server.
(Optional) Specifying a user-agent string that is included in HTTP requests.
Enabling the proxy server.

You can then configure your appliance to do the following:

Send requests for one or more DTI services through the proxy server, as described in Using an HTTP proxy for DTI service requests.
Send requests to Helix through the proxy server, as described in the Helix Integration Guide.
Send event notifications through the proxy server, as described in the User Guide or Administration Guide for the appliance.

Prerequisites

Admin access.
The HTTP proxy server is deployed in your network.

Configuring HTTP proxy server settings using the CLI

Use the commands in this section to configure and enable an HTTP proxy server on an appliance.

To configure and enable an HTTP proxy server:

Go to CLI configuration mode:

hostname > enable
hostname # configure terminal

Configure the proxy server hostname or IP address, and the port (if you do not want to use the default, port 8080):
```
hostname (config) # fenet proxy host <hostname or IP address>[:<port>]
```

Optional: Specify the credentials for basic authentication:

Specify the user:

hostname (config) # fenet proxy auth basic user <username>

Specify the password:

hostname (config) # fenet proxy auth basic password <password>

Optional: Specify a user-agent string:

hostname (config) # fenet proxy user-agent <string>

Enable the proxy server:
```
hostname (config) # fenet proxy enable
```
Verify your changes:
```
hostname (config) # show fenet
```
Save your changes:
```
hostname (config) # write memory
```

Note
The show fenet status command also displays HTTP proxy settings, but does not show whether the proxy server is enabled or disabled. The show fenet command output includes or excludes "disabled" to indicate the status.

Example

The following example configures an HTTP proxy server with basic authentication credentials.

hostname (config) # fenet proxy host 192.168.2.3 
hostname (config) # fenet proxy auth basic user bsmith
hostname (config) # fenet proxy auth basic password abcd6789
hostname (config) # fenet proxy enable
hostname (config) # show fenet 

DTI CLIENT CONFIGURATION:
  ...
  Http proxy       : bsmith@192.168.2.3:8080 (user agent:)
  ...

hostname (config) # show fenet status
...
HTTP Proxy:

    Address       : 192.168.2.3:8080
    Username      : bsmith
    User-agent    :
    ...

Disabling HTTP proxy server settings using the CLI

Use the commands in this section to disable an HTTP proxy server or to remove its configuration settings.

To disable an HTTP proxy server or remove its configuration settings:

To disable an HTTP server:

hostname (config) # no fenet proxy enable

To remove the HTTP proxy server:
```
hostname (config) # no fenet proxy
```

To remove the basic authentication user:

hostname (config) # no fenet proxy auth basic user

To remove the basic authentication password:

hostname (config) # no fenet proxy auth basic password

To remove the user-agent string:

hostname (config) # no fenet proxy user-agent

Example

The following example disables an HTTP proxy server.

hostname (config) # no fenet proxy enable
hostname (config) # show fenet

DTI CLIENT CONFIGURATION:
  ...
  Http proxy          : bsmith@192.168.2.3:8080 (user agent:) Disabled
  ...