Configuration Tab › Mapping for Configuration Browser Tabs › Modules › Web Services

Web Services

Default Web Services Properties.

Sets the default values for Web Services operator properties.

Maximum result length (bytes)

Defines the maximum size (in bytes) of the XML value that datasets can store. The SOAP operators include the Invoke SOAP Method and Invoke SOAP Method Async. Both SOAP operators store the entire response as long as it does not exceed the configured Maximum result length. If the result exceeds the configured length, the result is truncated.

Default: 1048576

URL Part for Async SOAP Servlet

Defines the servlet location for incoming HTTP calls and SOAP calls. The specified servlet location is appended to the base server URL. Accept the default unless you create custom SOAP handlers.

Default: /itpam/soap

Async SOAP Servlet Method

Defines the servlet method that handles incoming responses for asynchronous SOAP calls from the product.

Default: AsynSoapResponse

Default Web Services HTTP Properties

Sets default values for Web Services operator HTTP properties.

Validate SSL Certificate?

Specifies whether to validate the SSL certificate. This setting is relevant when querying an HTTPS URL.

Values: This property can have the following values:

• Selected - Make an HTTP call only if the SSL certificate is valid. If the SSL certificate is invalid, the HTTP call fails.
• Cleared - Make an HTTP call without considering the validity of the SSL certificate.

Default: Cleared

HTTP Authentication?

Specifies whether the HTTP server at the URL specified in the operator requires HTTP authentication.

Values: This property can have the following values:

• Selected - The HTTP server at the specified URL requires authentication.
• Cleared - The HTTP server at the specified URL does not require an authentication.

Default: Cleared

NTLM Authentication?

Specifies whether the HTTP server at the URL specified in the operator requires NTLM authentication.

Values: This property can have the following values:

• Selected - The HTTP server at the specified URL requires authentication.
• Cleared - The HTTP server at the specified URL does not require an authentication. In this case, the product uses basic HTTP authentication.

Default: Cleared

HTTP Preemptive Authentication

Specifies whether the CA Process Automation HTTP operator should be configured to use HTTP Preemptive Authentication (instead of HTTP Authentication), which prompts the operator to send Basic HTTP Authentication to the Web service without negotiation.

User name

Defines the user name with which to access the URL specified in the operator. This user name can be authenticated.

Password

Defines the password that the product associates with the specified user name.

Domain name

Defines the name of the domain for authenticating with the URL specified in the operator.

Values: This property can have the following values:

• A valid domain name

  NTLM authentication requires a domain name.

• Blank

  NTLM authentication does not require a domain name.

Note: For an NTLM authentication, the product uses the domain name exactly as you define it. For a non-NTLM authentication, the product appends the domain name to the user name as in the following example if the domain name is required:

User name=user name@domain name

Use Proxy?

Specifies whether the HTTP call goes through a proxy server.

Values: This property can have the following values:

• Selected - The HTTP call goes through a proxy server.
• Cleared - The HTTP call does not go through a proxy server.

Default: Cleared

Proxy Host

Specifies one of the following methods to define the default proxy host:

• Use HTTP or HTTPS to define the default URL to the proxy host.
• Use the proxy server FQDN.

  Note: If you enter the FQDN, the product uses the HTTP protocol to contact the proxy host. For more information, see Syntax for DNS Host Names.

Proxy Port

Defines the default port of the proxy server.

Values: This value can be any valid port number.

For example:

• 80 (HTTP)
• 8080 (alternate HTTP)
• 443 (HTTPS)

Proxy Authentication?

Specifies whether the proxy requires authentication.

Values: This property can have the following values:

• Selected - The proxy host requires authentication.
• Cleared - The proxy host does not require an authentication.

Default: Cleared

Proxy NTLM Authentication?

Specifies whether the proxy host at the specified proxy URL requires NTLM authentication.

Values: This property can have the following values:

• Selected - The proxy host requires NTLM authentication.
• Cleared - The proxy host does not require an NTLM authentication. In this case, the product uses basic HTTP authentication.

Default: Cleared

Proxy Preemptive Authentication

Specifies whether the CA Process Automation HTTP operator should be configured to use Proxy Preemptive Authentication (instead of Proxy Authentication), which prompts the operator to send Proxy Authentication to the Web service without negotiation.

Proxy User name

Defines the user name with which to access the proxy host. This name can by authenticated by the proxy host.

Proxy Password

Defines the password that the product associates with the specified proxy user name.

Proxy Domain name

Defines the name of the domain for authenticating with the proxy host.

Values: This property can have the following values:

• A valid domain name

  NTLM authentication requires a domain name.

• Blank

  NTLM authentication does not require a domain name.

Note: For an NTLM authentication, the product uses the domain name exactly as you define it. For a non-NTLM authentication, the product appends the domain name to the user name as in the following example if the domain name is required:

user name=user name@domain name

HTTP Version

Defines the default HTTP protocol version.

Values: This property can have one of the following values:

• 1.0
• 1.1

Default: 1.1

Connection Timeout (sec)

Defines the maximum interval (in seconds) to wait for an HTTP connection before the operator times out.

Values: Any positive integer that indicates the number of seconds, where 0 (zero) sets no timeout.

Default: 0

Socket Timeout (sec)

Defines the maximum interval (in seconds) to wait between consecutive HTTP response data packets.

Values: Any positive integer that indicates the number of seconds, where 0 (zero) sets no timeout.

Default: 0

Handle Redirects?

Specifies whether redirects are handled automatically.

Values: This property can have the following values:

• Selected - The product handles redirects automatically.
• Cleared - The product does not handle redirects automatically.

Default: Cleared

Maximum Number of Redirects

Defines the maximum number of redirects to process. If the number of redirects after a request exceeds the configured value, an error is raised.

Default: 100