8 5 8 HTTP Directives

8.5.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.