Configuring Java CAPS Environment Components for Application Adapters

Configuring the PeopleSoft HTTP Client Adapter Environment Properties

This task describes how to set the environment map properties of the PeopleSoft Adapter.

The PeopleSoft HTTP Client Adapter properties, accessed from the Environment Explorer tree, are organized into the following sections:

HTTP Settings

The HTTP Settings section of the PeopleSoft HTTP Client Adapter Environment properties contains the top-level parameters displayed in the following table.

Table 5 Environment Configuration - HTTP Settings

Name

Description

Required Value

URL

Specifies the default URL used to establishing an HTTP connection.

The Sun Enterprise Service Bus uses the PeopleSoft Adapter to send an HTTP post request to PeopleSoft’s HTTP listening connector. The PeopleSoft HTTP listening connector monitors specific ports for incoming HTTP messages. It is implemented as a Java HTTPServlet object running inside WebLogic’s application server.

For PeopleTools 8.13, use the following:

Apache:

 http://
PSFTHOST
/servlets/psft.pt8.gateway.
Gatewayservlet

WebLogic:
http:// PSFTHOST /servlets/gateway
PeopleTools 8.42:
http:// PSFTHOST :90/PSIGW/HttpListeningConnector
where, PSFTHOST is the PeopleSoft server host name.

You can verify the 8.42 HTTP listening connector servlet by verifying the web.xml.

Note –
The URL parameter does not support LDAP values.

The default URL used for establishing an HTTP connection.

Content type

Specifies the default Content-Type header value to include when sending a request to the server.

The default Content-Type header value.

The configured default is:

text/xml;charset=iso_8859-1

Encoding

Specifies the default encoding used when reading or writing textual data.

The default encoding used when reading or writing textual data.

The configured default is ASCII.

Proxy Configuration

The Proxy configuration section of the PeopleSoft HTTP Client Adapter Environment properties contains the top-level parameters displayed in the following table.

Table 6 Environment Configuration - Proxy configuration


Name	Description	Required Value
Proxy host	Specifies the hostname of the HTTP proxy server.	The hostname (string) of the HTTP proxy server.
Proxy port	Specifies the port of the HTTP proxy host.	The port number of the HTTP proxy server. The configured default is 8080.
Proxy username	Specifies the username for accessing the HTTP proxy server.	A user name (login) for the HTTP proxy server.
Proxy password	Specifies the password required for accessing the HTTP proxy host.	A password for the HTTP proxy server.

Security and Authentication

The Security and Authentication section of the PeopleSoft HTTP Client Adapter Environment properties contains the top-level parameters displayed in the following table.

Table 7 Environment Configuration - Security and Authentication


Name	Description	Required Value
Http username	Specifies the username used to authenticate the Web site specified by the URL.	A user name with access permission.
Http password	Specifies the password used to authenticate the Web site specified by the URL.	A password linked to the user name.

Security and SSL

The Security and SSL section of the PeopleSoft HTTP Client Adapter Environment properties contains the top-level parameters displayed in the following table.

Note –

SSL is not currently supported for the PeopleSoft Adapter. This section is reserved for future product enhancement.

Table 8 Environment Configuration - Security and SSL


Name	Description	Required Value
Protocol SSL	Specifies the Secure Sockets Layer (SSL) or Transport Layer Security (TLS) protocol used when establishing an SSL connection with the server.	Select the appropriate protocol. The options are: No SSL TLS TLSv1 SSLv3 SSLv2 SSL The configured default is No SSL.
JSSE Provider Class	Specifies the fully qualified name of the JSSE provider class.	The name of the JSSE provider class. The configured default value is com.sun.net.ssl.internal.ssl.Provider.
X509 Algorithm Name	Specifies the X509 algorithm name to use for the trust and key manager factories.	The X509 algorithm name to use for the trust and key manager factories. The configured default is SunX509.
Verify hostname	Specifies whether hostname verification is done on the server certificate during the SSL handshake.	True or False. True indicates that hostname verification is performed on the server certificate during the SSL handshake. The configured default is False.
KeyStore type	Specifies the keystore type for the keystore used for key/certificate management when establishing SSL connections.	The keystore type. The configured default is JKS.
KeyStore	Specifies the keystore used for key/certificate management when establishing SSL connections.	The keystore used for key/certificate management.
Keystore username	Specifies a username for accessing the keystore used for key/certificate management when establishing SSL connections.	A user name (login) with permission to access the keystore.
Keystore password	Specifies the password for accessing the keystore used for key/certificate management when establishing SSL connections.	A password associated with the KeyStore username to access the keystore.
TrustStore type	Specifies the truststore type of the truststore used for CA certificate management when establishing SSL connections.	The truststore type. The configured default is JKS.
TrustStore	Specifies the truststore used for CA certificate management when establishing SSL connections.	The name of the truststore.
TrustStore password	Specifies the password for accessing the truststore used for CA certificate management when establishing SSL connections.	A password that permits access to the truststore.

PeopleSoft Settings

The PeopleSoft Settings section of the PeopleSoft HTTP Client Adapter Environment properties contains the top-level parameters displayed in the following table.

Table 9 Environment Configuration - PeopleSoft Settings


Name	Description	Required Value
PeopleTools Version	Specifies the version of PeopleTools installed. The value options are: 8.42: PeopleTools version 8.42 8.13: PeopleTools version 8.13	Select 8.13 or 8.42. The configured default is 8.42.

PeopleSoft Settings and PeopleTools 8.42 Settings

The PeopleSoft Settings and PeopleTools 8.42 Settings section of the PeopleSoft HTTP Client Adapter Environment properties contains the top-level parameters displayed in the following table.

The PeopleTools settings must match the configurations for the PeopleSoft server.

At minimum, you must specify the following properties:

MessageName
DestinationNode
RequestingNode
MessageVersion

Table 10 Environment Configuration - PeopleSoft Settings and PeopleTools 8.42 Settings


Name	Description	Required Value
MessageName	Specifies the name of the message.	The name of the message.
MessageType	Specifies the type of message being sent. The type options are: sync: Synchronous message async: Asynchronous message ping: Ping message	Select sync, async, or ping.
RequestingNode	Specifies the name of the node sending the request.	The name of the node sending the request.
DestinationNode	Specifies the name of the node that receives the message. This parameter is optional when you specified a default target node using the Default Application Server Jolt connect string properties in the integrationGateway.properties file.	The name of the node that receives the message.
FinalDestina-tion	Specifies the name of the node that ultimately receives the message. This is common when a PeopleSoft Integration Broker hub is used.	The name of the node that ultimately receives the message.
MessageVersion	Specifies the message version.	The message version.
NonRepudiation	Specifies whether the message content in the request should be processed using nonrepudiation logic.	True or False. True indicates that nonrepudiation logic will be used to process the message content of the request.
OrigNode	Specifies the name of the node that started the process. This property is optional.	The name of the node that started the process.
OrigProcess	Specifies the originating process by which the message was initially generated.	The originating process by which the message was initially generated.
OrigUser	Specifies the user ID for the user from which the message was initially generated. This property is optional.	The user ID for the user from which the message was initially generated.
Password	Specifies the password as entered in the target node’s definition for the source node. The target node authenticates the password when it receives the message. This parameter is only required if password authentication is enabled for the source node definition in the target database.	The password, as it is presented in the target node’s definition for the source node.

PeopleSoft Settings and PeopleTools 8.13 Settings

The PeopleSoft Settings and PeopleTools 8.13 Settings section of the PeopleSoft HTTP Client Adapter Environment properties contains the top-level parameters displayed in the following table.

The PeopleTools settings must match the configurations for the PeopleSoft server.

At minimum, you must specify the following properties:

MessageVersion
FromNode
ToNode
Channel
PublicationProcess
Subject

Table 11 Environment Configuration - PeopleSoft Settings and PeopleTools 8.13 Settings


Name	Description	Required Value
MessageVersion	Specifies the message version.	The message version.
ToNode	Specifies the name of the node for which the message is intended. This must correspond to an entry in the node lookup table on the gateway servlet, and the name of the local node (node definition) on the receiving PeopleSoft system.	The name of the node for which the message is intended.
FromNode	Specifies the name of the node from which messages originate. The node name must match the node definition for the third party system as defined in the receiving PeopleSoft system.	The name of the node from which the messages originate.
Channel	Specifies the name of the message channel containing the message.	The name of the message channel.
PublicationProcess	Specifies the application-defined name of the program that generated the message. This may be required by the application.	The application-defined name of the program that generated the message.
Password	Specifies the password associated with the destination node. This value is stored in the PeopleSoft database and must be communicated to the system administrators for the publishing system. If the node definition on the sending system has a node group defined, the password will be present. If the node definition on the receiving system has a node group defined, the password must be present and must match the node group password.	The password associated with the destination node.
DefaultDataVersion	Specifies the default message version for the sending system.	The default message version.
OriginatingNode	Specifies the name of the node that originally published the message. This property is used to prevent circular publishing. If not in the XML file, the system sets it to the publishing node name.	The name of the node that originally published the message.
PublicationID	Specifies the system generated identifier for the publication. The fields, FromNode, Channel, and PublicationID, uniquely identify the publication. If the FromNode is specified and the Publication ID is omitted, the publication ID is set to the next available publication ID on that channel within the subscribing PeopleSoft database.	The system generated identifier for the publication.
Publisher	Specifies the application-defined operator ID class that published the message. This may be required by the application.	The application-defined operator ID class that published the message.
SubChannel	Specifies the name of the subchannel that contains the message. Messages in the same channel, but in different subchannels, are assumed to refer to distinct objects (for example, different POs or different employees), and are processed in parallel if possible. This field contains the concatenated values that represent the subchannel. For example, if the subchannel is Business Unit, Journal ID, then the value of this field is M04123456789 where Business Unit = M04 and Journal ID = 123456789. Include this field if the subscribing PeopleSoft system has a defined subchannel, otherwise, it may be omitted.	The name of the subchannel that contains the message. See the description for the naming format.
Subject	Specifies the name of the message as defined in the PeopleSoft system.	The name of the message as defined in the PeopleSoft system.
SubjectDetail	Specifies the application defined subtype of the message name.	The application defined subtype of the message name.