2.7 Configuring Connection and Session Limits

The Access Gateway establishes connections with clients and with Web servers. For most networks, the default values for unresponsive connections and sessions provide adequate performance, but you can fine-tune the options for your network, its performance requirements, and your users:

Authentication time limits for inactivity sessions are configured on the contract and enforced by the Identity Server. For information on how to configure this limit, see Section 2.4.6, Assigning a Timeout Per Protected Resource.

2.7.1 Configuring TCP Listen Options for Clients

The TCP listen options allow you to control how idle and unresponsive browser connections are handled and to optimize these processes for your network. For most networks, the default values provide adequate performance. If your network is congested and slow, you might want to increase some of the limits.

  1. In the Administration Console, click Devices > Access Gateways > Edit > [Name of Reverse Proxy] > TCP Listen Options.

    Configuring the listen options for clients
  2. Select Enable Persistent Connections to allow the Access Gateway to establish a persistent HTTP connection between the Access Gateway and the browser. Usually, HTTP connections service only one request and response sequence. A persistent connection allows multiple requests to be serviced before the connection is closed.

    This option is enabled by default.

  3. Specify values for the TCP Listen Options:

    Keep Alive Interval: (Access Gateway Service) Sets the length of time between packets being sent to a connected device to determine if the connection is still alive. If a response is not received within the Data Read Timeout value, the connection is closed. On an idle connection, sending these ping packets continues until the Idle Timeout value is reached. Setting the value to zero prevents the sending of keep-alive packets. The value can be set from 0 to 1440 seconds (24 minutes). The default is 300 seconds (5 minutes).

    Data Read Timeout: Determines when an unresponsive connection is closed. When exchanging data, if an expected response from the connected device is not received within this amount of time, the connection is closed. This value might need to be increased for slow or congested network links. The value can be set from 1 to 3600 seconds (1 hour). The default is 120 seconds (2 minutes).

    Idle Timeout: (Access Gateway Appliance) Determines when an idle connection is closed. If no application data is exchanged over a connection for this amount of time, the connection is closed. This value limits how long an idle persistent connection is kept open. This setting is a compromise between freeing resources to allow additional inbound connections, and keeping connections established so that new connections from the same device do not need to be re-established. The value can be set from 1 to 1800 seconds (30 minutes). The default is 180 seconds (3 minutes).

  4. To configure the encryption key, select one or more of the following:

    Enforce 128-Bit Encryption between Browser and Access Gateway: When this option is selected, the Access Gateway requires all its server connections with client browsers to use 128-bit encryption. If the encryption key is less than 128, regardless of the cipher suite, the connection is denied.

    Enforce 128-Bit Encryption between Access Gateway and Web Server: When this option is selected, the Access Gateway requires all its client connections to Web servers to use 128-bit encryption. If the encryption key is less than 128, regardless of the cipher suite, the connection is denied.

    NOTE:These SSL listening options appear disabled if you are configuring the tunneling services.

  5. To save your changes to browser cache, click OK.

  6. To apply your changes, click the Access Gateways link, then click Update > OK.

2.7.2 Configuring TCP Connect Options for Web Servers

Connect options are specific to the group of Web servers configured for a proxy service. They allow you to control how idle and unresponsive Web server connections are handled and to optimize these processes for your network. For most networks, the default values provide adequate performance. If your network is congested and slow, you might want to increase some of the limits.

  1. In the Administration Console, click Devices > Access Gateways > Edit > [Name of Reverse Proxy] > [Name of Proxy Service] > Web Servers > TCP Connect Options.

    Configuring connection options for the Web servers
  2. Configure the IP address to use when establishing connections with Web servers:

    Cluster Member: (Available only if the Access Gateway is a member of a cluster.) Select the server you want to configure from the list of servers. Only the value of the Make Outbound Connection Using option applies to the selected server.

    Make Outbound Connection Using: (Access Gateway Appliance) Specifies which IP address the proxy service should use when establishing connections with the back-end Web servers.

  3. (Access Gateway Appliance) Select how the Web servers should be contacted when multiple Web servers are available. Select one of the following for the Policy for Multiple Destination IP Addresses option:

    • Simple Failover: Allows the next available Web server in the group to be contacted when the first server in the list is no longer available.

    • Round Robin: Moves in order through the list of Web servers, allowing each to service requests before starting at the beginning of the list for a second group of requests.

    NOTE:The Make Outbound Connection Using and Policy for Multiple Destination IP Addresses options are available in the Access Gateway Appliance and the same options are not available in the Access Gateway Services.

  4. Select Enable Persistent Connections to allow the Access Gateway to establish a persistent HTTP connection between the Access Gateway and the Web server. Usually, HTTP connections service only one request and response sequence. A persistent connection allows multiple requests to be serviced before the connection is closed.

    This option is enabled by default.

  5. To modify the connection timeouts between the Access Gateway and the Web servers, configure the following fields:

    Data Read Timeout: Determines when an unresponsive connection is closed. When exchanging data, if an expected response from the connected device is not received within this amount of time, the connection is closed. This value might need to be increased for slow or congested network links. The value can be set from 1 to 3600 seconds (1 hour). The default is 120 seconds (2 minutes).

    Idle Timeout: Determines when an idle connection is closed. If no application data is exchanged over a connection for this amount of time, the connection is closed. This value limits how long an idle persistent connection is kept open. This setting is a compromise between freeing resources to allow additional inbound connections, and keeping connections established so that new connections from the same device do not need to be re-established. The value can be set from 1 to 1800 seconds (30 minutes). The default is 180 seconds (3 minutes).

  6. To save your changes to browser cache, click OK.

  7. To apply your changes, click the Access Gateways link, then click Update > OK.

2.7.3 Configuring Connection and Session Persistence

The Access Gateway establishes three types of connections:

  • Access Gateway to browser

  • Access Gateway to Web server

  • Browser to Web server

The Access Gateway connections to the browser and the Access Gateway connections to the Web server involve setting up a TCP connection for an HTTP request. HTTP connections usually service only one request and response sequence, and the TCP connection is opened and closed during the sequence. A persistent connection allows multiple requests to be serviced before the connection is closed and saves a significant amount of processing time. To configure this type of persistence, see the following:

  • Access Gateway to Browser: Click Devices > Access Gateways > Edit > [Name of Reverse Proxy] > TCP Listen Options and configure the Enable Persistent Connections option.

  • Access Gateway to Web Server: Click Devices > Access Gateways > Edit > [Name of Reverse Proxy] > [Name of Proxy Service] > Web Servers > TCP Connect Options and configure the Enable Persistent Connections option.

The persistence of the browser to Web server connection is always enabled and is not configurable. This feature allows a browser to use the same Web server after an initial connection has been established. Most Web applications are designed to expect this type of behavior.

2.7.4 Configuring Web Servers

The Web server configuration determines how the Access Gateway handles connections and packets between itself and the Web servers. For more information on Web Server configuration, see Section 2.3, Configuring the Web Servers of a Proxy Service

  1. Click Access Gateways > Edit > [Name of Reverse Proxy] > [Name of Proxy Service] > Web Servers.

  2. The session stickiness provides information about the web server session connection details.

    Enable Session Stickiness: Default the Session Stickiness checkbox is enabled and this option makes the proxy server to use the same web server for all fills during a session.

  3. If your browsers are capable of sending HTTP 1.1 requests, configure the following field to match your Web servers:

    Enable Force HTTP 1.0 to Origin: Indicates whether HTTP 1.1 requests from browsers are translated to HTTP 1.0 requests before sending them to the Web server. If your browsers are sending HTTP 1.1 requests and your Web server can only handle HTTP 1.0 requests, you should enable this option.

    When the option is enabled, the Access Gateway translates an HTTP 1.1 request to an HTTP 1.0 request.

  4. To enable SSL connections between the proxy service and its Web servers, select Connect Using SSL. For configuration information for this option, Web Server Trusted Root, and SSL Mutual Certificate, see Section 1.4, Configuring SSL between the Proxy Service and the Web Servers.

  5. In the Connect Port field, specify the port that the Access Gateway should use to communicate with the Web servers. The following table lists some default port values for common types of Web servers.

    Server Type

    Non-Secure Port

    Secure Port

    Web server with HTML content

    80

    443

    SSL VPN

    8080

    8443

    WebSphere

    9080

    9443

    JBoss

    8080

    8443

  6. To control how idle and unresponsive Web server connections are handled and to optimize these processes for your network, select TCP Connect Options. For more information, see Section 2.7.2, Configuring TCP Connect Options for Web Servers.

  7. To add a web server, click New in the Web Server List and specify the IP address or the fully qualified DNS name of the Web server.

    The Web servers added to this list must contain identical Web content. Configuring your system with multiple servers with the same content adds fault tolerance and increases the speed for processing requests. For more information about this process, see Section 6.1, Setting Up a Group of Web Servers.

    • New: To create a new web server, click New. Specify the Web Server IP Address or DNS. Click OK to add the new web server to the list or Cancel to discard the changes.

      After creating the web server in the list, you can configure it as primary server and prioritize the list of web servers based on your requirement.

    • Delete: To delete a web server, select the Web server from the list, then click Delete.

      If you delete the selected web server, then all the web servers which are corresponding to the device in the cluster gets deleted.

  8. In case of Simple failover policy, the web server list will be ordered allowing selection of the primary web server.

    The most common use case is, same list of web servers as well as primary designate, in all the Gateway Appliances in a cluster. However, there can be scenarios where you want Gateway Appliances in a cluster to have different configuration for the above, one of them being locations separated geographically, each hosting Gateway Appliances, as well as some of the web servers. For such cases, select the individual members from the Cluster/Cluster Member drop down list, and configure the primary as well as other Web servers for each

    NOTE:Once the administrator opts for member change then the administrator cannot change the priority of Web Servers from the cluster but the other operations such as add, delete can be performed.

    Primary Web Server: The Web server which serves all the requests for this service. Only applicable for simple failover.

    Group Web Servers: The web servers which are added at the cluster level will be common and displayed in all cluster member groups.

    For more information about this process, see Section 6.1.1, Configuring Web Servers at Cluster Level and Section 6.1.2, Configuring Web Servers at Member Level.

  9. To save your changes to browser cache, click OK.

  10. To apply your changes, click the Access Gateways link, then click Update > OK.