C-LANG Statements › PROXYUSER Statement—Specify a User for Proxy Authentication

PROXYUSER Statement—Specify a User for Proxy Authentication

The PROXYUSER statement specifies the user name required for proxy authentication and, optionally, the user's domain in an HTTP job. The scheduling manager uses the user name, domain, agent name, and the job type to select the user's password in the password repository.

Supported Job Type

This statement is optional for the HTTP job type.

Syntax

This statement has the following format:

PROXYUSER proxy_user [DOMAIN(domain)]

proxy_user

Specifies the user name required for proxy authentication.

Limits: Up to 128 characters; case-sensitive; it cannot contain delimiters (such as spaces)

DOMAIN(domain)

(Optional) Specifies the name of the user's domain.

Limits: Up to 64 characters; case-sensitive; it cannot contain delimiters (such as spaces)

Notes:

• Your agent administrator can specify a default proxy user name for all HTTP jobs by setting the http.proxyUser parameter in the agent's agentparm.txt file.
• The PROXYUSER statement overrides the default proxy user name specified in the agent's agentparm.txt.
• Each user ID requires a corresponding password. The password is encrypted and stored separately from the user ID. For more information on defining passwords and other security requirements, refer to your scheduling manager's documentation.

Example: Override Global Proxy Defaults in Agent Parameter File

This example performs an HTTP query using the HTTP GET method. The output of the invocation is returned in the job's spool file. In this example, the job specifies the connection domain and origin for NTLM authentication, overrides the global proxy defaults specified in the agentparm.txt file, and specifies the user and BASIC, DIGEST, and NTLM protocols for web server authentication.

AGENT APPAGENT
INVOCATIONTYPE GET
SERVLET_URL http://host.example.com/protected IGNORE
CONNECTIONORIGIN host.example.com    
CONNECTIONDOMAIN windows_domain  
AUTHORDER (BASIC, DIGEST, NTLM)
CONNECTIONUSER user1
PROXYDOMAIN http://host.domain.proxy   
PROXYHOST proxy.example.com 
PROXYORIGIN http://host.origin.proxy
PROXYPORT 90
PROXYUSER user01 domain(mydomain)