About the Https eWay JCD Sample Projects | Sun Microsystems 5.1.1

Chapter 7

Implementing the HTTPS eWay JCD Sample Projects

This chapter provides an introduction to the HTTPS eWay JCD components, and information on how these components are created and implemented in a Sun Java Composite Application Platform Suite Project. Sample Projects are designed to provide an overview of the basic functionality of the HTTPS eWay by identifying how information is passed between eGate and supported external systems via HTTPS.

It is assumed that you understand the basics of creating a Project using the Enterprise Designer. For more information on creating an eGate Project, see the eGate Tutorial and the eGate Integrator User’s Guide.

What’s in This Chapter

About the HTTPS eWay JCD Sample Projects on page 95

Importing a Sample Project on page 96

Building and Deploying the prjHTTPClient_JCD Sample Project on page 96

Building and Deploying the prjHTTPServer_JCD Sample Project on page 104

7.1About the HTTPS eWay JCD Sample Projects

The HTTPS eWay HTTPS_eWay_Sample.zip file contains two sample Projects that provide basic instruction on using HTTPS operations with Java Collaboration Definition (JCD).

The prjHTTPClient_JCD sample Project allows you to observe an end-to-end data- exchange scenario involving eGate and the HTTPS eWay. The Project also demonstrates how the HTTPS eWay uses the GET and POST commands to request and receive data from a specific Web site.

The prjHTTPServer_JCD sample Project demonstrates how the HTTPS eWay can receive information via HTTP from a server.

HTTPS eWay Adapter User’s Guide

95

Sun Microsystems, Inc.

Image 95

Sun Microsystems 5.1.1 manual Implementing the Https eWay JCD Sample Projects, About the Https eWay JCD Sample Projects

Contents

EWAY Https Adapter USER’S Guide Version Contents Additional SSL Section Notes Verify hostname Http Settings Proxy Configuration Security AuthenticationHttp OTD Method Descriptions Server Mode Operation Connection Pool Settings Implementing the Https eWay JCD Sample Projects Running the Sample Running the Sample in SSL Mode What’s in This Chapter About Http and Https Web Browser Cookies About the Https eWayHttp Messages Cookie Expiration Date Checking Sample Http Exchange in Client ModeGET and Post Methods Body Html Sample Http Exchange in Server Mode Sample Input Form What’s New in This Release About This Document Https eWay Javadoc ScopeIntended Audience Text Conventions Documentation Feedback Related DocumentsSun Microsystems, Inc. Web Site Https eWay System Requirements Installing the Https eWay After you have installed eGate or eInsight, do the following Installing the Https eWay on an eGate supported system Steps to extract the Sample Projects include After InstallationExtracting the Sample Projects and Javadocs Steps to extract the Javadoc include Import the Project Ican 5.0 Project Migration ProceduresInstall Java Caps Export the Project Installing Enterprise Manager eWay Plug-Ins Https eWay Alert Codes Viewing Alert CodesTo add plug-ins from the Enterprise Manager To View the eWay Alert Codes HTTPCLIENTEWAY-CONNECT Https Client OTD Overview of eWay OTDs Http OTD Method Descriptions Https Server OTD Input Server Request Node Working with the Server OTD Input Server Response Node SendResponse Example Collaboration Example Overview Operating SSL Https eWay Hacker Creating a KeyStore in JKS Format KeyStores and TrustStoresGenerating a KeyStore and TrustStore KeyStores To generate a KeyStore Creating a KeyStore in PKCS12 Format To create a new TrustStore Using an Existing TrustStoreTrustStores Creating a TrustStore SSL Handshaking EWay ClientServer Server Web Client EWay Creating a Sample CA Certificate Using the OpenSSL Utility Signing Certificates With Your Own CA # SSLeay example properties file Windows OpenSSL.cnf File Example Chapter Section Operating SSL Using the OpenSSL Utility Copyright 1998-2001 The OpenSSL Project. All rights reserved Configuring the eWay Connectivity Map Properties Creating and Configuring the Https eWay To configure the Https Server eWay properties To configure the Https eWay properties Connectivity Map with Components Server Configuring the eWay Environment Properties EWay Connectivity Map Properties To Configure the Environment Properties Http eWay-HTTP Settings Configuring the Connectivity Map Https eWay PropertiesHttps eWay Configuration Sections Include Https Server eWay Configuration Sections Include EWay Environment Properties Http Server eWay-HTTP Server External Configuration Environment Configuration-HTTP Settings Http Settings Environment Configuration-Proxy Configuration Proxy Configuration Proxy Username Proxy passwordSecurity Name Description Required Value Proxy Port Environment Configuration-Security, SSL AuthenticationEnvironment Configuration-Security, Authentication Com.ibm.jsse.IBMJSSEProvid Name Description Required Value Jsse Provider ClassCom.sun.net.ssl.internal.ssl.P Rovider Required Values Additional SSL Section NotesVerify hostname Description Additional information Connection Pool SettingsEnvironment Configuration-Connection Pool Settings Setting Acceptor Threads Property for Https Server Mode EInsight Engine and Components Implementing the Https eWay Bpel Sample Projects Node Name Description Server Mode OperationHttps eWay With eInsight Receive Business Rule Designer Output Nodes Receive Business Rule Designer Output Nodes Importing a Sample Project About the Https eWay eInsight Sample Projects Project Overview Building and Deploying the prjHTTPClientBPEL Sample Project Input and Output Data GET Command GetSample.xmlProject Operations Sample DTD MultipleDataIn.dtd Post Command PostSample.xmlCreating a Project Creating the OTD OTD Wizard Selection Include DTDs to Selected List OTD Options Creating a Business Process Logic of the Business Process Case Activity Result Business Process CasesTo create a Business Process Business Process Icons Client Business Process With Link Business Rules Client Business Rule Designer First Link Business Rule Business Rule Designer Second Link Business Rule Business Rule Designer Third Link Business Rule Business Rule Designer Case 1 Business Rule Business Rule Designer Case 2 Business Rule Decision Gate Properties Dialog Box Case To create a Connectivity Map Creating a Connectivity Map To select external applications Selecting External ApplicationsPopulating the Connectivity Map Defining the Business Process Steps required to bind eWay components together Binding the eWay Components Environment Editor envHTTPClientBPEL Creating an Environment CmHTTPClient Outbound File eWay Settings Configuring the eWaysConfiguring the Https eWay Properties CmHTTPClient Inbound File eWay Settings Creating and Activating the Deployment Profile Configuring the Integration Server Create and Start the Domain Creating and Starting the Domain Build the Project Building and Deploying the ProjectRunning the Sample Building and Deploying the prjHTTPServerBPEL Sample Project ƒ postBPELHTTPS Content of postBPELHTTPS.html is Server Sample Project Original Form Project Forms Server Sample Project Input Form Next step is to create the Project’s Business Process Business Process Icons for Receive and Reply Business Process Icons With Server Business Rules Business Rule Designer Server Receive Business Rule Creating a Connectivity Map Connectivity Map With Components prjHTTPServerBPEL Creating an Environment ƒ postBPELHTTPS.html input file Running the Sample in SSL Mode Permission java.util.PropertyPermission * read, write About the Https eWay JCD Sample Projects Implementing the Https eWay JCD Sample Projects Building and Deploying the prjHTTPClientJCD Sample Project Https eWay Sample Project Java Collaboration Based SampleIn DTD SampleIn.dtd Creating the Collaboration Definition Java JcdHTTPClient Collaboration Definition Part 101 Connectivity Map With Components prjHTTPClientJCD 103 ƒ Project Overview on Building and Deploying the prjHTTPServerJCD Sample Project ƒ postJCEHTTPS 106 107 JcdHTTPServer Collaboration Definition Connectivity Map With Components prjHTTPServerJCD 110 ƒ postJCEHTTPS.html input file 112 Index 114