8.4.8 HTTP Directives

Data will be sent to the host using the HTTP protocol.

A HTTP server must be running on the host side.

Basic, digest and NTLM authentication is built into the User Agent.

Currently only basic authentication is supported for the intermediate proxy server.

If user and password are blank then there is no authentication, but if the HTTP server responds with a 401 response, then an authentication dialog will appear to prompt for user and password and another attempt is made to send (only one attempt is done).

If user=*prompt then an authentication dialog is displayed with blank fields.

If user=remoteuser then an authentication dialog is displayed with remoteuser in the user field.

If user=remoteuser and password=passphrase then no authentication dialog is displayed.

If the host URL is using the HTTPS protocol and a proxy URL is specified, then Proxy SSL Tunneling is used.

Keyword

Comments

name

Descriptive name displayed in the User Agent's Send message box.

host

URL of the HTTP server.

host.trusted

Required for an SSL connection if the trust store does not contain the peer certificate. A value of *yes means that server certificate will be trusted.

user

Authentication user or *prompt.

password

Authentication password.

proxy

URL of the HTTP proxy server.

proxy.user

Proxy basic authentication user.

proxy.password

Proxy basic authentication password.

locale

Sets the value of the HTTP protocol property X-USER-AGENT-LOCALE. If this entry does not exist then the default locale is used.

xxx.uri

Defines the file extension based host URI component for POST style methods.
Used by the following methods:
POST
user-defined

method

HTTP protocol method. Default is POST.
GET
HEAD
TRACE
OPTIONS
POST
user-defined

uri

Defines the host URI component for GET style methods and the default URI for a POST style method.
Used by the following methods:
GET
HEAD
TRACE
OPTIONS

authentication.preemptive

To improve the efficiency of the authentication handshake, the user agent can be instructed to expect a particular method of authentication.
Use *basic if basic authentication is expected
Use *digest if digest authentication is expected
Use *ntlm if NTLM authentication is expected
The default value is *negotiate and the full authentication challenge is done.

Note: Because digest and NTLM use a challenge handshake, if these are selected for preemptive authentication, an authentication from the server is mandatory as no content is sent during the early handshake.