Tib Bc Tpadmin Guide

TIBCO BusinessConnect Trading Partner AdministrationSoftware Release 6.0November 2011

Important InformationSOME 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 OFLICENSAGREELICENSSOFTWLICENSIN THEAND COAGREE

This doctreaties.Softwar

TIBCO, BusinesTIBCO S

EJB, J2EMicrosy

All otherespecti

THIS SOOPERATIME. SOPERA

THIS DOIMPLIEFITNES

THIS DOCHANGINCORPIMPROVTHIS DO

THE COINDIREBUT NO

Copyrig

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

NDITIONS, AND YOUR USE HEREOF SHALL CONSTITUTE ACCEPTANCE OF AND AN MENT TO BE BOUND BY THE SAME.

ument contains confidential information that is subject to U.S. and international copyright laws and No part of this document may be reproduced in any form without the written authorization of TIBCO e Inc.

The Power of Now, TIBCO Hawk, TIBCO Rendezvous, TIBCO Runtime Agent, TIBCO ActiveMatrix sWorks, TIBCO Administrator, and TIBCO Designer are either registered trademarks or trademarks of oftware Inc. in the United States and/or other countries.

E, JMS and all Java-based trademarks and logos are trademarks or registered trademarks of Sun stems, Inc. in the U.S. and other countries.

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

FTWARE MAY BE AVAILABLE ON MULTIPLE OPERATING SYSTEMS. HOWEVER, NOT ALL TING SYSTEM PLATFORMS FOR A SPECIFIC SOFTWARE VERSION ARE RELEASED AT THE SAME EE THE README FILE FOR THE AVAILABILITY OF THIS SOFTWARE VERSION ON A SPECIFIC TING SYSTEM PLATFORM.

CUMENT IS PROVIDED AS IS WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR D, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY, S FOR A PARTICULAR PURPOSE, OR NON-INFRINGEMENT.

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

NTENTS OF THIS DOCUMENT MAY BE MODIFIED AND/OR QUALIFIED, DIRECTLY OR CTLY, BY OTHER DOCUMENTATION WHICH ACCOMPANIES THIS SOFTWARE, INCLUDING T LIMITED TO ANY RELEASE NOTES AND "READ ME" FILES..

ht 1999-2011 TIBCO Software Inc. ALL RIGHTS RESERVED.

oftware Inc. Confidential Information

Contents | iii

Contents

Conte

Tables

Figure

PrefacRelated

OtTypogrConnec

HoHoHo

ChaptParticip

HoMa

CreatinExImCoDeSe

EditingGeneraBusineCreden

PKPGMaMaEx

Protoco TIBCO BusinessConnect Trading Partner Administration

nts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . iii

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xi

s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xiii

e . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xv

Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xviher TIBCO Product Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xviaphical Conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xviiiting with TIBCO Resources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xxw to Join TIBCOmmunity . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xxw to Access All TIBCO Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xxw to Contact TIBCO Support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xx

er 1 Participants . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1ants Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2sts and Partners . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2naging Participants . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2g a New Participant . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3port Participant Data. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4port Participant Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4py a Participant . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4lete a Participant . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5arch for a Participant . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6 Participant Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7l Tab for Participants . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8

ss Locations Tab for Participants . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9tials Tab for Participants . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11I (Public Key Infrastructure) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11P (Pretty Good Privacy). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11naging Host Credentials . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11naging Partner Credentials . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16porting PGP Keys. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19ls Tab for Participants . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23

TIBCO B

iv | ContentsEnable a Protocol . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23Disable a Protocol . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23Configure a Protocol . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24Managing Transports for Participants . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24

Proxy Settings Tab for Partners . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26User A

AllAdAd

ChaptBusineIdentify

SeGenera

AdCo

User AAllAdAd

ChaptOperatImporti

ToTo

File Sp

ChaptGeneraCertific

CrNeSe

InbounInbounOutbou

AdSeusinessConnect Trading Partner Administration

ccess Tab for Participants . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28 Authorized Users . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28d Users with Access Rights . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29d Groups with Access Rights. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29

er 2 Business Agreements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31ss Agreements Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32ing the Participants for a New Business Agreement . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33lect Participants . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33l Tab for Business Agreements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34d a Protocol Binding . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34nfigure a Protocol . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35ccess Tab for Business Agreements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40 Authorized Users . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40d Internal Users . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41d Groups . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41

er 3 Operations Editor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43ions Editor Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44ng and Exporting Operations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45 Import an Operation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45 Export an Operation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46ecification Dialog . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47

er 4 System Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49l . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50ate Store . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51edentials Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51w Identities Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52rver Identities and Certificates Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56d Public Transport Types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57d Mail POP3 Servers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58nd HTTP/FTP Proxy and Mail SMTP Servers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59d a Proxy for a Host. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59lect the Default Proxy for a Host . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61

Contents | vAudit, Non-Repudiation and Runtime Database Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62User Authentication Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63

Add an Authentication Source . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63Activated Protocol Plug-ins and Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65Metada

AdPrivate

CrMa

CredenCo

User AGr

UtilitiesEx

ChaptOvervie

TIBUs

Using TSe

ManagAdEdAuEdReSe

ManagAd

ChaptOvervie

AuNoRe

PerformSePe

Viewing TIBCO BusinessConnect Trading Partner Administration

ta Type Configuration. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75d and Remove Metadata . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75 Process Smart Routing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76eate Business Rules for Private Process Smart Routing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76nage Business Rules for Private Process Smart Routing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79tial Expiry Alerter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80nfigure the Credential Alerter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80ccess Audit Trail . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81ouping Search Results . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84port Schemas . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84

er 5 User Access Management. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85w . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86CO Administrator User Categories . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86

er Management . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86IBCO Administrator User Management . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87t BusinessConnect Access Rights for a User. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88ing Users with TIBCO BusinessConnect User Management . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89d Users . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 90it Users . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93thenticate External Users . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99it LDAP Connection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 100move Users . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 101arch for Users. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 101ing Groups with TIBCO BusinessConnect User Management . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 102d a Group . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 102

er 6 Log Viewer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 109w . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 110dit Logs. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 110n-Repudiation Logs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 110send Logs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 110ing Log Searches . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111

t Preferences . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 112rform a Log Search . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 114 Search Results . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 117

TIBCO B

vi | ContentsSummary View. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 117Transaction Details View . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 117State Details View . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 117

Cancelling Transactions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 119Saving and Reusing Queries . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 120

SaRe

ResendReVie

ChaptOvervieGenera

InbOu

ChaptEmail OConfigu

CoCoCo

SettingSeSe

SettingCoSe

Configu

ChaptFTP Tr

FTFT

SettingEnSe

SettingCousinessConnect Trading Partner Administration

ve a Query . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 120use a Query. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 120ing Transactions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 121sendable Transactions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 121w Resend History . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 122

er 7 Reporting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 123w . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 124ting Reports. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 125ound Transaction Per Protocol . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 125tbound Transaction Per Protocol. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 126

er 8 Email Transport. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 127verview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 128ring POP3 and SMTP for Email . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 131nfigure the POP3 Server Polling Service . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 131nfigure an SMTP Server for a Host . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 131nfigure an SMTP Server for a Partner. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 131 Up Email for a Trading Host . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 132lect Email for the Trading Host . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 132t the Hosts Email Address for a Protocol . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 132 Up Email for a Trading Partner . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 133nfigure Email for a Trading Partner . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 133t the Partners Email Address for a Protocol . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 135re Email for a Business Agreement . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 136

er 9 FTP and FTPS Transports . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 137ansport Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 138P/S Inbound. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 140P/S Outbound . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 141 Up FTP/S for a Trading Host . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 142able FTP/S Inbound . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 142lect and Configure FTP/S Inbound . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 142 Up FTP/S for a Trading Partner . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 146nfigure FTP/S Outbound . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 146

Contents | viiSetting Up FTP Proxies . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 149

Chapter 10 SSHFTP Transport . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 151SSHFTP Transport Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 152Setting

EnSe

SettingCo

ChaptOvervieSetting

CoSetting

ChaptAS2 Tr

ASAS2 IdSetting

SeSetting

CoSynchr

ChaptAS1 Tr

ASConfigu

CoCoCo

SettingSeSe

SettingCoSe TIBCO BusinessConnect Trading Partner Administration

Up SSHFTP for a Trading Host . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 153able SSHFTP Inbound . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 153lect and Configure SSHFTP Inbound. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 153 Up SSHFTP for a Trading Partner. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 160nfigure SSHFTP Outbound . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 160

er 11 HTTP, HTTPS, and HTTPSCA Transports . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 163w . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 164

Up HTTP/S for a Trading Partner . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 165nfigure HTTP/S for a Trading Partner . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 165 Up HTTP Proxies. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 168

er 12 AS2 Transport . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 169ansport Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1702 Transport 6.0.0. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 170

entifiers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 174 Up AS2-HTTP/S for a Trading Host. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 175t the Hosts AS2 Identifier for a Protocol . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 175 Up AS2-HTTP/S for a Trading Partner . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 176nfigure AS2-HTTP/S for a Trading Partner . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 176onous and Asynchronous Receipts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 179

er 13 AS1 Transport . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 181ansport Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1821 Transport 5.2.2. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 182ring POP3 and SMTP Servers for AS1 Email . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 186nfigure the POP3 AS1 Email Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 186nfigure an SMTP Server for a Host . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 186nfigure an SMTP Server for a Partner . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 186 Up AS1 Email for a Trading Host. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 187lect AS1 Email for the Trading Host . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 187t the Hosts Email Address for a Protocol. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 187 Up AS1 Email for a Trading Partner . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 188nfigure AS1 Email for a Trading Partner . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 188t Up the Partners Email for a Protocol . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 190

TIBCO B

viii | ContentsConfigure AS1 Email for a Business Agreement . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 191

Chapter 14 File Transport . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 193File Transport Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 194Outbou

CoOu

InbounEnSe

ChaptInbox TOutbou

Co

ChaptOvervieConfiguMDN R

MD

AppenTrouble

AllFTEm

Trouble

AppenOvervie

FTDoFil

FTP InFTP an

SuFil

ManagReusinessConnect Trading Partner Administration

nd File Transport . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 195nfigure Outbound File Transport for a Partner . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 195tbound File Pollers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 196

d File Pollers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 197able and Configure Inbound File Poller . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 197lect File Inbound in the Business Agreement . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 197

er 15 Inbox Transport. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 199ransport Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 200nd Inbox Transport . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 201nfigure Outbound Inbox Transport for a Partner . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 201

er 16 Message Disposition Notification Receipts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 203w . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 204ring MDN Receipts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 205eceipts and Business Acknowledgments . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 206N Messages Sent to Private Processes. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 206

dix A Troubleshooting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 209shooting Transport Problems . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 210 Transports . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 210P Transport . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 210ail Transport . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 211shooting Database Problems . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 212

dix B Scripts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 213w . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 214P Scripts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 214cument Security through PGP. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 215e Scripts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 215bound . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 216d File Outbound. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 218pported FTP Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 219e Outbound . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 220ing Errors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 221trying Document Posting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 221

Contents | ixReturning Errors from Scripts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 221Audit Logging in Scripts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 222

Appendix C Remote Client Service Audit Log . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 223Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 224Busine

Index TIBCO BusinessConnect Trading Partner Administration

ssConnect Remote Audit Log Viewer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 225

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 227

TIBCO B

x | ContentsusinessConnect Trading Partner Administration

Tables | xi

Tables

Table 1

Table 1

Table 2

Table 3

Table 4

Table 5

Table 6

Table 7

Table 8

Table 9

Table 1

Table 1

Table 1

Table 1

Table 1

Table 1

Table 1

Table 1

Table 1

Table 1

Table 2

Table 2

Table 2

Table 2

Table 2

Table 2

Table 2

Table 2 TIBCO BusinessConnect Trading Partner Administration

General Typographical Conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xviiiBusiness Location, New Dialog . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9Business Location, New Contact . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10

Generate a New PGP Key Pair . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13

Upload a Private PGP Key from a File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14Import a PGP Key Pair from the ASCII Armor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14

Upload from File. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17

Import from ASCII Armor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17Select Proxy Settings for the Partner . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26Edit Protocol Bindings: Operation Binding Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35

0 Edit Protocol Bindings: Document Security Tab. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 361 Edit Protocol Bindings: Transports Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 382 Protocol-Specific Terminology . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 443 Server Settings Fields . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 504 CSR Wizard, Step 1 General Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52

5 Inbound Mail POP3 Servers. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58

6 New Proxy Connection. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 607 Activated Protocol Plug-ins and Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 658 TIBCO BusinessConnect Server Properties Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66

9 Add New Property . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74

0 New Rule for the Private Process Smart Routing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 761 Credential Alerter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80

2 User Audit Trail . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81

3 Edit External User . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92

4 Configure the Authentication Source for the External User . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 995 Edit LDAP Connection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1006 Log Viewer Preferences: All Protocols . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1127 Log Viewer Preferences: Selected Protocol TIBCO BusinessConnect Services Plug-in. . . . . . . 113

TIBCO B

xii | TablesTable 28 Configure Log Search . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 115Table 29 Data Reports . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 125

Table 30 Email Transport Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 133Table 31 Supported File Mask Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 139

Table 3

Table 3

Table 3

Table 3

Table 3

Table 3

Table 3

Table 3

Table 4

Table 4

Table 4usinessConnect Trading Partner Administration

2 Inbound FTP/S Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1433 Outbound FTP/S Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1474 Inbound SSH Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1545 Outbound SSHFTP Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1606 Configuring HTTP/S for a Trading Partner: General Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1667 Configuring HTTP/S for a Trading Partner: Transports Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1668 New Transport Dialog for AS2-HTTP/S. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1769 AS2-HTTP/S Transport . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 177

0 AS1_Email Transport Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1881 Outbound File Transport . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1952 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 201

Figures | xiii

Figures

FigureFigureFigureFigureFigureFigureFigureFigureFigureFigureFigureFigureFigureFigureFigureFigureFigureFigureFigureFigureFigureFigureFigureFigureFigureFigureFigureFigure TIBCO BusinessConnect Trading Partner Administration

1 Edit a Participant . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7

2 Edit Host Participant: Credentials Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 153 Edit Partner Participant, Credentials Tab. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18

4 All Authorized Users. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28

5 Edit Business Agreement: User Access Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 406 All Authorized Users. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40

7 Imported Operations Listed. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45

8 CSR Wizard Step 3, Generated CSR. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 539 CSR Wizard Step 4, CA Response . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54

10 CSR Wizard Step 5, Complete Certificate Chain . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55

11 CSR Wizard Step 6, Success . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5512 Imported Server Certificate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56

13 Outbound HTTP/FTP Proxy Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5914 Select Outbound Proxy Settings for a Host . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6115 Result of the Audit Trail Search . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82

16 Audit Trail Details . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82

17 List of Users Created by TIBCO Administrator User Management . . . . . . . . . . . . . . . . . . . . . . . . . 8718 Allow Permissions for BusinessConnect Components . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88

19 Three Types of Users. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 90

20 Edit Administrative Users: General Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9321 Edit Non-Administrative Users: General Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 94

22 Group Membership Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 94

23 Add Groups . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9524 Edit User Permissions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96

25 Add Participants . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96

26 Participant Permissions for Users . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97

27 Business Agreement Permissions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9828 Business Agreements Permissions for Users . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98

TIBCO B

xiv | FiguresFigure 29 Set Group Name . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 102Figure 30 New Group Dialog . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 102Figure 31 Members Tab for Groups . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103Figure 32 Add Users to Groups. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103FigureFigureFigureFigureFigureFigureFigureFigureFigureFigureFigureFigureFigureFigureFigureFigureFigureusinessConnect Trading Partner Administration

33 Participants Permissions for Groups . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10434 Add Participants . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 104

35 Participant Permissions for Groups . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 105

36 Business Agreements Permissions for Groups. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10637 Add BusinessAgreements for Groups . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10638 Business Agreements Permissions for Groups. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10739 Log Viewer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11140 Log Viewer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11441 State Details View . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 117

42 Resend History Details . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 122

43 No Key Configured . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15744 The Configured Key is Different . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15845 The Configured and Retrieved Keys Match. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15846 Server is Not Available . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 158

47 Server Did Not Respond to the SSH Query as Expected . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15948 The Configured Server Hostname is not Valid . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15949 BusinessConnect Remote Audit Log Entries. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 225

| xv

Preface

Topic TIBCO BusinessConnect Trading Partner Administration

TIBCO BusinessConnect software is a B2B (business-to-business) gateway that allows your company to engage in electronic commerce with your business partners.

s

Related Documentation, page xvi

Typographical Conventions, page xviii

Connecting with TIBCO Resources, page xx

TIBCO B

xvi | Related Documentation

Related Documentation

The following documents form the BusinessConnect documentation set:

OtheusinessConnect Trading Partner Administration

TIBCO BusinessConnect Installation and Configuration. Read this guide to learn how to install and configure TIBCO BusinessConnect.

TIBCO BusinessConnect Concepts: Read this guide to learn about TIBCO BusinessConnect architecture, deployment modes, protocols, and security.

TIBCO BusinessConnect Interior Server Administration: Read this guide in order to administer, operate, and manage TIBCO BusinessConnect Interior Server.

TIBCO BusinessConnect Gateway Server Administration: Read this guide in order to administer, operate, and manage TIBCO BusinessConnect Gateway Server.

TIBCO BusinessConnect Trading Partner Administration: Read this guide to configure and manage trading partners.

TIBCO BusinessConnect Scripting Deployment Users Guide: Read this guide to configure and manage TIBCO BusinessConnect using the command line interface.

TIBCO BusinessConnect Release Notes: Read this document to learn about new features, changes in functionality, deprecated features, known issues, and closed issues for each release. This document is supplied for each release and is available only in PDF format.

r TIBCO Product DocumentationYou may find it useful to read the documentation for the following TIBCO products, which may be used or integrated with BusinessConnect:

TIBCO Administrator software: The software allows you to manage users, machines and applications defined in a TIBCO Administration Domain. The TIBCO Administrator graphical user interface enables users to deploy, monitor, and start and stop TIBCO applications.

TIBCO ActiveMatrix BusinessWorks software: This software is a scalable, extensible, and easy to use integration platform that allows you to develop integration projects. TIBCO BusinessWorks includes a graphical user interface (GUI) for defining business processes and an engine that executes the process.

TIBCO Designer software: This graphical user interface is used for designing and creating integration project configurations and building an

Preface | xviiEnterprise Archive (EAR) for the project. The EAR can then be used by TIBCO Administrator for deploying and running the application.

TIBCO Runtime Agent software: This software suite is a prerequisite for other TIBCO software products. In addition to TIBCO Runtime Agent components, the software suite includes the third-party libraries used by TIBCO BusinessConnect Trading Partner Administration

other TIBCO products such as TIBCO Designer, Java Runtime Environment (JRE), TIBCO Hawk, and TIBCO Rendezvous.

TIBCO Rendezvous: This software enables programs running on many different kinds of computers on a network to communicate seamlessly. It includes two main components: the Rendezvous programming language interface (API) in several languages, and the Rendezvous daemon.

TIBCO Enterprise Message Service software: This software provides a message service that enables integration of applications within an enterprise based on the Java Message Service (JMS) specifications.

TIBCO B

xviii | Typographical Conventions

Typographical Conventions

The following typographical conventions are used in this manual.

Table 1

ConvTIBCO

ENV_

BC_H

code

bold

fontusinessConnect Trading Partner Administration

General Typographical Conventions

ention Use_HOME

HOME

OME

Many TIBCO products must be installed within the same home directory. This directory is referenced in documentation as TIBCO_HOME. The default value of TIBCO_HOME depends on the operating system. For example, on Windows systems, the default value is C:\tibco.

Other TIBCO products are installed into an installation environment. Incompatible products and multiple instances of the same product are installed into different installation environments. An environment home directory is referenced in documentation as ENV_HOME. The default value of ENV_HOME depends on the operating system. For example, on Windows systems the default value is C:\tibco.

TIBCO BusinessConnect installs into a directory within TIBCO_HOME OR ENV_HOME. This directory is referenced in documentation as BC_HOME. The default value of BC_HOME depends on the operating system. For example on Windows systems, the default value is C:\tibco\bc\version.

font Code font identifies commands, code examples, filenames, pathnames, and output displayed in a command window. For example:

Use MyCommand to start the foo process.

code

Bold code font is used in the following ways:

In procedures, to indicate what a user types. For example: Type admin.

In large code samples, to indicate the parts of the sample that are of particular interest.

In command syntax, to indicate the default parameter for a command. For example, if no parameter is specified, MyCommand is enabled: MyCommand [enable | disable]

Preface | xix

italic font Italic font is used in the following ways:

To indicate a document title. For example: See TIBCO BusinessConnect

Key comb

Table 1 General Typographical Conventions (Contd)

Convention Use TIBCO BusinessConnect Trading Partner Administration

Concepts.

To introduce new terms. For example: A portal page may contain several portlets. Portlets are mini-applications that run in a portal.

To indicate a variable in a command or code syntax that you must replace. For example: MyCommand PathName

inationsKey names separated by a plus sign indicate keys pressed simultaneously. For example: Ctrl+C.

Key names separated by a comma and space indicate keys pressed one after the other. For example: Esc, Ctrl+Q.

The note icon indicates information that is of special interest or importance, for example, an additional action required only in certain circumstances.

The tip icon indicates an idea that could be useful, for example, a way to apply the information provided in the current section to achieve a specific result.

The warning icon indicates the potential for a damaging situation, for example, data loss or corruption if certain steps are taken or not taken.

TIBCO B

xx | Connecting with TIBCO Resources

Connecting with TIBCO Resources

How to Join TIBCOmmunity

How

How usinessConnect Trading Partner Administration

TIBCOmmunity is an online destination for TIBCO customers, partners, and resident experts; a place to share and access the collective experience of the TIBCO community. TIBCOmmunity offers forums, blogs, and access to a variety of resources. To register, go to http://www.tibcommunity.com.

to Access All TIBCO DocumentationAfter you join TIBCOmmunity, you can access the documentation for all supported product versions here:

http://docs.tibco.com/TibcoDoc

to Contact TIBCO SupportFor comments or problems with this manual or the software it addresses, please contact TIBCO Support as follows:

For an overview of TIBCO Support, and information about getting started with TIBCO Support, visit this site:

http://www.tibco.com/services/support

If you already have a valid maintenance or support contract, visit this site:

https://support.tibco.com

Entry to this site requires a username and password. If you do not have a username, you can request one.

| 1

Chapter 1 Participants

Topic TIBCO BusinessConnect Trading Partner Administration

This chapter provides both conceptual and procedural information to help you configure participants for TIBCO BusinessConnect hosts and trading partners.

For general information about this product and its architecture, components, and various usage and deployment scenarios, see TIBCO BusinessConnect Concepts.

To install and configure the TIBCO BusinessConnect server, see TIBCO BusinessConnect Installation and Configuration Guide.

s

Participants Overview, page 2

Managing Participants, page 2

Editing Participant Data, page 7

General Tab for Participants, page 8

Business Locations Tab for Participants, page 9

Credentials Tab for Participants, page 11

Protocols Tab for Participants, page 23

Proxy Settings Tab for Partners, page 26

User Access Tab for Participants, page 28

TIBCO B

2 | Chapter 1 Participants

Participants Overview

Participants store a variety of information about trading partners, from the very general (for example the location of the company headquarters) to the detailed

Hosts

ManausinessConnect Trading Partner Administration

(for example, security credentials and available protocols).

and PartnersTIBCO BusinessConnect defines two types of participants that can exchange electronic documents:

Hosts A host is a participant in a business agreement and an organizational entity within your company. Hosts participate in the electronic documents exchange using the BusinessConnect B2B gateway. There may be one host or multiple hosts whose private keys are stored by TIBCO BusinessConnect.

Partners A partner participant is outside of your company and typically has its own B2B gateway, either TIBCO BusinessConnect or some other solution. Your TIBCO BusinessConnect installation stores public keys for your partners.

There is little difference between hosts and partners because much of the same information is required to configure both types of participants. An agreement has to be established between a host and a partner.

ging ParticipantsYou can manage participants as follows:

Create a new participant Create a new participant as explained in Creating a New Participant, page 3.

Export or import a participant Export an existing participants data for use in another TIBCO BusinessConnect installation and/or import a participant from another TIBCO BusinessConnect installation, as explained in Export Participant Data, page 4.

Copy an existing participant Copy the participants data. See Copy a Participant, page 4 for more information.

Delete a participant Remove the participant from your system. See Delete a Participant, page 5 for more information.

Edit participants data Once the participants are created, their data can be changed. See Editing Participant Data, page 7.

Search for a participant Use the Search function to search for participant. See Search for a Participant, page 6 for more information.

Creating a New Participant | 3

Creating a New Participant

Before you start creating any participants, you must have at least one protocol installed. TIBCO BusinessConnect Trading Partner Administration

To create a new participant:

1. Click BusinessConnect>Participants.

2. Click the New button.

3. Type the name in the Participant Name field

4. Select Host or Partner from the dropdown list.

Select Host if this participant is internal to your enterprise; select Partner if this participant is external to your enterprise.

5. Click OK.

A new dialog appears allowing you to provide detailed information about the participant.

6. Select the Active checkbox if you want to activate this participant right away. Otherwise, you can activate this participant later.

7. Provide as much information as you require about the address and contact information for the company headquarters.

Default 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 in System Settings > General Settings. You cannot delete the default host; therefore, if you have only one host participant, you cannot delete it. To delete a default host, first assign a different host participant as the default host, creating a new host participant if necessary.

If the participant is activated, all grammar rules associated with this participant are validated. No validation is performed for an inactive participant. This allows the user to provide only a partial information while the participant is still inactive, and then add the remaining required information when activating the participant.

To select legal and support contacts, you must first add these contacts to the system. Add contacts to a business location. See Business Locations Tab for Participants, page 9 for more information.

TIBCO B

4 | Chapter 1 ParticipantsExport Participant Data

To export participant data from one TIBCO BusinessConnect installation to another, perform these steps:

1. Select BusinessConnect>Participants.

Impo

CopyusinessConnect Trading Partner Administration

2. Select the checkbox next to the participant(s) that you want to export.

3. Click the Export button.

4. In the Export Participants dialog, set the password if needed.

5. Click Export Configuration Data.

This creates the .csx file with the compressed data of the exported participant.

6. Save the file to the desired location.

Import this .csx file into another TIBCO BusinessConnect installation.

7. Click Done.

rt Participant Data

To import participant data, perform these steps:


2. Click Import and then click the link change to identify the .csx file that contains the participants for import.

3. Click Browse, then navigate to and select the .csx file that was created during the export of participant data.

4. Enter the password, if it was used to secure the data during the export.

5. Click Import Participants.

6. Click Done.

a ParticipantTo copy a participant, perform these steps:


2. Select the checkbox next to the participant you wish to copy.

3. Click Copy.

Before importing participant data into a TIBCO BusinessConnect installation, first install and activate all protocols associated with the participants and import all operations associated with the participants.

Creating a New Participant | 54. In the next dialog, enter the name for the new participant.

If you open the new participant, you will see that most of its general, business, credentials, protocols, and proxy data has been transferred from the participant it was copied from.

Delet

Delete

Delete TIBCO BusinessConnect Trading Partner Administration

e a Participant

a Host

1. Select BusinessConnect>System Settings>General Settings.

2. Make sure that the host selected in the dropdown list Default Host is not the one you wish to delete.

3. Click Save.


5. Select the checkbox next to the host you wish to delete.

6. Click Delete.

a Partner

To delete a partner, perform these steps:


When you create a new participant using the Copy function, any unique constraints such as domain IDs, AS transport IDs, and name of the trading partner will not be copied. This data must be later entered for the new trading partner using the steps as explained in Editing Participant Data, page 7.

Default 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 in System Settings > General Settings.

You cannot delete the default host; therefore, if you have only one host participant, you cannot delete it unless you add a replacement host.

You must first add at least one new host (following the steps described in Creating a New Participant, page 3 and then remove the host you dont need any more..

You cannot select None as the default host. Select an actual host for the default.

TIBCO B

6 | Chapter 1 Participants2. Select the checkbox next to the participant you wish to delete.

3. Click Delete.

Search for a ParticipantusinessConnect Trading Partner Administration

In addition to entering the participants name or selecting it from the list, you can use the Search function to find a specific participant. This allows you to use a wildcard and search for a participants name when you dont know the exact (full) name.

1. Enter the search string by using the wild card to substitute any characters before, after, or before and after the string you are entering.

2. Click Search.

3. The participant name(s) that correspond to the search criteria will be displayed in the Name list, while the others will be removed

4. To view all participants, click on the Show All link.

Editing Participant Data | 7

Editing Participant Data

To edit participants data, click on the participant whose information you wish to edit. The Edit Participant dialog appears. TIBCO BusinessConnect Trading Partner Administration

Figure 1 Edit a Participant

There are five tabs available for managing participants:

General Tab for Participants, page 8

Business Locations Tab for Participants, page 9

Credentials Tab for Participants, page 11

Protocols Tab for Participants, page 23

Proxy Settings Tab for Partners, page 26 (only for partner participants)

User Access Tab for Participants, page 28

TIBCO B


General Tab for Participants

The General tab allows you to add or change the participants data such as address and email. usinessConnect Trading Partner Administration

Most of these fields are optional, except for the following:

Participant Name

Active checkbox (select to activate the participant)

For the following fields, you need to pay attention while entering data:

Primary Legal Contact and

Primary Support Contact These contacts can also be entered using the Business Location tab.

Once you enter all contacts using the Business Location tab, you will come back to the General tab and select the appropriate contacts from the dropdown lists that will have the contact entries.

Business Locations Tab for Participants | 9

Business Locations Tab for Participants

A business location is simply the address and other identifying information for a participant. One participant often has multiple departments or other distinct

Table 1

FieldNam

AddrAddrAddr

City/Code

Coun

PhonEmai

PrimCont

PrimCont TIBCO BusinessConnect Trading Partner Administration

groups at various locations. You can set up multiple locations for one participant to simplify shipping and billing procedures.

A business location can include contacts. A contact is the name, phone number, and email address of a person associated with a particular location of a participant. Each business location can have multiple contacts.

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

1. Select BusinessConnect>Participants and then click on the name of the participant you are editing

2. Select the Business Locations tab.

3. Click New.

The New dialog appears.

Provide values for each of the appropriate text fields as explained in Table 1.

Business Location, New Dialog

Enter

e (required) Only the Name field is required as it identifies the participant.

You cannot leave unnamed in this field.

ess 1st Lineess 2nd Line ess 3rd Line

Enter the participants address.

State/Zip Enter the participants data.

try Enter country name.

e/Fax/l/Web URL

Enter the participants data.

ary Legal act

Select from the dropdown list.

ary Support act

Select from the dropdown list.

TIBCO B

10 | Chapter 1 Participants4. To assign primary legal and/or support contacts to this business location, or if

you want to add contacts to this participant, create these contacts as follows:

a. Click New.

The New Contact screen appears:

Table 2

FieldFirst

Cont

EmaiusinessConnect Trading Partner Administration

b. Once you finish entering data and click Save, your contact will appear in the section Contacts.

c. To delete this contact at any time, select the checkbox next to the contacts name and click on Delete.

5. Click Save.

Business Location, New Contact

Enter

Name, Last Name Enter the participants data.

act Type Select a contact type from the dropdown list. Only contacts designated as type Legal or Support will be available from the Primary Legal Contact and Primary Support Contact dropdown lists in the business location.

l, Phone, Fax, Pager Enter the participants data.

Credentials Tab for Participants | 11

Credentials Tab for Participants

TIBCO BusinessConnect uses two methods of public key cryptography:

PKI (

PGP

Mana

New P TIBCO BusinessConnect Trading Partner Administration

Public Key Infrastructure)This method uses a hierarchical key management system that includes a certification authority (CA). The CA issues digital certificates by binding the identity of a user or a system to a public key with a digital signature. The host can use the trading partners public key to authenticate a sender, enable non-repudiation, encrypt a transport, or encrypt a message.

(Pretty Good Privacy) PGP does not use Certificate Authorities and instead each public key is bound to a user name and/or an e-mail address. A "web of trust" is used to establish the authenticity of the binding between a public key and its owner. In TIBCO BusinessConnect, PGP keys are used for message signatures and encryption on the FTP transport..

ging Host CredentialsThere are several credentials available for a host that can be uploaded using the Credentials tab:

New Private Key, page 11

New SSH Private Key, page 12

Generating New PGP Key Pairs, page 12

Assign a Shadow Key for the Host, page 15

Exporting PGP Keys, page 19

rivate KeyTo upload a private key for the host, perform these steps:

1. Select BusinessConnect>Participants> host> Credentials tab.

2. Click New Private Key.

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

TIBCO B

12 | Chapter 1 Participants3. Type the name of the key in the Alias field.

4. In the Current Credential line click change.

Browse and navigate to the file containing the private key and click OK.

5. Click set next to Password.

New S

GenerusinessConnect Trading Partner Administration

Type the password (required for private keys) in the Enter Password and Enter Password Again fields.

If you are using any of the sample keys provided in the directory BC_HOME\samples\keys, the password is "Password1".

6. Click OK and Save.

The new private key for the host is now listed in the Credential Name list.

SH Private KeySSH keys are used to support the SSHFTP transport in TIBCO BusinessConnect.

To upload a SSH private key, perform these steps:


2. Click New SSH Private Key.

Type the name of the key in the Alias field.


Browse and navigate to the file containing the SSH private key and click OK.

4. Click set next to Password.

Type the password (required for private keys) in the Enter Password and Enter Password Again fields.

5. Click OK and Save.

The new SSH key for the host is now listed in the Credential Name list.

ating New PGP Key PairsTIBCO BusinessConnect can create new PGP key pairs for users and store them in the certificate store. These key pairs contain a private and a public key and can have a key size of 1024 or 2048 bytes. The key types are DSA and ElGamal or RSA and allows both for encryption and signing. These key pairs also contain the name of the private key owner, as well as an email address of that owner.

The new PGP key are automatically imported into the BusinessConnect configuration store and associated with the host.


Credentials Tab for Participants | 132. Click New PGP Private Key.

3. Select the mode by which the new key will be generated and click OK:

Generating a New Key Pair, page 13

Uploading from a File, page 14

Table 3

Alias

Passw

Expir

Key S

Key T

Real

Emai TIBCO BusinessConnect Trading Partner Administration

Importing from ASCII Armor, page 14

Generating a New Key PairThis option generates both a private and a public key. When a key pair generated this way is exported either in form of binary files or in the ASCII Armor format, both keys will be exported at the same time.

Generate a New PGP Key Pair

Name for the new PGP key pair

ord Password associated with the private key

y Date A date by which the key pair will be valid

ize Size of the new key in bytes: 1024 or 2048

ype For the new PGP key pairs there are two selections available:

DSA and ElGamal Both created keys, private and public, support signing using the DSA algorithm and encryption using the ElGamal algorithm.

RSA Key Pair Both created keys, private and public, support signing and encryption using the RSA algorithm.

Name A user supplied name to be used in conjunction with the email address in constructing the PGP User ID of the key pair.

l Address Email address to be associated with the generated key pair.

TIBCO B

14 | Chapter 1 ParticipantsUploading from a FileWhen exporting an uploaded private key for the host, it will only have the option of exporting this private key, without the public part.

Table 4 Upload a Private PGP Key from a File

FieldAlias

Curre

Passw

Table 5

FieldAlias

Passw

ASCIForm(PrivusinessConnect Trading Partner Administration

Importing from ASCII ArmorUsers can import a PGP key pair for the host partner in two ways:

Import a set of files, with one file for each key part. Content of the file for a key part can be in binary or in ASCII armor format

Import by pasting the ASCII armor private and public key parts into a screen Uploading from a file supports only the private PGP key for the host.

Importing from the ASCII armor allows you to import both the private and public PGP key. In the Import from ASCII Armor window, enter data as explained in Table 5.

DescriptionName of the uploaded key

nt Credential Browse to the location where a PGP private key that you want to use is located and upload a PGP private key.

ord Supply a password that corresponds to the key.

Import a PGP Key Pair from the ASCII Armor

DescriptionName of the imported key pair.

ord Supply a password that corresponds to the private PGP key.

I atted Text ate)

Paste the text in ASCII armor format, where the private key is base64 encoded and wrapped with a PGP specific header and footer such as:

-----BEGIN PGP PRIVATE KEY BLOCK-----Version: BCPG v1.46

lQO0BE2cttgDCACO4PRiKPLFNheitPoyNvnuNTghwjNNmSB7BMprzQ3vMeV1XMUgaAW7/qH3YxT3UbHdXkyP9oH/A47pFNoMCvsIgae9mqZoKKWoKCWHRpishTtv5rXV0hRVJ7VW6Eu3h8dKH/TCC8yzvPrKbLTh2vzm+Y2q1oo5CBZazw===2IyA-----END PGP PRIVATE KEY BLOCK-----

Credentials Tab for Participants | 15

Assig

ASCII Formatted Text (Publ

Paste the text in ASCII armor format, where the public key is base64 encoded and wrapped with a PGP specific header and footer such as:

Table 5 Import a PGP Key Pair from the ASCII Armor

Field Description TIBCO BusinessConnect Trading Partner Administration

Click Save.

All PGP keys, generated or uploaded/imported, will be available in the Edit Host Participant window.

n a Shadow Key for the Host

To assign a shadow key, follow these steps:


Figure 2 Edit Host Participant: Credentials Tab

ic) -----BEGIN PGP PUBLIC KEY BLOCK-----Version: BCPG v1.46

mQENBE2cttgDCACO4PRiKPLFNheitPoyNvnuNTghwjNNmSB7BMprzQ3vMeV1XMUgaAW7/qH3YxT3UbHdXkyP9oH/A47pFNoMCvsIgae9mqZoKKWoKCWHRpishTtv5rXVP2O/KhUqjgBCd3HZ1qjnDJEVHwOm37H6Iqyd66tRTsW57Wztxy9hRdftM77aaKJl...AwKMfdaQnd1ntV6BXFM6GXdl5HJhjjY/HVJtRb498Rjba9IUVSe1VuhLt4fHSh/0wgvMs7z6ymy04dr85vmNqtaKOQgWWs8==Fd6T-----END PGP PUBLIC KEY BLOCK-----

Shadow PGP keys are currently not supported.

TIBCO B

16 | Chapter 1 Participants2. Click on the private key that will expire first, such as hostsKey.

The Edit Private Key dialog appears.

3. In the Shadow Settings area, select the Activation date for shadow key using the three dropdown menus. This date has to be chosen before the first key is

Mana

New C

New SusinessConnect Trading Partner Administration

about to expire. From the Shadow Key dropdown list, select the key you would like to use as replacement, such as hostsPrivateKey.

4. Click Save.

After the shadow key takes effect, it is still a shadow key. You need to remove or update the original credential and remove or promote the shadow key.

ging Partner CredentialsThere are several credentials available for a partners that can be uploaded using the Credentials tab:

New Certificate, page 16

New SSH Public Key, page 16

New PGP Public Key, page 17

Assign a Shadow Certificate for the Partner, page 18

Exporting PGP Keys, page 19

ertificate To upload a new certificate key for the partner, perform these steps:

1. Select BusinessConnect>Participants> partner> Credentials tab.

2. Click New Certificate.



Browse and navigate to the file containing the private key and click OK.

4. Click Save.

The new certificate for the partner is now listed in the Credential Name list.

SH Public KeySSH keys are used to support the SSHFTP transport in TIBCO BusinessConnect.

To upload a SSH public key, perform these steps:


Credentials Tab for Participants | 172. Click New SSH Public Key.



Browse and navigate to the file containing the SSH private key and click OK.

New P

Table 6

Alias

CurreCred

Table 7

Alias TIBCO BusinessConnect Trading Partner Administration

4. Click Save.

The new SSH key for the partner is now listed in the Credential Name list.

GP Public KeyWhen a user creates a PGP key pair for a host, it is automatically imported into the BusinessConnect configuration store as a Server PGP key pair and is associated with the host. For the partner, users can only upload or import the public portion of a PGP key pair, which is normally received from the trading partner.


6. Click New PGP Public Key.

The New PGP Public Key dialog opens.

7. Select the mode by which the key will be uploaded or imported and click OK.

Upload from File, page 17

Import from ASCII Armor, page 17

Upload from File

Name of the uploaded key

nt ential

Browse to the location where a PGP public key that you want to use is located.

Import from ASCII Armor

Name of the imported key

TIBCO B


Assig

ASCII Formatted Text

Paste the text of a PGP public key in ASCII Armor format, where the key is base64 encoded and wrapped with a PGP specific header and footer such as:

Table 7 Import from ASCII ArmorusinessConnect Trading Partner Administration

8. Click Save.

n a Shadow Certificate for the Partner

To assign a shadow certificate:


Figure 3 Edit Partner Participant, Credentials Tab

2. Click on the certificate thats about to expire first.

The Edit Certificate dialog appears.

-----BEGIN PGP PUBLIC KEY BLOCK-----Version: BCPG v1.46mQENBE2cttgDCACO4PRiKPLFNheitPoyNvnuNTghwjNNmSB7BMprzQ3vMeV1XMUgaAW7/qH3YxT3UbHdXkyP9oH/A47pFNoMCvsIgae9mqZoKKWoKCWHRpishTtv5rXVP2O/KhUqjgBCd3HZ1qjnDJEVHwOm37H6Iqyd66tRTsW57Wztxy9hRdftM77aaKJl...AwKMfdaQnd1ntV6BXFM6GXdl5HJhjjY/HVJtRb498Rjba9IUVSe1VuhLt4fHSh/0wgvMs7z6ymy04dr85vmNqtaKOQgWWs8==Fd6T-----END PGP PUBLIC KEY BLOCK-----

Shadow PGP certificates are currently not supported.

Credentials Tab for Participants | 193. In the Shadow Settings area, select the Activation date for shadow Certificate

using the three dropdown menus. This date has to be chosen before the first certificate is about to expire.

4. From the Shadow Certificate dropdown list, select the certificate you would like to use as replacement.

Expo TIBCO BusinessConnect Trading Partner Administration

5. Click Save.

After the shadow certificate takes effect, it is still a shadow certificate. You need to remove or update the original certificate and remove or promote the shadow certificate.

rting PGP KeysPGP keys can be exported in two formats:

Binary With this format, the key content will be saved directly into a file.

ASCII Armor With this format, both the private and the public keys will be base64 encoded and wrapped with a PGP specific header and footer. The text boxes that contain the ASCII Armor encoded key parts are editable.

Users can export either the public or private portions of the PGP key pair, but these two portions of a key pair are always exported separately. When users also have an option to copy the contents of the public key in ASCII armor format from a screen.

Exporting the Hosts PGP Key Pair in a Binary FormatTo export a PGP key pair in a binary format:

1. In the Participants> Host > Credentials window, select the checkbox next to the PGP private key you want to export.

2. Click Export.

3. In the Export PGP Private Key window:

a. Click set next to the Private Key Password.

b. Enter the new password for export two times.

4. In the Private Key section, click Export Binary File.

If a PGP private key was generated, or imported from ASCII Armor format where both the private key part and the public key part are available, then both the private key and the public key can be exported; otherwise, if the PGP private key was uploaded from a file where only the private key part is available, then only the private key can be exported.

TIBCO B

20 | Chapter 1 Participants5. Save the file key_name_pgp.priv on a desired location.

6. In the Public Key section, click Export Binary File.

7. Save the file key_name_pgp.pub on a desired location.usinessConnect Trading Partner Administration

Exporting the Partners PGP Public Key in a Binary FormatTo export an uploaded public PGP Key in a binary format:

1. In the Participants> Partner > Credentials window, select the checkbox next to the PGP public key you want to export.

2. Click Export.

3. In the Export PGP Public Key window, click Export Binary File.

4. Save the file key_name_pgp.pub on a desired location.

Exporting the Hosts PGP Key Pair in the ASCII Armor FormatTo export the hosts PGP key pair in the ASCII Armor format:

1. In the BusinessConnect> Participants> Host> Credentials window, click on the link for the PGP private key you want to export.

2. In the Edit PGP Private Key window, copy

Tib Bc Tpadmin Guide

Documents

Transcript of Tib Bc Tpadmin Guide