Adding an HTTP Option

In the Manage HTTP Options task, you can add as many HTTP options as required. These options let you configure all aspects of an HTTP connection, including credentials, SSL/TLS settings, connection timeouts, and proxy settings.
gateway91
In the Manage HTTP Options task, you can add as many HTTP options as required. These options let you configure all aspects of an HTTP connection, including credentials, SSL/TLS settings, connection timeouts, and proxy settings.
To add a new HTTP option
:
  1. In the Policy Manager, choose
    [Tasks] > Transports > Manage HTTP
    Options from the Main Menu.
    The Manage Global Resources dialog appears. dialog appears.
  2. Click [
    Add
    ].
    The Edit HTTP Options dialog appears.
  3. Configure each tab as necessary.
  4. Click [
    OK
    ] when done.
Configuring the [General] tab
The [
General
] tab is used to configure general information for the options.
Section
Description
General
Each HTTP option must have a unique combination of HTTP host, port, protocol, and path.
  • Host
    : Enter a valid hostname or IP address of the HTTP host. This is required.
  • Port
    : Enter the port number to match. This is optional.
  • Protocol
    : Choose the protocol(s) to match from the drop-down list: <Any>
    ,
    HTTP
    ,
    HTTPS
    .
  • Path
    : Enter a well-formed URI.   
Credentials
This section records HTTP authentication information. Enter the appropriate  HTTP credentials: User Name, Password, NTLM Domain, and NTLM Host (assuming NTLM has been enabled).
Note that the Password requires that you choose it from the drop-down list. If the password you need is not shown, click [
Manage Stored Passwords
] to define it first. For more information, see Manage Stored Passwords.
SSL/TLS
This section is enabled when the protocol selected is either <Any> or HTTPS.
  • Version
    : Choose the version of SSL/TLS to use or choose <Any> to allow all supported versions.
  • Private key
    : Indicate the private key requirements: choose either default, none, or a custom key from the keystore that you specify. You can click [
    Manage Private Keys
    ] to examine your private keys more closely. For more information, see Manage Private Keys.
  • Cipher suite
    : Indicate the cipher requirements: choose either a default or custom suite to use. The default suite consists of those ciphers that will offer the greatest compatibility when the
    API Gateway
    connects to a server via HTTPS. Alternatively, you can click [
    Cipher Suites
    ] to choose which ciphers to use and in which order. For more information, see Select Cipher Suites.
Connection Settings
  • Connection Timeout
    : This defines the maximum time to wait for a connection to be established. If exceeded, the connection will fail.
To override the system default, clear the Use System Default check box and then enter a different value. The system default for this timeout is defined by the io.outConnectTimeout cluster property. The default value is 30 seconds.
  • Read Timeout
    : This defines the maximum time allowed for response data to be read. If exceeded, the request will fail.
To override the system default, clear the Use System Default check box and enter a value. The system default for this timeout is defined by the io.outTimeout cluster property. The default value is 60 seconds.
  • Follow Redirects: Select this check box to follow HTTP redirect responses.
Security Zone
Optionally choose a security zone. To remove this entity from a security zone (security role permitting), choose "No security zone".
For more information about security zones, see Understand Security Zones.
This control is hidden if either: (a) no security zones have been defined, or (b) you do not have Read access to any security zone (regardless of whether you have Read access to entities inside the zones).
Configuring the [Proxy] tab
The [
Proxy
] tab lets you specify proxy options. By default, the shared proxy settings will be used. You can specify to not use an HTTP proxy or to use a specific HTTP proxy with the settings indicated here.Proxy Host: Enter a valid hostname or IP address for the host.
  • Proxy Port
    : Enter a value port number.
  • Proxy Username
    : Enter the user name to log onto the proxy host.
  • Proxy Password
    : Choose the proxy password from the drop-down list. If the password you need is not shown, click [Manage Stored Passwords] to define it first. For more information, see Manage Stored Passwords.