Table of Contents

Search

  1. Preface
  2. Workflow Manager
  3. Workflows and Worklets
  4. Sessions
  5. Session Configuration Object
  6. Tasks
  7. Sources
  8. Targets
  9. Connection Objects
  10. Validation
  11. Scheduling and Running Workflows
  12. Sending Email
  13. Workflow Monitor
  14. Workflow Monitor Details
  15. Session and Workflow Logs
  16. Session Properties Reference
  17. Workflow Properties Reference

HTTP Connections

HTTP Connections

Use an application connection object for each HTTP server that you want to connect to.
Configure connection information for an HTTP transformation in an HTTP application connection. The Integration Service can use HTTP application connections to connect to HTTP servers. HTTP application connections enable you to control connection attributes, including the base URL and other parameters.
If you want to connect to an HTTP proxy server, configure the HTTP proxy server settings in the Integration Service.
Configure an HTTP application connection in the following circumstances:
  • The HTTP server requires authentication.
  • You want to configure the connection timeout.
  • You want to override the base URL in the HTTP transformation.
Before you configure an HTTP connection to use SSL authentication, you may need to configure certificate files. For information about SSL authentication, see SSL Authentication Certificate Files.
The following table describes the properties that you configure for an HTTP connection:
Property
Description
Name
Connection name used by the Workflow Manager. Connection name cannot contain spaces or other special characters, except for the underscore.
User Name
Authenticated user name for the HTTP server. If the HTTP server does not require authentication, enter PmNullUser.
To define the user name in the parameter file, enter session parameter $Param
Name
as the user name, and define the value in the session or workflow parameter file. The Integration Service interprets user names that start with $Param as session parameters.
Use Parameter in Password
Indicates the password for the authenticated user is a session parameter, $Param
Name
. Define the password in the workflow or session parameter file, and encrypt it by using the
pmpasswd
CRYPT_DATA option. Default is disabled.
Password
Password for the authenticated user. If the HTTP server does not require authentication, enter PmNullPasswd.
Base URL
URL of the HTTP server. This value overrides the base URL defined in the HTTP transformation.
You can use a session parameter to configure the base URL. For example, enter the session parameter $ParamBaseURL in the Base URL field, and then define $ParamBaseURL in the parameter file.
Timeout
Number of seconds the Integration Service waits for a connection to the HTTP server before it closes the connection.
Domain
Authentication domain for the HTTP server. This is required for NTLM authentication.
Trust Certificates File
File containing the bundle of trusted certificates that the client uses when authenticating the SSL certificate of a server. You specify the trust certificates file to have the Integration Service authenticate the HTTP server. By default, the name of the trust certificates file is ca-bundle.crt. For information about adding certificates to the trust certificates file, see SSL Authentication Certificate Files.
Certificate File
Client certificate that an HTTP server uses when authenticating a client. You specify the client certificate file if the HTTP server needs to authenticate the Integration Service.
Certificate File Password
Password for the client certificate. You specify the certificate file password if the HTTP server needs to authenticate the Integration Service.
Certificate File Type
File type of the client certificate. You specify the certificate file type if the HTTP server needs to authenticate the Integration Service. The file type can be PEM or DER. For information about converting certificate file types to PEM or DER, see SSL Authentication Certificate Files. Default is PEM.
Private Key File
Private key file for the client certificate. You specify the private key file if the HTTP server needs to authenticate the Integration Service.
Key Password
Password for the private key of the client certificate. You specify the key password if the web service provider needs to authenticate the Integration Service.
Key File Type
File type of the private key of the client certificate. You specify the key file type if the HTTP server needs to authenticate the Integration Service. The HTTP transformation uses the PEM file type for SSL authentication.
Authentication Type
Select one of the following authentication types to use when the HTTP server does not return an authentication type to the Integration Service:
  • Auto. The Integration Service attempts to determine the authentication type of the HTTP server.
  • Basic. Based on a non-encrypted user name and password.
  • Digest. Based on an encrypted user name and password.
  • NTLM. Based on encrypted user name, password, and domain.
Default is Auto.