com.HTTPRequest.setProxyAuthentication

Define the login and password to use for proxy authentication.

Syntax

setProxyAuthentication(
   login STRING,
   password STRING,
   scheme STRING,
   realm STRING )
  1. login defines the login to use for authentication.
  2. pass specifies the password to use for authentication.
  3. scheme defines the method to be used during authentication. This is optional; it can be set to NULL.
  4. realm defines the realm. This is optional; it can be set to NULL.

Usage

Defines the login and password to use for proxy authentication for the current HTTPRequest request.

The scheme parameter defines the method to be used during authentication. The supported values for the scheme parameter are Anonymous, Basic, Digest, and NTLM. The default is Anonymous.

If setProxy() is called, the login and password will be used to authenticate against the proxy set by this API, regardless of whether a proxy is configured in FGLPROFILE.

If setProxy() has not been called and a proxy is configured in FGLPROFILE, the login and password set by this method will be used to authenticate against the proxy defined by FGLPROFILE.

In case of error, the method throws an exception and sets the STATUS variable. Depending on the error, a human-readable description of the problem is available in the SQLCA.SQLERRM register. See Error handling in GWS calls (STATUS).