TIBCO BusinessConnect™

(1)

Edition

Trading Partner Management

Software Release 1.0

May 2020

(2)

Important Information

SOME TIBCO SOFTWARE EMBEDS OR BUNDLES OTHER TIBCO SOFTWARE. USE OF SUCH EMBEDDED OR BUNDLED TIBCO SOFTWARE IS SOLELY TO ENABLE THE FUNCTIONALITY (OR PROVIDE LIMITED ADD-ON FUNCTIONALITY) OF THE LICENSED TIBCO SOFTWARE. THE EMBEDDED OR BUNDLED SOFTWARE IS NOT LICENSED TO BE USED OR ACCESSED BY ANY OTHER TIBCO SOFTWARE OR FOR ANY OTHER PURPOSE.

USE OF TIBCO SOFTWARE AND THIS DOCUMENT IS SUBJECT TO THE TERMS AND CONDITIONS OF A LICENSE AGREEMENT FOUND IN EITHER A SEPARATELY EXECUTED SOFTWARE LICENSE AGREEMENT, OR, IF THERE IS NO SUCH SEPARATE AGREEMENT, THE CLICKWRAP END USER LICENSE AGREEMENT WHICH IS DISPLAYED DURING DOWNLOAD OR INSTALLATION OF THE SOFTWARE (AND WHICH IS DUPLICATED IN THE LICENSE FILE) OR IF THERE IS NO SUCH SOFTWARE LICENSE AGREEMENT OR CLICKWRAP END USER LICENSE AGREEMENT, THE LICENSE(S) LOCATED IN THE “LICENSE” FILE(S) OF THE

SOFTWARE. USE OF THIS DOCUMENT IS SUBJECT TO THOSE TERMS AND CONDITIONS, AND YOUR USE HEREOF SHALL CONSTITUTE ACCEPTANCE OF AND AN AGREEMENT TO BE BOUND BY THE SAME.

ANY SOFTWARE ITEM IDENTIFIED AS THIRD PARTY LIBRARY IS AVAILABLE UNDER SEPARATE SOFTWARE LICENSE TERMS AND IS NOT PART OF A TIBCO PRODUCT. AS SUCH, THESE SOFTWARE ITEMS ARE NOT COVERED BY THE TERMS OF YOUR AGREEMENT WITH TIBCO, INCLUDING ANY TERMS CONCERNING SUPPORT, MAINTENANCE, WARRANTIES, AND INDEMNITIES. DOWNLOAD AND USE OF THESE ITEMS IS SOLELY AT YOUR OWN

DISCRETION AND SUBJECT TO THE LICENSE TERMS APPLICABLE TO THEM. BY PROCEEDING TO DOWNLOAD, INSTALL OR USE ANY OF THESE ITEMS, YOU ACKNOWLEDGE THE

FOREGOING DISTINCTIONS BETWEEN THESE ITEMS AND TIBCO PRODUCTS.

This document is subject to U.S. and international copyright laws and treaties. No part of this document may be reproduced in any form without the written authorization of TIBCO Software Inc.

TIBCO, the TIBCO logo, the TIBCO O logo, TIB, and TIBCO Enterprise Message Service are either registered trademarks or trademarks of TIBCO Software Inc. in the United States and/or other countries.

Java and all Java based trademarks and logos are trademarks or registered trademarks of Oracle and/or its affiliates.

All other product and company names and marks mentioned in this document are the property of their respective owners and are mentioned for identification purposes only.

This software may be available on multiple operating systems. However, not all operating system platforms for a specific software version are released at the same time. Please see the readme.txt file for the availability of this software version on a specific operating system platform.

THIS DOCUMENT IS PROVIDED “AS IS” WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF

MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, OR NON-INFRINGEMENT.

THIS DOCUMENT COULD INCLUDE TECHNICAL INACCURACIES OR TYPOGRAPHICAL ERRORS. CHANGES ARE PERIODICALLY ADDED TO THE INFORMATION HEREIN; THESE CHANGES WILL BE INCORPORATED IN NEW EDITIONS OF THIS DOCUMENT. TIBCO SOFTWARE INC. MAY MAKE IMPROVEMENTS AND/OR CHANGES IN THE PRODUCT(S) AND/OR THE PROGRAM(S) DESCRIBED IN THIS DOCUMENT AT ANY TIME.

(3)

(4)

TIBCO Documentation and Support Services

How to Access TIBCO Documentation

Documentation for TIBCO products is available on the TIBCO Product Documentation website, mainly in HTML and PDF formats.

The TIBCO Product Documentation website is updated frequently and is more current than any other documentation included with the product. To access the latest documentation, visit https://

docs.tibco.com.

Product-Specific Documentation

Documentation for TIBCO BusinessConnect^™ Container Edition is available on the TIBCO

BusinessConnect^™ Container Edition Product Documentation page.

The following documents for this product can be found on the TIBCO Documentation site:

● TIBCO BusinessConnect^™ Container Edition Release Notes

● TIBCO BusinessConnect^™ Container Edition Installation and Deployment

● TIBCO BusinessConnect^™ Container Edition Concepts

● TIBCO BusinessConnect^™ Container Edition Administration Guide

● TIBCO BusinessConnect^™ Container Edition Trading Partner Management

● TIBCO BusinessConnect^™ Container Edition Security Guidelines

How to Contact TIBCO Support

You can contact TIBCO Support in the following ways:

● For an overview of TIBCO Support, visit http://www.tibco.com/services/support.

● For accessing the Support Knowledge Base and getting personalized content about products you are interested in, visit the TIBCO Support portal at https://support.tibco.com.

● For creating a Support case, you must have a valid maintenance or support contract with TIBCO.

You also need a user name and password to log in to https://support.tibco.com. If you do not have a user name, you can request one by clicking Register on the website.

How to Join TIBCO Community

TIBCO Community is the official channel for TIBCO customers, partners, and employee subject matter experts to share and access their collective experience. TIBCO Community offers access to Q&A forums, product wikis, and best practices. It also offers access to extensions, adapters, solution accelerators, and tools that extend and enable customers to gain full value from TIBCO products. In addition, users can submit and vote on feature requests from within the TIBCO Ideas Portal. For a free registration, go to https://community.tibco.com.

(9)

The Login Page

To log in to the TIBCO BusinessConnect^™ Container Edition, provide the following default credentials:

● Username: admin

● Password: Password

An SMTP Proxy Server should be already enabled on the BusinessConnect Container Edition Admin UI if you want to recover your forgotten password.

If the sample certificate used to connect to the Gmail server expires, download a new Gmail server certificate (if required).

For more information, see the following

● Email Inbound POP3 Service Configurations

● Email Outbound Proxy Server Configuration

(10)

Dashboard

From this page, you can navigate to the different features of TIBCO BusinessConnect Container Edition.

Data Viewer

Displays transaction search page on Audit Trail.

Partner Management

Manages the participants and business agreement between them.

B2B Administration:

Manages different operations for the business protocols.

User Management:

Defines different access privileges for users and roles System Settings:

Provides access to modify and configure different parameters such as transport protocols, servers, certificates, and metadata

(11)

Hosts Overview

Hosts are the participants who sponsor a trading community, where standardized business transactions can occur between trading partners. A host can be retailer, manufacturer, or any sponsor who creates a trading community.

You can manage hosts as follows:

● Searching for a Host

● Creating a Host

● Configuring a Host

● Deleting Hosts

On Hosts page, you can enable or disable the switch in the Status column to activate or deactivate a host.

Searching for a Host

In addition to entering the host’s name or selecting it from the list, you can use the Search function to find a specific host.

Procedure

● Enter the search string in the Search field to search hosts.

The names of one or more hosts that correspond to the search criteria only are displayed.

Creating a Host

To create a new Host, perform the following steps:

Procedure

1. On the Partner Management tile, click Hosts.

2. On the Hosts page, click Create Host, which is in the upper-right corner of the page.

3. On the Create New Host page, in the Host Name field, enter the name of the host you want to create and then click any one of the push buttons:

Option Description

Done To create the host.

Proceed To instantly configure the data of the new host

For detailed information on configuring the host data , see Configuring a Host.

The first host that you create automatically becomes the default host. If you have created multiple host participants, you can assign any one of them as the default host by selecting Make this as Default Host check box while creating or configuring a host . The default host is displayed in the upper-right corner of the table on the Hosts page.

4. After you have provided all the required information, click Done.

The status of the newly created host is by default enabled.

(12)

Configuring a Host

The configuring of a host includes tasks such as setting up the protocols, editing the configurations of the protocols, credentials, and business locations.

To edit the host data, perform the following steps:

You can either configure the data when creating the host or later configure the data of the already created host .

Procedure

2. On the Hosts page, select the host whose information you wish to edit.

The three tabs: Protocols, Credentials, and Business Location are displayed.

3. To provide detailed information about the host, provide information for the following tabs:

Protocols To enable or edit configurations of protocols, click Protocols tab. For detailed information on configuring the protocols, see Configure Protocols for Hosts.

Credentials To add new credentials, click Credentials tab. For detailed information on uploading the credentials, see Manage Credentials for Hosts.

Business

Locations To add information about the address and contact information for the company headquarters, click Business Locations tab. For more information, see Add Business Locations of Hosts.

Configure Protocols for Hosts

You can enable or disable protocols, or edit protocol configurations for hosts using Protocols tab.

To configure the protocols of a host, perform the following steps:

Procedure

1. On the Hosts page, click a host whose protocols you wish to configure.

2. On the Edit Host page, select the business protocols that are available to use for the future communication with the selected host.

3. To edit the configurations of protocols, click Edit Configurations tab.

For detailed information on editing the protocols, see the appropriate documentation for the specific protocol.

4. Click Done.

Manage Credentials for Hosts

You can search, add, and delete credentials for hosts.

You can only add keys in the host credentials tab.

(13)

Procedure

● Enter the search string in the Search field to search the credentials.

One or more credentials that correspond to the search criteria are only displayed.

Adding a Credential

To add credentials for a host, perform the following steps:

Procedure

1. On the Edit Host page, on the Credentials tab, click add icon and select any one of the following options to create the respective key:

New Private Key New certificate key for the partner New PGP Private Key Private key for encryption at host side

New SSH Private Key SSH keys are used to support the SSHFTP transport.

Based on which option you choose, the respective dialog box opens in which you can upload the key.

2. In the dialog box, provide the following details:

New Private Key/New PGP Private Key/New SSH Private Key Field Description

Alias Enter the name of the key.

Upload file Click Add files or drop files to browse and navigate to the file containing the key.

Password Enter the password. The default passsword for sample keys is ^Password1 The newly created key for the host is now listed in the credentials table.

To add more credentials to the list, click add icon on the Credentials tab on the Edit Host page.

Deleting Credentials

To delete one or more credentials:

Procedure

1. In the Credentials tab, select the credential that you wish to delete and then click Delete icon.

2. On the pop-up dialog box, click OK.

Add Business Locations of Hosts

A business location is the address and other identifying information of a host. One host often has multiple departments or other distinct groups at various locations. You can set up multiple locations for one host to simplify shipping and billing procedures. It can also include contact information such as name, phone number, and email address of a person associated with a particular location. Each business location can have multiple contacts

(14)

The Headquarters location is created when RosettaNet protocol is enabled for the Host.

To add a business location for a host, perform these steps:

Procedure

1. On the Business Locations tab, click add icon . The Add Location dialog box is displayed.

2. In the Add Location dialog box, enter the following details:

Details

Field Description

Location Name Enter the name of the location.

Email Enter email ID.

Phone Enter contact number.

FAX Enter fax number.

Web URL Enter web URL

Address Enter address.

Primary Legal

Contact Select the legal contact information from the drop-down list.

Primary Support

Contact Select the support contact from the drop-down list.

3. To assign either primary legal or support contacts to the business location, or to add contacts to the host, click New Contact on the Contacts tab or click add icon in the Primary Legal Contact or Primary Support Contact fields and provide the following details:

Contact Type Select the type of the contact from the drop-down list: General, Support, Legal, or Business.

First Name Enter the first name.

Last Name Enter the last name.

Phone Enter the contact number.

FAX Enter the fax number.

(15)

4. Click Add.

Deleting Business Locations Procedure

● In the Business Locations tab, to delete the business locations, select the business location you wish to delete from the table and click delete icon.

Deleting Hosts

To delete one or more hosts:

You cannot delete a host if you have only one host participant. To delete a default host, you are first required to assign a different host participant as the default host by creating a new host participant.

Procedure

1. On Hosts page, select one or more hosts that you wish to delete and then click Delete icon.

(16)

Partners

Partners are the participants who are outside host's company and establish business agreement with the host. For example, partner can be a vendor, a customer, or a healthcare provider.

You can manage partners as follows:

● Searching for a Partner

● Creating a Partner

● Configuring a Partner

● Deleting Partners

On Partners page, you can enable or disable the switch under Status column to activate or deactivate a partner.

On the Partners page, you can directly navigate to the Edit Business Agreement window, by clicking the host in the Agreements column.

Searching for a Partner

In addition to entering the partner’s name or selecting it from the list, you can use the Search function to find a specific partner.

Procedure

● Enter the search string in the Search field to search a partner.

The names of one or more partners that correspond to the search criteria only are displayed.

Creating a Partner

To create a new partner, perform the following steps:

Procedure

1. On the Partner Management tile, click Partners.

2. On the Partners page, click Create Partner, which is in the upper-right corner of the page.

3. On the Create New Partner page, in the Partner Name field, enter the name of the partner you want to create and then click any one of the push buttons:

Done To create the partner.

Proceed To instantly configure the data of the new partner

For detailed information on configuring the partner data , see Configuring a Partner.

4. After you have provided all the required information, click Done.

The status of the newly created partner gets enabled by default.

(17)

You can either configure the data when creating the partner or later configure the data of the already created partner .

Procedure

1. On the Partner Management tile, click Partners.

2. On the Partners page, click the partner whose information you wish to edit.

The three tabs: Protocols, Credentials, and Business Locations are displayed.

3. To provide detailed information about the partner, provide information for the following tabs:

Protocols To enable or edit configurations of protocols, click Protocols tab. For detailed information on configuring the protocols, see Configure Protocols for Partners.

Credentials To add new credentials, click Credentials tab. For detailed information on uploading the credentials, see Manage Credentials for Partners.

Business

Locations To add information about the address and contact information for the company headquarters, click Business Locations tab. For more information, see Add Business Locations of Partners.

Configure Protocols for a Partner

You can enable or disable protocols for a partner, or edit their configurations using Protocols tab.

To configure the protocols of a partner, perform the following steps:

Procedure

1. On the Partners page, click the partner whose protocols you wish to configure.

2. On the Edit Partner page, select the business protocols that are available to use for the future communication with the selected partner.

3. To edit the configurations of protocols, click Edit Configurations tab.

For detailed information on editing the protocols, see the appropriate documentation for the specific protocol.

4. Click Done.

Adding Outbound Transports for Partners

To add and configure transports for a partner, perform the following steps:

Procedure

1. On Protocols tab, select a protocol and click Edit Configurations.

2. On protocol Configurations page, click Transports.

For detailed information on configuring outbound transports for partners, see the following:

Setting Up FILE for a Trading Partner Setting Up HTTP/S for a Trading Partner Setting Up FTP/S for a Trading Partner Setting Up SSHFTP for a Trading Partner Setting Up Email for a Trading Partner

(18)

Setting Up AS1 Email for a Trading Partner Setting Up AS2-HTTP/S for a Trading Partner

Manage Credentials for Partners

You can search, add, and delete credentials.

You can only add certificates in the partner's credentials tab.

Searching Credentials

In addition to creating a new credential or selecting it from the list of credentials, you can use the Search function to find a specific key.

To search for the credentials, perform the following steps:

Procedure

● Enter the search string in the Search field to search the credentials.

One or more credentials that correspond to the search criteria are only displayed.

Adding a Credential

To add credentials for a partner, perform the following steps:

Procedure

1. On the Edit Partner page, on the Credentials tab, click add icon of the following options to create the respective key:

New Certificate New certificate key for the partner

New PGP Public Key Public Key for encryption at the partner side

New SSH Public Key SSH keys are used to support the SSHFTP transport.

Based on which option you choose, the respective dialog box opens in which you can upload the key or the certificate.

2. In the dialog box, provide the following details:

New Certificate/New PGP Public Key/New SSH Public Key

Alias Enter the name of the key or certificate.

Upload file Click Add files or drop files to browse and navigate to the file containing the key

(19)

Deleting Credentials

To delete one or more credentials:

Procedure

1. In the Credentials tab, select the credential that you wish to delete and then click Delete icon.

Add Business Locations of Partners

A business location is the address and other identifying information of a partner. One partner often has multiple departments or other distinct groups at various locations. You can set up multiple locations for one partner to simplify shipping and billing procedures. It can also include contact information such as name, phone number, and email address of a person associated with a particular location. Each

business location can have multiple contacts.

The default Headquarters location is created when user enables RosettaNet protocol for a partner.

To add a business location for a partner, perform the following steps:

Procedure

1. On the Business Locations tab, click Add Location.

The Add Location dialog box is displayed.

2. In the Add Location dialog box, enter the following details:

Details

Location Name Enter the name of the location.

Email Enter the email ID.

Web URL Enter the web URL

Address Enter the address.

Primary Legal

Contact Select the legal contact information from the drop-down list.

Primary Support

Contact Select the support contact from the drop-down list.

3. To assign either primary legal or support contacts to the business location, or to add contacts to the partner, click New Contact on the Contacts tab or click add icon in the Primary Legal Contact or Primary Support Contact fields and provide the following details:

(20)

Contacts

Contact Type Select the type of the contact from the drop-down list: General, Support, Legal, or Business.

First Name Enter the first name.

Last Name Enter the last name.

Email Enter the email address.

Your contact is displayed in the Primary Legal Contact and Primary Support Contact drop-down lists.

4. Click Add.

Deleting Business Locations Procedure

● In the Business Locations tab, to delete the business locations, select the business location you wish to delete from the table and click delete icon.

Deleting Partners

To delete one or more partners:

Procedure

1. On Partners page, select one or more partners that you wish to delete and then click Delete icon.

(21)

Business Agreement Overview

A business agreement provides detailed information on which trading partners must agree before they can exchange business documents with each other

For each protocol enabled for document exchange between the two participants, the following protocol- specific information is required:

● Transport method

● Valid operations

● Security

Most of the information required to create a business agreement is protocol specific therefore, you need to fully configure both parties to the agreement.

The following tasks are required to create a valid business agreement:

● Identify the participants and define the agreement validity period

● Configure a protocol

● Configure an operation

You can manage the business agreements as follows:

● Searching for a Business Agreement

● Creating a Business Agreement

● Configuring a Business Agreement

● Deleting Business Agreements

On Business Agreements page, the protocols that are enabled for a business agreement are displayed in the In Use Protocol column. You can click the protocol link in this column in order to navigate directly to the respective protocol configuration page.

To activate or deactivate a business agreement on Business Agreements page, you can enable or disable the switch in the Current Status column in the table.

Searching for a Business Agreement

You can use the Search function to find a specific business agreement.

Procedure

● Enter the search string in the Search field to search a specific business agreement.

The names of one or more business agreements that correspond to the search criteria only are displayed.

Creating a Business Agreement

To create a new business agreement, perform the following steps:

Procedure

1. On the Partner Management tile, click Business Agreements.

2. On the Business Agreements page, click Create Agreement, which is in the upper-right corner of the page.

(22)

3. In the Create New Business Agreement dialog box, search and select the participants in the Host field and the Partner field between which you want to create an agreement.

4. After you have selected the host and the partner you want, click any one of the push buttons:

Done To create the business agreement between the selected host and partner.

Proceed To instantly configure the data of the newly created business agreement.

For detailed information on configuring the business agreement , see

5. After you have provided all the required information of the business agreement, click Done.

The status of the newly created business agreement is by default enabled .

Configuring a Business Agreement

The configuring of business agreement includes tasks such as defining the agreement period, adding protocol bindings to a business agreement, and editing the protocol configurations

To edit the business agreement data, perform the following steps:

You can either configure the data when creating the business agreement or later configure the data of the already created business agreement.

Procedure

2. On the Business Agreements page, select the business agreement whose information you wish to edit.

The two tabs: Bind Protocol and Validity are displayed.

3. To configure the business agreement, provide information for the following tabs:

Bind Protocol To add protocol bindings to a business agreement, click Bind Protocol tab.For detailed information on configuring the protocols, see Adding a Protocol Binding.

Validity To define the agreement period, click Validity tab. For detailed information, see Defining Business Agreement Validity.

Adding a Protocol Binding

Prerequisites

Both the host and the trading partner must have protocols enabled before you can add protocol bindings to a business agreement.

To add the protocol binding to the business agreement, perform the following steps:

Procedure

(23)

For detailed information regarding protocol configurations, see the other appropriate protocol specific documents.

3. Click Done.

Defining Business Agreement Validity

To define the validity of a business agreement, perform the following steps:

Procedure

1. On the Business Agreement page, click the agreement for which you wish to provide the validity details.

2. On the Validity tab, enter the start date and end date manually or click the calendar pickers to define the exact period during which the agreement is valid.

3. Enable the Active switch and then click Done.

Deleting Business Agreements

To delete one or more business agreements:

Procedure

1. On Business Agreements page, select one or more business agreements that you wish to delete and then click Delete icon.

(24)

Business Protocols

Business Protocols are the standard methods used to exchange business documents between the participants. The host and the partner have to agree upon a common protocol before exchanging business documents or any operation in the transaction. This simplifies business transactions between the trading partners. For example, RosettaNet, and EZComm are the business protocols with their own specifications on how trading partners should send and receive business documents and its format.

On the Business Protocols page, you can see the list of installed protocols with their respective plug-in names and version numbers.

You can search a business protocol with the help of Search function.

For more details on searching a business protocol, see Searching for a Business Protocol.

Searching for a Business Protocol

You can use the Search function to find a specific business protocol.

Procedure

● Enter the search string in the Search field to search business protocols.

The names of one or more business protocols that correspond to the search criteria only are displayed.

(25)

Operations Editor

The operations editor allows you to configure operations for specific protocols. An operation is the sending or receiving of a business document and the required processing of that document. It is also the set of information required to send or receive and process a business document.

Different protocols use different terminology to refer to operations. In the most simple case, an operation includes this information:

● Name of the operation

● Document (an XML file that clearly defines the electronic document that partners exchange as part of this operation)

● Root XML element name (the top-level XML element in the document) See the following table:

Protocol-Specific Terminology

Protocol Term for Operation

EZComm Operation

RosettaNet Activity

You can manage the operations as follows:

● Searching for an Operation

● Creating an Operation

● Importing Operations

● Deleting Operations

Searching for an Operation

You can use the Search function to find a specific operation.

Procedure

● Enter the search string in the Search field to search operations.

The names of one or more operations that correspond to the search criteria only are displayed.

Creating an Operation

To create an operation, perform the following steps:

Procedure

1. On B2B Administration tile, click Operations Editor.

2. On Operations Editor page, select one of the protocols from the list for which you wish to add operations.

3. On the protocol specific Operations Editor page, click add icon to add operation.

For detailed information about adding operations, see documentation provided for a specific protocol.

(26)

Importing Operations

You can import the operations using System Settings tile.

For detailed steps for import the operations, see General Tab on System Settings page.

Deleting Operations

To delete one or more operations perform the following steps:

Procedure

1. On Operation Editor page, select a protocol for which you wish to delete an operation. On the protocol page, select a operation and then click Delete icon.

(27)

Roles

Roles are created based on the user personas and is associated with the each user.

You can manage the roles as follows:

● Searching for a Role

● Creating a Role

● Editing Roles

● Deleting Roles

On Roles page, you can view the access rights set for a role by clicking Expand/Collapse Row icon in the Roles column .

Searching for a Role

In addition to entering the name of the roles or selecting it from the list, you can use the Search function to find a specific role.

Procedure

● Enter the search string in the Search field to search roles.

The names of one or more roles that correspond to the search criteria only are displayed.

Creating a Role

To create a new role, perform the following steps:

Procedure

1. On the User Management tile, click Roles.

2. On the User Roles page, click Create Role.

3. In the Create Role window, enter the name and description of the role you want to create and set its appropriate access rights. For more information on how to set the access rights, see Setting Access Rights for User Roles

Editing User Roles

To edit any of the listed administrative user roles, perform the following steps:

Procedure

2. On the User Roles page, click any role you wish to edit from the Roles column.

3. On the Edit Role tab, modify the name and description and expand the Access tab to add or modify the access rights for the selected user role .

For more information on how to set the access rights, see Setting Access Rights for User Roles

(28)

Setting Access Rights for User Roles

To set the access rights, log in as a user that has Admin access to the resources of TIBCO BusinessConnect Container Edition to which you wish to allow access for that user role.

You can enable these access rights for the user roles while creating new roles or while editing them.

To enable the access rights for the user roles, perform the following steps:

Procedure

2. On the User Roles page, click Create Role for creating a role or click any role from the list for editing them.

3. On the Create Role tab or Edit Role tab, enter the name and description of the role and expand the Access tab.

4. Select the appropriate check boxes for the different BusinessConnect Container Edition components to allow Read and Write privileges.

Deleting Roles

To delete one or more roles:

Procedure

1. On User Roles page, select one or more roles that you wish to delete and then click Delete icon.

(29)

Users

User Management allows you to create users, assign roles to the users and assign access rights to different roles. You can give users Read or Write access to the TIBCO BusinessConnect Container Edition components. After creating users, you obtain a list of users with different access rights You are required to update the email ID for the admin user which exists by default on the BusinessConnect Users page.

You can manage users as follows:

● Searching for a User

● Creating a User

● Editing Users

● Deleting Users

Searching for a User

In addition to entering the name of the users or selecting it from the list, you can use the Search function to find a specific user.

Procedure

● Enter the search string in the Search field to search a user

The names of one or more users that correspond to the search criteria only are displayed.

Creating a User

To create a new user, perform the following steps:

Procedure

1. On the User Management tile, click Users.

2. On the Business Connect Users page, click Create User.

3. In the Create New User window, enter the name, email ID, and password of the user.

4. Select any role from the list that you wish to assign to the user.

All the access rights that are set to the role get automatically applied to the user.

5. Click Save.

Editing Users

To edit any of the listed administrative users, perform the following steps:

Procedure

1. On the User Management tile, click Users.

2. On the Business Connect Users page, click any user you wish to edit from the User column.

3. On the Edit User tab, modify name, email ID, and password of the selected user.You can also modify the role assigned to that user.

(30)

Deleting Users

To delete one or more users:

You cannot delete the Admin User.

Procedure

1. On Business Connect Users page, select one or more users that you wish to delete and then click Delete icon.

(31)

Audit Trail

The TIBCO AuditSafe is used to store information about the messages and documents processed by TIBCO BusinessConnect^™ Container Edition

Procedure

1. To view the logs, on Data Viewer tile click Audit Trail

The protocols installed by you are displayed on the Audit Trail page.

2. Click the protocol you wish to see the transactions for.

For detailed information, see the protocol specific documentation.

(32)

System Settings

System Settings tile provides you access to modify and configure different parameters such as transport protocols, servers, certificates, and metadata.

You can configure the following parameters:

● General

● Certificates

● Metadata Type Configuration

● Transport Protocols

General

The General tab allows you to manage the installation properties and internal messaging (JMS) using private process, Intercomponent JMS, and Intercomponent DMZ-JMS (Optional).

You can manage the following:

Installation Properties Internal Messaging (JMS)

Installation Properties

You can modify the installation properties and import or export configuration data of TIBCO BusinessConnect Container Edition on the Installation Properties tab.

For detailed information of the fields, see the following table:

Installation Properties

Installation Name The name of the BusinessConnect Container

Edition installation. It names the installation automatically as BCCE-domain_name. You can change the name if you wish.

TIBCO BusinessConnect Container Edition uses the installation name within JMS subjects. If you rename the installation after deploying the

BusinessConnect Container Edition server, subject names will be out of sync. Therefore, if you modify the installation name, undeploy and then redeploy the server.

(33)

Installation Prefix The prefix BusinessConnect Container Edition appends to the subject of every message. The default value is ^AX.BCCE.

If you change the installation prefix after deploying the BusinessConnect server, subject names are out of sync.

Therefore, you modify the prefix, undeploy and then redeploy the server.

Description An optional text description of the

BusinessConnect Container Edition installation.

Import and Export Configuration Data

To import and export the configuration data, see fields in the following table:

Options Descriptions

Import configuration Imports configuration data from

BusinessConnect like .csx file and other configuration files.

To import configuration data perform the following steps:

1. In the Importing Configuration Data dialog box, click Upload file and navigate to your local directory to select the ^.csx file you wish to import and click Open.

2. Enter a password (if required) and click Start Importing.

Export BCCE configuration Exports configuration data from one

BusinessConnect Container Edition to the other.

1. Navigate to System Settings > General >

Installation Properties and then click Export BCCE configuration

2. A installation_name.bcce file is

downloaded, where installation_name is the Installation Name entered in the Installation Properties dialog box.

(34)

Options Descriptions

Export GS configuration Exports GS data from one BusinessConnect Container Edition to the other.

To export GS configuration, perform the following steps:

1. Navigate to System Settings > General >

Installation Properties and then click Export GS configuration

2. A GSToken.zip file is downloaded, which is required to be extracted, and files present in the folder are to be moved to the folder as mentioned in the README file for deployment.

Internal Messaging (JMS)

You can configure the JMS settings on TIBCO BusinessConnect Container Edition UI.

To configure Private Process JMS, Intercomponent JMS, and Intercomponent DMZ-JMS (Optional) settings, navigate to System Settings > Internal Messaging (JMS) and click any tab you wish to configure the settings.

For more information, see TIBCO BusinessConnect Container Edition, Administration guide.

Certificates

The Certificate Store page allows you to manage all credentials (certificates and private keys) in one location. These credentials are owned by the participants.

For information about certificates and security, see TIBCO BusinessConnect Container Edition Security Guidelines.

To learn how to work with the keys, you can use the samples provided with this program in the directory BCCE_HOME/samples/keys. Ensure that the chosen password is Password1.

Uploading Server Certificate

To upload the server certificates, perform the following steps:

Procedure

1. On System Settings tile, click Certificates > Certificates Store.

2. In the Certificate Store window, click add icon . The Upload Server Certificate dialog box is displayed.

3. In the Upload Server Certificate dialog box, enter the name of the certificate in the Alias field and click Upload file to to browse and navigate to the file containing the certificate.

4. Click Add.

(35)

Procedure

● Enter the name of the certificate you wish to search.

The names of one or more certificates that correspond to the search criteria only are displayed.

Deleting Server Certificates

To delete one or more certificates:

Procedure

1. On Server Certificates page, select one or more certificates that you wish to delete and then click Delete icon..

Metadata Type Configuration

The functionality in this secton is protocol-specific:

RosettaNet Roles: Supported by RosettaNet. Roles display in the Roles tab for a host and trading partner and the Activity tab in the operations editor. Roles are explained in TIBCO BusinessConnect Container Edition - RosettaNet Protocol User’s Guide.

Domains: Supported by TIBCO BusinessConnect Container Edition Services Plug-in, TIBCO BusinessConnect Container Edition - RosettaNet Protocol. Each trading partner involved in the exchange of documents has a domain. Look in the User’s Guides for each of these protocols for more information.

Partner Classification Codes: Supported by RosettaNet. Example: Buyer. Partner Classification Codes are explained in TIBCO BusinessConnect Container Edition - RosettaNet Protocol User’s Guide.

Supply Chain Codes: Supported by RosettaNet. Example: Electronic Components. Supply Chain Codes are explained in TIBCO BusinessConnect Container Edition - RosettaNet Protocol User’s Guide.

Adding and Removing Metadata

You use the TIBCO BusinessConnect Container Edition UI to maintain RosettaNet roles, domains, partner classification codes, and supply chain codes.

After changing any of these items in the configuration store, the new options become available in the TIBCO BusinessConnect Container Edition UI. You can then use the new values in setting up the host or a trading partner.

To manage RosettaNet roles, partner classification codes, supply chain codes, and domains to the configuration store, perform the following steps:

1. On System Settings tile, click Metadata Type Configuration.

2. To add new metadata, click add icon and perform the following tasks:

● For creating new Domains, Partner Classification Codes, Supply Chain Codes: Enter name and description in the respective dialog boxes.

● For creating RosettaNet Roles: Enter the name in the Create RosettaNet Role dialog box.

3. To delete any one of the data for RosettaNet roles, partner classification codes, supply chain codes, and domains, click the desired tab, select the data you wish to delete and click delete icon.

4. To search metadata value, enter the desired value in the Search field.

(36)

Transport Protocols

You can use Transport Protocols tab to configure the following types of protocols:

● Inbound Protocols

● Outbound Protocols

Inbound Protocol

The following inbound transport protocols are available for TIBCO BusinessConnect Container Edition:

● Email

● File

● FTP and FTPS

● SSHFTP

● HTTP, HTTPS, HTTPSCA

Each of the public transports can be enabled or disabled by selecting the appropriate check box associated with a specific transport.

Outbound Protocol

The following outbound transport protocols are available for TIBCO BusinessConnect Container Edition:

● FILE

● EMAIL

(37)

Email Transport

TIBCO BusinessConnect^™ Container Edition provides the ability to communicate with trading partners using email. The TIBCO BusinessConnect Email transport can be used to send or receive messages from email clients.

The TIBCO BusinessConnect Container Edition Email transport has the following features:

● It enables users of email clients to exchange documents securely by signing the message with their private key and encrypting the message with the public certificate of their trading partner.

● It conforms to the S/MIME standards.

● It also offers the ability to send your business document as an attachment to a plain text message for exchanging messages with email clients that require a non-attachment (inline) message body.

The following options are available for the TIBCO BusinessConnect Container Edition Email transport:

● Authentication Supported through digital signatures.

● Security Supported through message encryption.

● Non-repudiation Supported through digital signatures and email receipts.

● Compression Supported through the compression before signing.

Message Compression

For large messages, compression is highly recommended. Do not use compression on smaller

messages, since this might create a compressed message that is larger than the original. Compression is always performed before signing (if it is also applied). When outbound messages are compressed, files are in GZIP file format. For inbound messages which are compressed, files are decompressed

automatically.

Attachments

TIBCO BusinessConnect Container Edition Email transport supports the sending of documents as attachments. When the option Send Data as Attachment is selected, the outbound document will be sent in a multipart/mixed MIME message as follows:

● The first body part of the multipart message will contain a static string message, which can be ignored by the receiver of the message.

● The second body part of the multipart message will contain the outbound document. This second body part will have a MIME Content Disposition header with a type of “attachment.”

When using TIBCO BusinessConnect Container Edition Email transport, it is also possible to include other attachments with the outbound document whether the main document is sent as an attachment or not. These attachments are included as additional body parts to the outbound MIME message. The body parts of all attachments will contain a Content Disposition header with a type of “attachment”.

When an email message containing attachments is signed, the entire multipart/mixed MIME message is signed. Likewise, when an email message containing attachments is encrypted, the entire multipart/

mixed MIME message is encrypted.

Not all TIBCO BusinessConnect Container Edition protocols support sending attachments with the Email transport. Those protocols which have support for passing attachment information in their messages to/from the private process can be used to send attachment with the Email transport. See the User's Guide of your TIBCO BusinessConnect Container Edition protocol to verify whether it supports sending attachments with the Email transport.

Content Disposition Filename

Some TIBCO BusinessConnect Container Edition protocols provide the ability for the private process to specify a filename to be used as the value of the filename parameter in the Content Disposition MIME

(38)

header of outgoing MIME messages, including the messages sent using the TIBCO BusinessConnect Container Edition Email transport. The filename can be specified for the Content Disposition header associated with the main document and/or any attachments.

The TIBCO BusinessConnect Container Edition protocols that support specifying the filename value for the Content Disposition header will also pass the value of the filename parameter from the Content Disposition header of inbound email messages to the private process.

See the User’s Guide of the respective TIBCO BusinessConnect Container Edition protocol to verify whether it supports passing of the Content Disposition header filename to/from the private process.

Email Client Limitations The following limitations exist:

TIBCO BusinessConnect Container Edition does not support receipts from Microsoft Outlook email clients. This could happen when TIBCO BusinessConnect Container Edition sends an email message that contains a document requesting a Receipt from Outlook email clients.

● When sending a document from Outlook email clients to TIBCO BusinessConnect Container Edition, do not use any properties such as rich text, fancy colors, fonts supported by the respective clients.

● When sending a document from Outlook email clients as inline and not as attachment, you must always choose a proper Content-Transfer-Encoding. Examples: base64, quoted-printable. Do not send the document as 7-bit encoding, which is the default for most email clients. Plain text documents could be altered by some mail agents and must be avoided when sending to TIBCO BusinessConnect Container Edition.

Configuring Email transport involves configuration tasks in the trading host and trading partner.

Identifying the Sender and Receiver

TIBCO BusinessConnect Container Edition Email transport uses standard To and From email addresses as defined in SMTP standard (RFC 2821). These email addresses must be defined in the

Valid Email Address List field in the Partner Management>Partners>Partner Name>Protocol> Edit Configuration > General. When email is received from the mail server:

● The To address is matched against the email address entered in the host’s Valid Email Address List

● The From address is matched against the trading partner’s Valid Email Address List

Email Inbound POP3 Service Configurations

You can use this part of the section to create and configure mailboxes on your inbound mail POP3 servers.

If you want to configure Gmail as the inbound Mail POP3 server in System Settings, you must change Google account settings first. In the Gmail account at https://mail.google.com/settings/security/

lesssecureapps, you must turn on Allow less secure apps.

Creating Email Poller

To create a new email poller, perform the following steps:

1. On System Settings tile, click Transport protocols > Inbound Protocols.

(39)

On the Email Inbound POP3 Service Configurations page, you can enable or disable the switch in the Enable column to activate or deactivate an Email Poller.

Configuring the POP3 Server Polling Service

TIBCO BusinessConnect Container Edition allows you to configure unlimited POP3 Email servers, so that email messages from all these servers can be received. All POP3 servers are configured in the following way:

1. On the Admin UI, expand System Settings > Transport Protocols > Inbound Protocols

2. On the Email Inbound POP3 Service Configurations page, select the mail POP3 server you wish to configure. In the Edit Email Poller, configure the fields using the information displayed in the following table:

Edit Email Poller

Enabled Select the checkbox to enable the mail poller.

Mail POP3 Server Name of the POP3 server.

For example: pop.gmail.com:995

If the SSL check box is selected, the port number is required in this field.

User Name Name of the user for this mailbox.

The username should be unique.

Password Password of the user for this mailbox.

Polling Interval (seconds) Sets the polling interval to specify the frequency which the credential alerter keeps tracking and publishing alerts on expiring credentials. The default value is 180 seconds.

SSL Secure Sockets Layer (SSL) configuration. For

inbound messages, when this check box is selected, SSL/TLS protocols are used to ensure secure communication.

Trusted Certificates Uploads an X.509 certificate file encoded in Privacy-enhanced Electronic Mail (PEM) format.

This PEM encoded file contains the server X.509 certificate along with all the CAs in the

certificate path. Note: Only the PEM encoded X.509 files are supported. If the certificate expires, download the latest certificate.

(40)

Verify Host Name When selecting this check box, verification of the host is made, confirming the host you are connecting to is the expected host. The host name in the host's digital certificate is compared against the value you specified. If the host name does not match the expected host name, the connection is refused.

This is optional.

Strong Cipher Suites Only Only cipher suites with strong encryption can be used, if they are available on the host you are connecting to. This is optional.

Number of Dispatch Attempts Number of attempts to deliver inbound emails from the email event source component to the internal component.

The default value is 3.

Dispatch Interval (Time interval for next retry in

seconds) Intervals between delivery attempts for emails

sent from the email event source component to the internal component. The default value is 300 seconds.

Dispatch Timeout (seconds) Timeout on the email event source component waiting for an email delivery acknowledgement from the internal component.

The default value is 3600 seconds.

After you enter the required data, click Save and redeploy the Interior Server.

Email Outbound Proxy Server Configuration

Proxy servers allow you to connect to resources that otherwise are unavailable. They can also provide additional security and cache resources, allowing frequently accessed resources to be served more rapidly. to provide for different types of outbound transports protocols.

Only SMTP proxy server is supported for outbound EMAIL transport protocol.

In the Email Outbound Proxy Server Configuration window, you can create new SMTP proxy server or configure SMTP proxy server.

Adding New Proxy Server

To add an SMTP Proxy server, perform the following types:

1. Expand System Settings > Transport Protocols > Outbound Protocols.

(41)

In the expanded dialog box, fill required information as per the fields explained in the Edit Proxy Server table.

Configuring an SMTP Server

To configure the SMTP server, click SMTP on Email Outbound Proxy Server Configuration page and in the Edit Proxy Server dialog box, enter the following information:

Edit Proxy Server

SMTP Server Name An SMTP server name with port number.

For example: smtp.gmail.com:587.

If you select the SSL or TLS protocol with encrypted SMTP, the port number is normally 465. If you select the STARTTLS protocol with

encrypted SMTP, the port number is normally 587.

For the SMTPS transport, if port number is not given, the default port number 25 is used.

Proxy User Name Enter a valid user name for the proxy server, if applicable.

Proxy Password Enter the password associated with the user

name, if applicable.

Server Certificate Server certificate of this SMTPS used for the STARTTLS, SSL, and TLS protocols. Certificate Authorities can be added under System Settings

> Certificates > Certificate Store.

You have to add server certificates according to your own needs.

The sample certificates are in the

TIBCO_HOME/bcce/version/samples/keys/

email_ssl directory.

If the certificate expires, download the latest certificate. The sample certificate used to connect to the Gmail server might expire depending on the Gmail service.

Download a new Gmail server certificate if needed.

(42)

Secure Transport Mode The secure protocol employed in the transport layer. The STARTTLS, SSL, and TLS protocols are listed in the list.

SSL stands for secure sockets layer. TLS stands for transport layer security and is the successor of SSL v3. It is an open standard under RFC 2246. STARTTLS is a way to take an existing insecure connection and upgrade it to a secure connection using SSL/TLS.

Setting Up Email for a Host

You can set Email transport for a host by selecting transport protocols on the Business Agreement tab and setting email ID of the host for the specific protocol.

Setting up Email Transport for the Trading Host in the Business Agreements Procedure

2. In the Business Agreement window, click the business agreement for which you wish to set the Email transport.

3. In the Edit Business Agreement window, on the Bind Protocol tab, enable any protocol you wish to use and click Edit Configurations.

4. On the Transports tab, select email from the drop-down list of the Primary Transport field in the Outbound transport for Host section.

Only the transport protocols that are selected in System Settings > Transport Protocols >

Inbound Protocols are displayed in the Primary Transport field.

Setting the Host’s Email Address for a Protocol

Procedure

2. On Hosts page, click any one of the hosts whose email address you wish to set.

3. On Edit Host page, click protocol > Edit Configurations.

4. In the General tab of the protocol configuration page, enter host's email address in the Valid Email Address List field.

5. Click Save.

TIBCO BusinessConnect™

Edition

Trading Partner Management

Software Release 1.0

May 2020

Contents

TIBCO Documentation and Support Services

The Login Page

Dashboard

Hosts Overview

Searching for a Host

Creating a Host

Configuring a Host

Configure Protocols for Hosts

Manage Credentials for Hosts

Add Business Locations of Hosts

Deleting Hosts

Partners

Searching for a Partner

Creating a Partner

Configure Protocols for a Partner

Manage Credentials for Partners

Add Business Locations of Partners

Deleting Partners

Business Agreement Overview

Searching for a Business Agreement

Creating a Business Agreement

Configuring a Business Agreement

Adding a Protocol Binding

Defining Business Agreement Validity

Deleting Business Agreements

Business Protocols

Searching for a Business Protocol

Operations Editor

Searching for an Operation

Creating an Operation

Importing Operations

Deleting Operations

Roles

Searching for a Role

Creating a Role

Editing User Roles

Setting Access Rights for User Roles

Deleting Roles

Users

Searching for a User

Creating a User

Editing Users

Deleting Users

Audit Trail

System Settings

General

Installation Properties

Internal Messaging (JMS)

Certificates

Deleting Server Certificates

Metadata Type Configuration

Transport Protocols

Inbound Protocol

Outbound Protocol

Email Transport

Email Inbound POP3 Service Configurations

Email Outbound Proxy Server Configuration

Setting Up Email for a Host

Setting the Host’s Email Address for a Protocol

Setting Up Email for a Trading Partner