Skip navigation.

Managing WebLogic Integration Solutions

  Previous Next vertical dots separating previous/next from contents/index/pdf Contents View as PDF   Get Adobe Reader

Trading Partner Management

This section provides the information you need to use the Trading Partner Management module of the WebLogic Integration Administration Console to manage trading partners and services, and to monitor messages and other indicators of trading partner activity. The Trading Partner Management module is divided into the following functional areas which can be accessed from the Trading Partner Management home page:

Note: You must be logged in as a member of the Administrators, IntegrationAdministrators, or IntegrationOperators group to create, change, or delete trading partner management data. See Default Groups, Roles, and Security Policies.

The following topics are provided:

 


About Trading Partner Management

The basic building blocks of trading partner integration are trading partner profiles, services, and service profiles. In WebLogic Integration, a trading partner is understood as an entity that has an agreement with another entity to participate in a specific business transaction, or service, by playing a predefined role. A trading partner profile includes the trading partner's identifying information, and any certificates or protocol binding definitions required to conduct the business transactions.

A service represents a business process that is either offered by a local trading partner, or a business process that is being called via a control on a remote trading partner. In the case of a service offered by a local trading partner, this element directly corresponds to a Web service or process type deployed in the local domain. In the case of a service called by a local trading partner, the service corresponds to a control in the local domain that is used to invoke the remote service. Service profiles specify the protocol binding and URL endpoints for the local and remote trading partners that offer and call the service.

The WebLogic Integration Administration Console allows administrators to configure and manage the required profiles, certificates, and protocol bindings, and to monitor trading partner activity.

To learn more about:

 


Overview of the Trading Partner Management Module

The following table lists the pages you can access from the Trading Partner Management module. The tasks and topics associated with each are provided.

Page

Associated Tasks

Topics

Trading Partner Management

Trading Partner Management Home Page

Select a trading partner management module (Profile Management, Service Management, Message Tracking, Partner Profile Import/Export, Statistics, or Configuration). Return to this page at any time by selecting from the navigation bar.

Trading Partner Management

Profile Management: Partner Profiles

View and Edit Trading Partner Profiles

View a list of trading partners. Trading partner name, type (remote or local), business ID, description, and status of the service profiles associated with the partner (enabled or disabled) are displayed.

Listing and Locating Trading Partners

Filter the list by name. Use ? to match any single character or * to match zero or more characters.

Delete one or more trading partners.

Deleting Trading Partner Profiles

Enable or disable the trading partner profile.

Enabling and Disabling Trading Partner and Service Profiles

Add a New Trading Partner

Add a trading partner.

Adding Trading Partner Profiles

View and Edit Trading Partner Profile

View a partner profile. The name, business ID, business type, trading partner type (local or remote), status, description, and contact information are displayed.

Viewing and Changing Trading Partner Profiles

View summary information for the protocol bindings associated with the trading partner. Add a new binding or select a binding for edit.

Viewing and Changing Bindings

View summary information for the certificates associated with the trading partner. Add a new certificate or select a certificate for edit.

Viewing and Changing Certificates

View summary information for a custom extension. Update the existing custom extension, or add a new custom extension if one does not exist.

Viewing and Changing a Custom Extension

Edit Trading Partner Profile

Update trading partner properties. Change the description, business ID, business type, trading partner type (local or remote), status (enabled or disabled), contact information, or user identity.

Viewing and Changing Trading Partner Profiles

Profile Management: Bindings

Add Binding

Add a new protocol binding to the selected trading partner.

Adding Protocol Bindings to a Trading Partner

View Binding Details

View the properties of a binding.

Viewing and Changing Bindings

Edit Binding

Edit the properties of a binding.

Viewing and Changing Bindings

Profile Management: Certificates

Add Certificate

Add a new certificate to the selected trading partner.

Adding Certificates to a Trading Partner

View and Edit Trading Partner Certificate

View the properties of a certificate or update a certificate.

Viewing and Changing Certificates

Edit Certificate

Update a certificate by importing certificate files.

Viewing and Changing Certificates

Profile Management: Custom Extension

Add Custom Extension

Add custom properties to the trading partner.

Adding a Custom Extension to a Trading Partner

View and Edit Custom Extension

View the custom properties for a trading partner.

Viewing and Changing a Custom Extension

Edit Custom Extension

Change the custom properties for a trading partner.

Viewing and Changing a Custom Extension

Service Management: Services

View and Edit Services

View a list of services. Service name, business service name, description, type, business protocol, and description are displayed.

Viewing and Changing Services

Filter the list by service name. Use ? to match any single character or * to match zero or more characters.

Delete a service.

Deleting Services

Add Service

Add a service definition for a newly deployed service. Assign the name, type, and business protocol. Optionally assign a description.

Adding Services

View and Edit Service Details

View service properties. The type, business protocol, description, version, and associated service profiles are displayed.

Viewing and Changing Services

Select a service profile to view or edit.

Edit Service Details

Update service properties. Change the type, business protocol, description or version. Add service profiles.

Viewing and Changing Services

Add Service Profile

Define a service profile to be added to the service. Enable or disable, specify the message tracking level, and specify the binding and URL endpoint for the local and remote trading partners.

Adding Service Profiles to a Service

View Service Profile

View the properties of a service profile.

Viewing and Changing Service Profiles

Edit Service Profile

Update a service profile. Enable or disable the service, change the message tracking level, or change the binding and URL endpoint for the local and remote trading partners.

Viewing and Changing Service Profiles

Add Authentication

Add authentication to a service profile.

Adding Authentication to a Service Profile

Message Tracking

View Messages

View the list of messages. Event ID, time of event, direction (inbound or outbound), and status are displayed.

Monitoring Messages

Filter the Displayed Messages

Configure the filter for the messages displayed on the View Messages page. Criteria include trading partner sender and receiver, tracking start time and interval, and status.

Filtering the Messages Displayed

Message Details

View message properties and link to detail, such as header, status, or message part data.

Filtering the Messages Displayed

Import/Export

Import Trading Partner Management Data

Select a trading partner management file for import, and set the import properties.

Importing Management Data

Export Trading Partner Management Data

Select trading partners and services for export, and set the export properties.

Exporting Management Data

Bulk Delete

Select trading partner profiles and services to delete and set the delete properties.

Deleting Trading Partner Profiles and Services Using Bulk Delete

Statistics

Trading Partner Management Statistics

View summary statistics. Trading partner count, service count by type (process, service control, or Web service), service profile count, number of conversations, and a count of the sent and received messages are displayed.

Viewing Statistics

Configuration

General Configuration

Set the message tracking properties. Specify the tracking level (all, metadata, or none), directory used to store the messages, and whether or not to trace raw messages.

Configuring the Mode and Message Tracking

Set the trading partner integration mode (test or production).

Proxy Configuration

Configure a proxy host.

Configuring a Proxy Host

Audit Log Configuration

Enable or disable secure audit logging. If enabled, specify the secure audit logging class.

Configuring Secure Audit Logging

Secure Timestamp Configuration

Specify the Java class used for secure time stamping.

Configuring Secure Audit Logging

Refresh Keystore

Refresh the KeyStores (identity and trust) in memory from the disk.

Refreshing the Keystore

Certificate Verification Provider

Specify the certificate verification provider.

Specifying the Certificate Verification Provider


 

 


Configuring Trading Partner Management

The Trading Partner Management Configuration module allows you configure system resources, set the message tracking defaults, or refresh the keystore. See the appropriate topic for instructions:

Configuring the Mode and Message Tracking

The General Configuration page allows you to define the mode (test or production), and message tracking properties for trading partner integration.


 

To set the message tracking properties:

  1. From the Trading Partner Management home page, select the Configuration module.
  2. Set the message tracking properties as required. See the table following this procedure for settings.
  3. Click Submit to save your changes and return to the Trading Partner Management home page.

The following table summarizes settings available on the General Configuration page.

Setting

Description

Required/
Optional

From the Message Tracking Level drop-down list, select All, Metadata, or None.

The default message tracking level for trading partner integration. If the tracking level for a service profile is set to Default (see Adding Service Profiles to a Service), the tracking level for the service profile defaults to the setting specified here. The options are:

All
Message metadata and a reference to message contents in the document store are persisted in message tracking tables. Both message metadata and contents are available for view in the Message Tracking module of the console.

Metadata
Only message metadata is persisted in message tracking tables. Message contents are not tracked and are not available for view in the Message Tracking module of the console.

None
No message tracking information or history is stored in repository and no information is available for view in the Message Tracking module of the console.

Required

From the Mode drop-down list, select Test or Production.

The trading partner integration mode. In Test mode service profiles are not required for sending and receiving business messages between collocated trading partners. Default bindings for both partners can be used in test mode.

Required

In the Directory field, enter the path.

The path to a directory used to store messages.

Required if Trace Raw Message is set to Yes.

Select the Trace Raw Messages Yes or No option button.

When set to Yes, messages are also stored in their raw format (the format of the message as it is sent over the wire). This setting can be useful for debugging purposes.

Required


 

Configuring a Proxy Host

The Proxy Configuration page allows you to define a proxy host for trading partner integration.


 

Note: A proxy server is used to protect local network addresses from hackers and restrict and monitor external network access from the network hosting WebLogic Integration.

To set the proxy host:

  1. From the Trading Partner Management home page, select the Configuration module.
  2. From the left panel, select Proxy Host.
  3. In the Proxy Host field, enter the host name or IP address.
  4. In the Port number of proxy server, enter the port.
  5. Click Submit to save your changes and return to the Trading Partner Management home page.

Configuring Secure Audit Logging

The Audit Log Configuration page allows you to specify whether or not signed messages are logged to the secure audit log. If secure audit logging is enabled, the Secure Timestamp Configuration page allows you to specify the Java class that implements the secure timestamp class.


 

Note: The classes specified for secure audit logging and secure timestamp must be in the server classpath. Changes to the secure audit logging or secure timestamp configuration require server restart.

To enable or disable secure audit logging:

  1. From the Trading Partner Management home page, select the Configuration module.
  2. From the left panel, select Secure Audit Log.
  3. Do one of the following:
  4. Click Submit to save your changes and return to the Trading Partner Management home page.

To specify the Java class for secure time stamping:

  1. From the Trading Partner Management home page, select the Configuration module.
  2. From the left panel, select Secure Timestamp.
  3. The Secure Timestamp Configuration page is displayed.


     
  4. In the Secure Timestamp Class field, enter the class.
  5. Note: If no class is entered, secure time stamping is disabled.

  6. Click Submit to save your changes and return to the Trading Partner Management home page.

Refreshing the Keystore

The Refresh Keystore page allows you to refresh the KeyStores (identity and trust) in memory from the disk.


 

To refresh the keystore:

  1. From the Trading Partner Management home page, select the Configuration module.
  2. From the left panel, select Refresh Keystore.
  3. Click the Refresh Keystore button to refresh the keystore and return to the Trading Partner Management home page.

Specifying the Certificate Verification Provider

The Certificate Verification Provider page allows you to specify the certificate verification provider for trading partner integration.


 

Trading partner integration provides a service provider interface that allows you to insert a Java class that implements an interface that calls out to a third-party service to verify trading partner certificates. Such an implementation, called a certificate verification provider (CVP), can call out to one of the following certificate verification applications:

To learn how to implement the CVP, see "Using WebLogic Integration Security" in Deploying WebLogic Integration Solutions.

Note: The CVP class must be in the server classpath. Changes to the CVP configuration require server restart.

To specify the certificate verification provider:

  1. From the Trading Partner Management home page, select the Configuration module.
  2. From the left panel, select Certificate Verification Provider.
  3. In the Certificate Verification Provider field, enter the CVP Java class.
  4. Click Submit to save your changes and return to the Trading Partner Management home page.

 


Adding Trading Partner Profiles

The Add Trading Partner Profile page allows you to create a new trading partner profile.


 

To add a trading partner profile:

  1. From the Trading Partner Management home page, select the Profile Management module.
  2. From the left panel, select Create New.
  3. Set trading partner profile properties as required. See Defining Trading Partner Profiles for a description of the available settings.
  4. Click Submit.
  5. The View and Edit Trading Partner Profile page is displayed with the new profile definition.

    Note: If there is an error, the Add Trading Partner Profile page is redisplayed. A message indicating the problem is displayed above the input requiring correction.

  6. Do one or more of the following:

 


Adding Certificates to a Trading Partner

The Add Certificate page allows you to add certificates to a trading partner profile.

Note: You can also add a certificate from the Add Trading Partner Binding or Edit Trading Partner Binding page by clicking the Add Certificate link to the right of the Signature Certificate drop-down list. If you are adding a certificate in this way, start with step 3 of the following procedure.

To select the type of certificate:

  1. Do one of the following:
  2. Click the Add Certificate button.
  3. The Add Certificate (Step 1 of 2) page is displayed.


     
  4. Select one of the following options:
  5. Click Next to display the Add Certificate (Step 2 of 2) page. Refer to the procedure appropriate to the selected type:

Creating a Certificate for Testing

After you select Generate a certificate for TEST USE only and click Next, the Add Certificate (Step 2 of 2) page is displayed.


 

This page allows you to create a client, signature, or encryption certificate definition. The certificate generated is appropriate for use only in testing.

To create a certificate for testing:

  1. In the Name field, enter the name used to identify the certificate within the system. This name is also the entry name in the local keystore.
  2. From the Type drop-down list, select the type:
  3. From the Password Alias drop-down list, select the password alias for the password associated with the keystore entry. This alias is used to retrieve the required password from the password store. See Password Aliases and the Password Store.
  4. Note: If you have not yet defined an entry for the password in the password store, click Add Alias. After you add the entry, you are returned to the Add Certificate page. The newly added alias is now included in the drop-down list.

  5. Check the Import Certificate in Keystore check box.
  6. Click Create Certificate.
  7. The View and Edit Trading Partner Profile page is displayed. The certificate is included in the certificates summary table.

    Note: If there is an error, the Add Certificate page is redisplayed. A message indicating the problem is displayed above the input requiring correction.

Creating and Importing the Files for a Certificate

After you select Import certificate from file and click Next, the Add Certificate (Step 2 of 2) page is displayed.


 

This page allows you to create a client, signature, or encryption certificate definition, and to import the certificate files.

To create a certificate definition and import the certificate files:

  1. In the Name field, enter the name used to identity the certificate within the system. This name is also the entry name in the local keystore.
  2. From the Type drop-down list, select the type:
  3. If you are importing a certificate for a local trading partner, select the alias for the password associated with the keystore entry from the Password Alias drop-down list. This alias is used to retrieve the required password from the password store. See Password Aliases and the Password Store.
  4. Note: This step only applies if you are importing a certificate for a local trading partner.

    Note: If you have not yet defined an entry for the password in the password store, click Add Alias. After you add the entry, you are returned to the Add Certificate page. The newly added alias is now included in the drop-down list.

  5. Do one of the following to specify the location of the certificate file:
  6. To specify the location of the private key file for a LOCAL trading partner, do one of the following:
  7. Check the Import Certificate in Keystore check box.
  8. Click Create Certificate.
  9. The View and Edit Trading Partner Profile page is displayed. The certificate is included in the certificates summary table.

    Note: If there is an error, the Add Certificate page is redisplayed. A message indicating the problem is displayed above the input requiring correction.

Creating a Reference to an Existing Certificate

After you select Use alias for an already imported certificate and click Next, the Add Certificate (Step 2 of 2) page is displayed.


 

This page allows you to create a reference to an existing client, signature, encryption, or server certificate definition.

To create a reference to an existing certificate definition:

  1. In the Name field, enter the name used to identity the certificate within the system.
  2. From the Type drop-down list, select CLIENT, SERVER, SIGNATURE, or ENCRYPTION.
  3. From the Password Alias drop-down list, select the password alias for the password associated with the keystore entry. This alias is used to retrieve the required password from the password store. See Password Aliases and the Password Store.
  4. Note: If you have not yet defined an entry for the password in the password store, click Add Alias. After you add the entry, you are returned to the Add Certificate page. The newly added alias is now included in the drop-down list.

  5. Click Add.
  6. The View and Edit Trading Partner Profile page is displayed. The certificate reference is included in the certificates summary table.

    Note: If there is an error, the Add Certificate page is redisplayed. A message indicating the problem is displayed above the input requiring correction.

 


Adding Protocol Bindings to a Trading Partner

The Add Binding page allows you to add bindings to a trading partner profile.

To add a binding to a trading partner profile:

  1. Do one of the following:
  2. Click the Add Binding button.
  3. The Add Binding (Step 1 of 2) page is displayed.


     
  4. Select the ebXML 1.0, ebXML 2.0, RosettaNet 1.1, RosettaNet 2.0, or Web Service option button.
  5. Click Create Binding to display the Add Binding (Step 2 of 2) page.
  6. Set the binding properties as required. See Defining Protocol Bindings for a description of the available settings.
  7. Click Add Binding.
  8. The View and Edit Trading Partner Profile page is displayed. The binding is included in the binding summary table.

    Note: If there is an error, the Add Binding page is redisplayed. A message indicating the problem is displayed above the input requiring correction.

  9. If the new binding is:

 


Adding a Custom Extension to a Trading Partner

The default properties associated with a trading partner can be augmented to support application-specific requirements through the addition of a custom extension. A custom extension is modeled in the repository so that defined properties can be retrieved as subtrees within an XML document. The properties can be retrieved using the TPM control.

The extension is composed of a user-defined root element that contains well-formed XML elements and attributes that define the required properties. The user-defined root element is a child of the <extended-property-set> element, which is the last child of the <trading-partner> element. The following example shows the XML representation of a trading partner with a custom extension.

Custom Extension Example

...
<trading-partner
name="ABC"
business-id-type="duns"
business-id="123123123"
phone="+1 123 456 7890">
email="admin@abc.com"
<address>123 ABC Street., Anytown, CA 95131</address>
<extended-property-set
name="ABC International Extension"
description="Contact">
<myxmlelement>
<business-contact>Joe Smith</business-contact>
<phone type="work">+1 123 456 7654</phone>
<phone type="cell">+1 321 654 4567</phone>
<city>Anytown</city>
<state>California</state>
</myxmlelement>
</extended-property-set>
</trading-partner>
...

An administrator can add a custom extension as described in the following procedure, or by importing a trading partner data file that contains an XML representation of the extended properties as described in Importing Management Data.

To add custom properties to a trading partner profile:

  1. Do one of the following:
  2. Click the Add Custom Extension button.
  3. The Add Custom Extension page is displayed.


     
  4. In the Name field, enter a name for the custom extension.
  5. In the Description field, enter an optional description.
  6. In the XML field, enter the XML document.
  7. The extension is composed of a user-defined root element that contains well-formed XML elements and attributes that define the required properties. For example, the XML highlighted in bold in the Custom Extension Example constitutes a valid entry.

  8. Click Create Custom Extension.
  9. The View and Edit Trading Partner Profile page is displayed. The custom extension is displayed in the Custom Extension summary table.

    Note: If there is an error, the Add Custom Extension page is redisplayed. A message indicating the problem is displayed above the input requiring correction.

 


Adding Services

The Add Service page allows you to create a new service definition.


 

To add a service:

  1. From the Trading Partner Management home page, select the Service Management module.
  2. From the left panel, select Create New.
  3. Do one of the following:
  4. From the Type drop-down list, select Service Control, Process, or Web Service to specify the type of service.
  5. From the Business Protocol drop-down list, select EBXML, ROSETTANET, or WEBSERVICE to specify the service protocol.
  6. In the Description field, enter an optional description of the service.
  7. Click Add Service.
  8. The View and Edit Service Details page is displayed with the new definition.

    Note: If there is an error, the Add Service page is redisplayed. A message indicating the problem is displayed above the input requiring correction.

  9. To add service profiles to the service, see Adding Service Profiles to a Service.
  10. If the Business Protocol is ROSETTANET, you can define the RosettaNet service defaults as described in the following section.

Adding Defaults to a RosettaNet Service

Once you have created a the service definition for a RosettaNet service, you can add service defaults from the View and Edit Service Details page.

To add RosettaNet Service Defaults:

  1. Locate the service as described in Listing and Locating Services.
  2. Click the service name to select it.
  3. The View and Edit Service Details page is displayed.


     
  4. Click Add Defaults.
  5. Define the defaults as required. The following table describes the available settings.
  6. Service Content Schema Location

    Location of the schemas on the file system You must enter a valid path.

    Use DTD for Validation

    True

    Use DTD over schemas for validating documents received and sent.

    False

    Do not use DTD for validation.

    Validate Service Content

    True

    Validate service content for each message

    False

    No validation is performed. Selecting False improves performance.

    Validate Service Header

    True

    Validate service header for each message

    False

    No validation is performed. Selecting False improves performance.


     
  7. Click Set Defaults to save the settings and return to the View and Edit Service Details page.

 


Adding Service Profiles to a Service

The View and Edit Service Details page allows you to add service profiles to a service.


 

To add service profiles to a service:

  1. Locate the service as described in Listing and Locating Services.
  2. Click the service name to select it.
  3. The View and Edit Service Details page is displayed.

  4. Click the Add Service Profile button.
  5. The Add Service Profile page is displayed.


     
  6. From the Status drop-down list, select Enabled or Disabled.
  7. From the Message Tracking Level drop-down list, select one of the following:
  8. Configure the Local trading partner as follows:
    1. From the Name drop-down list, select the name of the trading partner.
    2. From the Binding drop-down list, select the binding. Only bindings of the same type as the Business Protocol defined for the service are allowed.
    3. The Endpoint field displays the URL for the transport endpoint for the selected binding.

  9. Configure the Remote trading partner as follows:
    1. From the Name drop-down list, select the name of the trading partner.
    2. From the Binding drop-down list, select the binding. Only bindings of the same type as the Business Protocol defined for the service are allowed.
    3. The Endpoint field displays the URL for the transport endpoint for the selected binding.

  10. Click Submit.
  11. You are prompted with the following message" "Do you wish to configure authentication?"

  12. Do one of the following:
  13. The View and Edit Service Details page is displayed. The new profile is displayed in the service profile summary table.

    Note: If there is an error, the Add Service Profile page is redisplayed. A message indicating the problem is displayed above the input requiring correction.

Adding Authentication to a Service Profile

The View Service Profile page allows you to configure the authentication properties for the local and remote trading partners.

When you add authentication to a service profile, the required authentication configuration is added to each respective trading partner binding. The authentication configuration associated with a binding can be updated or deleted as described in Updating or Deleting Authentication.

The following table summarizes the available modes of authentication by transport protocol and describes the authentication properties added to each trading partner binding.

Transport Protocol

Authentication Mode

Local Trading Partner (LocalTP) Configuration

Remote Trading Partner (RemoteTP) Configuration

HTTP

Basic

Client Trading Partner:
RemoteTP

Client Trading Partner:
LocalTP

Username and Password Alias:
RemoteTP username and password (the password alias for the password is specified). The username and password required to access the RemoteTP transport endpoint.

HTTPS

One-Way

Client Trading Partner:
RemoteTP

Client Trading Partner:
LocalTP

Server Certificate:
RemoteTP server certificate to be used for SSL authentication.

One-Way with Basic

Client Trading Partner:
RemoteTP

Client Trading Partner:
LocalTP

Username and Password Alias:
RemoteTP username and password (the password alias for the password is specified). The username and password required to access the RemoteTP transport endpoint.

Server Certificate:
RemoteTP server certificate to be used for SSL authentication.

Mutual

Client Trading Partner:
RemoteTP

Client Certificate:
RemoteTP client certificate to be used for SSL mutual authentication.

Client Trading Partner:
LocalTP

Client Certificate:
LocalTP client certificate to be used for SSL mutual authentication.

Server Certificate:
RemoteTP server certificate to be used for SSL authentication.


 

To add HTTPS authentication to a service profile:

  1. Locate the service as described in Listing and Locating Services.
  2. Click the service name to select it.
  3. The View and Edit Service Details page is displayed.

  4. In the Service Profiles table, click the View link for the service profile entry. (The View link is in the third column from the right.)
  5. The View Service Profile page is displayed.

  6. Click Configure Authentication.
  7. You are prompted to select the authentication mode for the local and remote trading partners as shown in the following figure:


     

    Note: Although it is not enforced, typically the same type of authentication is selected for both the local and remote trading partner.

  8. Select the One Way, One-Way with Basic, or Mutual option button to specify the type for the Local trading partner.
  9. Select the One Way, One-Way with Basic, or Mutual option button to specify the type for the Remote trading partner.
  10. Click the Next button.
  11. Select the certificate(s), or enter the username and password alias, required for the selected type. The following table summarizes the settings by authentication type.
  12. Authentication Type

    Local

    Remote

    One-Way

    No local setting.

    Select the Server Certificate from the drop-down list.

    One-Way with Basic

    Enter the Username required to access the remote endpoint.

    Select the Password Alias from the drop-down list.

    Select the Server Certificate from the drop-down list.

    Mutual

    Select the Client Certificate from the drop-down list.

    Select the Client Certificate from the drop-down list.

    Select the Server Certificate from the drop-down list.


     

    Note: If the certificate has not yet been added, click the Add Certificate link to the right of the drop-down list. See Adding Certificates to a Trading Partner for instructions. Once the certificate has been added, it is available for selection. Similarly, if the password alias has not been added, click the Add Alias link to the left of the drop-down list. See Adding Passwords to the Password Store for instructions. Once the alias has been added, it is available for selection.

  13. To preview to the configuration, click Preview config. To learn more about the preview function, see Previewing the Authentication Configuration:.
  14. Click Add.
  15. Authentication is added and the View and Edit Service Details page is displayed.

    Note: If there is an error, the Add Authentication page is redisplayed. A message indicating the problem is displayed above the input requiring correction.

To add HTTP authentication to a service profile:

  1. Locate the service as described in Listing and Locating Services.
  2. Click the service name to select it.
  3. The View and Edit Service Details page is displayed.

  4. In the Service Profiles table, click the View link for the service profile entry. (The View link is in the third column from the right.)
  5. The View Service Profile page is displayed.

  6. Click Configure Authentication.
  7. The authentication mode is displayed as shown in the following figure:


     
  8. Click the Next button.
  9. Enter the Username required to access the remote endpoint.
  10. Select the Password Alias from the drop-down list.
  11. Note: If the password alias has not been added, click the Add Alias link to the left of the drop-down list. See Adding Passwords to the Password Store for instructions. Once the alias has been added, it is available for selection.

  12. To preview to the configuration, click Preview config. To learn more about the preview function, see Previewing the Authentication Configuration:.
  13. Click Add.
  14. Authentication is added and the View and Edit Service Details page is displayed.

    Note: If there is an error, the Add Authentication page is redisplayed. A message indicating the problem is displayed above the input requiring correction.

Previewing the Authentication Configuration:

The verification of certificates and exchange of public keys that occurs in order to set up a secure channel over which to communicate is known at the SSL handshake. When you configure authentication, you have the option of previewing the configuration.

For the HTTPS transport protocol, the preview provides a summary of the handshake configured as shown in the following figures:


 


 


 

For HTTP basic authentication, the preview displays the configuration as shown in the following figure:


 

 


Defining Trading Partner Profiles

The Add Trading Partner Profile and Edit Trading Partner Profile pages allow you to define the properties of a profile. The following table summarizes the available settings.

Setting

Description

Required/
Optional

In the Name field, enter the name.

The name used to identify the trading partner within the system. Do not use spaces.

Note: This field is only available on the Add Trading Partner Profile page. It cannot be edited on the Edit Trading Partner Profile page.

Required

In the Description field, enter a description.

An optional description. This value is for administrative purposes only. It is not included in messages.

Optional

In the Business ID field, enter an appropriate identifier.

Identifier for the trading partner. The value is used to identify the partner in message exchanges.

Required

In the Business ID Type field, enter the type of Business ID.

The type or naming convention for the Business ID. For example, if the value entered for Business ID is a D-U-N-S number, enter DUNS for the Business ID Type.

Optional

Check or uncheck the Default Trading Partner check box.

When checked, the trading partner is designated the default trading partner for sending or receiving messages for the local host system. Default Trading Partner can only be checked if Type is set to LOCAL. Only one LOCAL trading partner can be designated the default.

The default is unchecked.

Optional

From the Type drop-down list, select LOCAL or REMOTE.

Specifies whether the trading partner is hosted locally or represents an external, remote trading partner.

The default is LOCAL.

Optional

From the Status drop-down list, select ENABLED or DISABLED.

Specifies whether or not to allow business messages to be sent or received by the partner

You cannot set the Status to DISABLED until all service profiles associated with the partner are disabled. If you attempt to set the Status to DISABLED, you are prompted to disable any enabled service profiles before the change takes effect.

Setting the Status to ENABLED does not automatically enable the service profiles associated with the trading partner. After you enable the trading partner profile, you must enable the associated service profiles as described in Enabling and Disabling Trading Partner and Service Profiles.

The default is ENABLED.

Optional

In the Email field, enter an email address.

A contact email address for the trading partner.

Optional

In the Address field, enter a mailing address.

A mailing address for the trading partner.

Optional

In the Phone field, enter a telephone number.

A contact telephone number for the trading partner.

Optional

In the Fax field, enter a fax number.

A fax number for the trading partner.

Optional

In the WLS User Name field, enter a valid user name.

The user name that is used to authorize remote trading partners at the transport level. This user must exist in the default security realm. See Listing and Locating Users. The value applies only if Type is set to Remote.

Optional


 

 


Defining Protocol Bindings

The Add Binding and Edit Binding pages allow you to define the properties for a protocol binding. For example, the Add Binding page for ebXML 2.0 is shown in the following figure.


 

The following sections describe the available settings for each protocol type and a special case regarding Trading Partner Endpoint definition:

Defining an ebXML 1.0 or 2.0 Binding

The following table describes the settings available for an ebXML 1.0 or 2.0 binding.

Note: When exchanging ebXML messages with a trading partner that uses WebLogic Integration - Business Connect, you can only use one version of ebXML Message Service protocol (either ebXML 1.0 or ebXML 2.0). WebLogic Integration - Business Connect uses the same HTTP endpoint for a given trading partner regardless of the ebXML version. You cannot configure more than one protocol binding for a given partner in WebLogic Integration that uses the same HTTP endpoint.

Setting

Description

Required/
Optional

In the Name field, enter the binding name.

The name used to identify the binding within the system. The name must be unique within the trading partner profile. When you add a new binding, a default name is automatically generated using the following convention:

<partner>-<protocol>-<qualifier>

For example:

acme-ebxml20-4

If you choose to change the default name, make sure the name you choose is unique.

Note: This field is only available on the Add Binding page. It cannot be edited on the Edit Binding page.

Required

Check or uncheck the Default Binding check box.

When checked, the binding is designated as the default binding for the ebXML protocol. Only one binding of the same protocol version can be designated the default binding.

The default is unchecked.

Optional

Transport Configuration

From the Transport Protocol drop-down list, select the HTTP or HTTPS.

The transport protocol for sending and receiving messages.

The default is HTTP.

Optional

From the Transport Protocol Version, select the version.

The version of the transport protocol.

If HTTP is selected for the Transport Protocol, select 1.0 or 1.1. The default is 1.0.

If HTTPS is selected for Transport Protocol, 1.1 is currently the only option.

Optional

In the Endpoint field, enter the URL for the transport endpoint.

The URL or URI for the transport endpoint.

For information about specifying an endpoint as a URI, see Defining Endpoints for Projects Containing Multiple JPDs Having the Same Name.

Required

In the Timeout field, enter the transport timeout.

The transport timeout for the specified Endpoint. The default value is 0, which indicates no timeout.

Optional

Quality of Service

From the Delivery Semantics drop-down list, do one of the following:

  • For ebXML 1.0, select BESTEFFORT or ONCEANDONLYONCE

  • For ebXML 2.0, select BESTEFFORT, ONCEANDONLYONCE, ATLEASTONCE, or ATMOSTONCE

The reliable message service behavior:

BESTEFFORT
Best effort. No reliable messaging.

ONCEANDONLYONCE
Once and only once reliable messaging. Select this option for messaging that requires acknowledgement and duplicate elimination.

ATLEASTONCE
At least once reliable messaging. Select this option for messaging that requires acknowledgement, but not duplicate elimination.

ATMOSTONCE
At most once reliable messaging. Select this option for messaging that requires duplicate elimination, but not acknowledgement.

Required

In the Retry Count field, enter the number of retries.

The maximum number of retries for sending a reliably delivered message. The default is 0.

The value is ignored if BESTEFFORT or ATMOSTONCE is selected for Delivery Semantics. If ONCEANDONLYONCE or ATLEASTONCE is selected, the message is retried until the acknowledgement is received or the number of retries specified in the Retry Count field is exhausted.

Required if ONCEANDONLYONCE or ATLEASTONCE is selected,

In the Retry Interval field, enter the interval.

The time interval before a message is resent following a timeout waiting for a message acknowledgement.

The following are examples of valid entries:
500 ms or 500 msecs,
5 s, or 5 sec, or 5 secs
5 m or 5 mins
5 h or 5 hours
5 d or 5 days

Any combination of the above are also valid. For example:

1 d 5 h
1 sec 500 ms

The default is 1 min.

Required if Retry Count is 1 or greater.

In the Persist Duration, enter the interval.

Specifies the duration for which messages have to be stored persistently for the purpose of duplicate elimination.

The following are examples of valid entries:
500 ms or 500 msecs,
5 s, or 5 sec, or 5 secs
5 m or 5 mins
5 h or 5 hours
5 d or 5 days

Any combination of the above are also valid. For example:

1 d 5 h
1 sec 500 ms

The default is 0.

Required if ONCEANDONLYONCE or ATMOSTONCE is selected,

Note: When defining an ebXML binding for a local trading partner, set the values for Retry Count, Retry Interval, and Persist Duration to the same values as the remote trading partner.

XML Digital Signature Configuration for Non-Repudiation

From the Signature Certificate drop-down list, select an existing certificate or NONE.

If you have not yet added the certificate, click Add certificate and follow the instructions in Adding Certificates to a Trading Partner.

The name of the signature certificate used to digitally sign messages. NONE indicates no digital signature.

Optional

Check or uncheck the Signature Required check box.

When checked, the message is digitally signed using the signature certificate of the trading partner sending the message. The default is unchecked.

Archiving of signed messages in a secure audit log is controlled by the secure audit logging configuration. See Configuring Secure Audit Logging.

Optional

Check or uncheck the Signature Receipt Required check box.

When checked, the message is acknowledged by a digitally signed receipt acknowledgement message using the signature certificate of the trading partner sending the acknowledgement. The default is unchecked.

Archiving of signed messages in a secure audit log is controlled by the secure audit logging configuration. See Configuring Secure Audit Logging.