Sun Microsystems SUN SEEBEYOND eWAY 5.1.1 User Manual
  1. Manuals
  2. Brands
  3. Sun Microsystems Manuals
  4. Adapter
  5. SUN SEEBEYOND eWAY 5.1.1
  6. User manual
Sun Microsystems SUN SEEBEYOND eWAY 5.1.1 User Manual

Sun Microsystems SUN SEEBEYOND eWAY 5.1.1 User Manual

Https adapter
Hide thumbs
Table of Contents

Advertisement

Quick Links

Download this manual
SUN SEEBEYOND
eWAY™ HTTPS ADAPTER USER'S
GUIDE
Release 5.1.1

Advertisement

Table of Contents
loading

Related Manuals for Sun Microsystems SUN SEEBEYOND eWAY 5.1.1

Summary of Contents for Sun Microsystems SUN SEEBEYOND eWAY 5.1.1

  • Page 1 SUN SEEBEYOND eWAY™ HTTPS ADAPTER USER’S GUIDE Release 5.1.1...
  • Page 2 Sun, Java, Sun Java Composite Application Platform Suite, Sun, SeeBeyond, eGate, eInsight, eVision, eTL, eXchange, eView, eIndex, eBAM et eWay sont des marques de fabrique ou des marques déposées de Sun Microsystems, Inc. aux Etats- Unis et dans d'autres pays.Toutes les marques SPARC sont utilisées sous licence et sont des marques de fabrique ou des marques déposées de SPARC International, Inc.

  • Page 3: Table Of Contents

    About This Document HTTPS eWay Javadoc Scope Intended Audience Text Conventions Related Documents Sun Microsystems, Inc. Web Site Documentation Feedback Chapter 2 Installing the HTTPS eWay HTTPS eWay System Requirements Installing the HTTPS eWay Installing the HTTPS eWay on an eGate supported system...
  • Page 4 Connectivity Map Properties Configuring the Connectivity Map HTTPS eWay Properties Configuring the Connectivity Map HTTPS Server eWay Properties eWay Environment Properties HTTP Settings Proxy Configuration Security Authentication Additional SSL Section Notes Verify hostname HTTPS eWay Adapter User’s Guide Sun Microsystems, Inc.
  • Page 5 Populating the Connectivity Map Defining the Business Process Binding the eWay Components Creating an Environment Configuring the eWays Creating and Activating the Deployment Profile Creating and Starting the Domain Building and Deploying the Project HTTPS eWay Adapter User’s Guide Sun Microsystems, Inc.
  • Page 6 Creating an Environment Configuring the eWays Creating and Activating the Deployment Profile Creating and Starting the Domain Building and Deploying the Project Running the Sample Running the Sample in SSL Mode Index HTTPS eWay Adapter User’s Guide Sun Microsystems, Inc.

  • Page 7: Introducing The Https Eway

    What’s New in This Release on page 11 About This Document on page 12 Related Documents on page 13 Sun Microsystems, Inc. Web Site on page 14 Documentation Feedback on page 14 About HTTP and HTTPS HTTP HTTP (hypertext transfer protocol) is the set of rules used for transferring files (text, graphic images, sound, and video) over the Web.

  • Page 8: About The Https Eway

    HTTP request, for example: Cookie: sessauth=44c46a10 Each time the eWay sends a request to the same server during a session, the cookie is sent along with the request. HTTPS eWay Adapter User’s Guide Sun Microsystems, Inc.

  • Page 9: Cookie Expiration Date Checking

    First open a socket to the host www.myhost.com, port 80 (use the default port of 80 because none is specified in the URL). You can then send a request through a socket that looks like the following example: HTTPS eWay Adapter User’s Guide Sun Microsystems, Inc.

  • Page 10: Sample Http Exchange In Server Mode

    In a simple example, the HTTPS eWay receives a request from the following form: <HTML><HEAD><TITLE>HTTP Server JCE Test Page</TITLE></HEAD> <BODY> <FORM ACTION="http://localhost:18001/Deployment1_servlet_MyServlet/ MyServlet" METHOD=POST> <TABLE> <TR><TD>What's your name? </TD><TD><INPUT NAME=fname></TD></TR> <TR><TD></TD><TD></TD></TR> </TABLE> <BR> <CENTER><INPUT TYPE=submit VALUE="Submit"></CENTER> </FORM> </BODY> </HTML> HTTPS eWay Adapter User’s Guide Sun Microsystems, Inc.

  • Page 11: What's New In This Release

    Version Control: An enhanced version control system allows you to effectively manage changes to the eWay components. Manual Connection Management: Establishing a connection can now be performed automatically (configured as a property) or manually (using OTD methods from the Java Collaboration). HTTPS eWay Adapter User’s Guide Sun Microsystems, Inc.

  • Page 12: About This Document

    Project that uses eInsight. Chapter 7 “Implementing the HTTPS eWay JCD Sample Projects”: Describes how to implement the HTTPS eWay using a review of the sample Project, which uses Java-based Collaborations. HTTPS eWay Adapter User’s Guide Sun Microsystems, Inc.

  • Page 13: Https Eway Javadoc

    -jar filename.jar samples; variables are shown in bold italic Hypertext links within Blue bold Text Conventions on page 13 document Hypertext links for Web Blue underlined http://www.sun.com addresses (URLs) or email addresses HTTPS eWay Adapter User’s Guide Sun Microsystems, Inc.

  • Page 14: Related Documents

    Sun SeeBeyond eGate™ Integrator Sun Java Composite Application Platform Suite Installation Guide Sun Microsystems, Inc. Web Site The Sun Microsystems web site is your best source for up-to-the-minute product news and technical support information. The site’s URL is: http://www.sun.com Documentation Feedback We appreciate your feedback.

  • Page 15: Installing The Https Eway

    Note: When the Repository is running on a UNIX operating system, the eWays are loaded from the Sun Java Composite Application Platform Suite Installer running on a Windows platform connected to the Repository server using Internet Explorer. HTTPS eWay Adapter User’s Guide Sun Microsystems, Inc.

  • Page 16: Installing The Https Eway On An Egate Supported System

    “Installing the HTTPS eWay on an eGate supported system” on page Open the Enterprise Designer and select Update Center from the Tools menu. The Update Center Wizard appears. For Step 1 of the wizard, simply click Next. HTTPS eWay Adapter User’s Guide Sun Microsystems, Inc.

  • Page 17: After Installation

    HTTPS_eWay_Sample.zip file contains two additional ZIP files for each sample Project. Refer to “Importing a Sample Project” on page 58 for instructions on importing the sample Project into your repository via the Enterprise Designer. HTTPS eWay Adapter User’s Guide Sun Microsystems, Inc.

  • Page 18: Ican 5.0 Project Migration Procedures

    When a Project is exported, the Project’s components are automatically “checked in” to Version Control to write-protected each component. These protected components appear in the Explorer tree with a red padlock in the bottom-left corner of each icon. HTTPS eWay Adapter User’s Guide Sun Microsystems, Inc.

  • Page 19: Installing Enterprise Manager Eway Plug-Ins

    Download under the Sun Java Composite Application Platform Suite Installer’s DOWNLOADS tab. There are two ways to add eWay Enterprise Manager plug-ins: From the Sun SeeBeyond Enterprise Manager From the Sun Java Composite Application Platform Suite Installer HTTPS eWay Adapter User’s Guide Sun Microsystems, Inc.

  • Page 20: Viewing Alert Codes

    Alert Code Description User Action HTTPCLIENTEWAY-CONFIG- Occurs if there your project Connectivity Map and External FAILED000001=Configuration deployment parameters are configuration information is error encountered for HTTP invalid. invalid. Verify configured Client eWay. parameters. HTTPS eWay Adapter User’s Guide Sun Microsystems, Inc.
  • Page 21 Refer to the log files for more information. For information on Managing and Monitoring alert codes and logs, see the Sun SeeBeyond eGate Integrator System Administration Guide. HTTPS eWay Adapter User’s Guide Sun Microsystems, Inc.

  • Page 22: Understanding The Https Eway Otd

    Javadoc provided with the eWay documentation in the Enterprise Manager. HTTPS Client OTD The HTTPS OTD is specific to the HTTPS eWay. It is used as an inbound or outbound OTD in a Collaboration. HTTPS eWay Adapter User’s Guide Sun Microsystems, Inc.

  • Page 23: Http Otd Method Descriptions

    HTTPS Server eWay receives from an HTTP client, while the Response node is used to set the HTTP response data that will be sent back to the HTTP client. Figure 3 Input Server OTD HTTPS eWay Adapter User’s Guide Sun Microsystems, Inc.
  • Page 24 Chapter 3 Section 3.3 Understanding the HTTPS eWay OTD HTTPS Server OTD Figure 4 Input Server Request Node HTTPS eWay Adapter User’s Guide Sun Microsystems, Inc.
  • Page 25 It is critical that you use this method to send the response back to the client. Otherwise, the client will wait indefinitely for the response. HTTP requires that a response be sent to the client whether the response is a valid application response or an application error response. HTTPS eWay Adapter User’s Guide Sun Microsystems, Inc.
  • Page 26 “text/html” on the Response node, sets the Text property with the HTML response, and then calls the sendResponse() method on the HTTP server input OTD to send the constructed response to the HTTP client. Figure 7 sendResponse() Example HTTPS eWay Adapter User’s Guide Sun Microsystems, Inc.

  • Page 27: Operating Ssl

    The use of SSL with HTTP, here called HTTPS, enables HTTP data exchanges that are secure from unauthorized interception from “hackers” or other entities. The eWay’s SSL feature provides a secure communications channel for the data exchanges (see Figure HTTPS eWay Adapter User’s Guide Sun Microsystems, Inc.
  • Page 28 SSL version 3.0 and TLS 1.0. For more information, visit the Sun Java Web site at the following URL: http://java.sun.com Note: See the JSSE documentation provided by Sun Microsystems for further details. HTTPS eWay Adapter User’s Guide Sun Microsystems, Inc.

  • Page 29: Keystores And Truststores

    By default, as specified in the java.security file, keytool uses JKS as the format of the key and certificate databases (KeyStore and TrustStores). A CA must sign the certificate HTTPS eWay Adapter User’s Guide Sun Microsystems, Inc.
  • Page 30 This KeyStore contains an entry with an alias of client. This entry consists of the Generated private key and information needed for generating a CSR as follows: keytool -keystore clientkeystore -certreq alias client -keyalg rsa -file client.csr HTTPS eWay Adapter User’s Guide Sun Microsystems, Inc.

  • Page 31: Creating A Keystore In Pkcs12 Format

    PKCS12 database. However, it can read from a PKCS12 database. Note: There are additional third-party tools available for generating PKCS12 certificates, if you want to use a different tool. HTTPS eWay Adapter User’s Guide Sun Microsystems, Inc.

  • Page 32: Truststores

    Once completed, myTrustStore is available to be used as the TrustStore for the eWay. Using an Existing TrustStore This section explains how to use an existing TrustStore such as the default Logical Host TrustStore in the location: HTTPS eWay Adapter User’s Guide Sun Microsystems, Inc.

  • Page 33: Ssl Handshaking

    Essentially, the eWay performs this operation by looking into its TrustStore for a CA certificate with a public key that can validate the signature on the certificate received from the Web server. This option is illustrated in Figure 9. HTTPS eWay Adapter User’s Guide Sun Microsystems, Inc.
  • Page 34 TrustStore for a matching trusted CA certificate. The communication channel is established by the process of both parties’ requesting certificate information. This option is illustrated in Figure HTTPS eWay Adapter User’s Guide Sun Microsystems, Inc.
  • Page 35 Figure 10 Dual Authentication Client Server Handshake: Client Hello (eWay) (Web Server) Handshake: ServerHello Handshake: Certificate Handshake: CertificateRequest Handshake: ServerHelloDone Handshake: Certificate Handshake: ClientKeyExchange Handshake: CertificateVerify ChangeCipherSpec Handshake: Finished ChangeCipherSpec Handshake: Finished HTTPS eWay Adapter User’s Guide Sun Microsystems, Inc.

  • Page 36: Using The Openssl Utility

    Common Name (eg, your websites domain name) [] :development.seebeyond.com Email Address []:development@seebeyond.com You are prompted for information. You must enter a password and remember this password for signing certificates with the CA’s private key. This command creates a HTTPS eWay Adapter User’s Guide Sun Microsystems, Inc.

  • Page 37: Signing Certificates With Your Own Ca

    -CAcreateserial This is how we create a signed certificate for the associated CSR. The option -CAcreateserial is needed if this is the first time the command is issued. It is used to HTTPS eWay Adapter User’s Guide Sun Microsystems, Inc.

  • Page 38: Windows Openssl.cnf File Example

    Windows OpenSSL.cnf File Example 4.4.3 This section contains the contents of the openssl.cnf file that can be used on Windows. Be sure to make the appropriate changes to the directories. # SSLeay example properties file. HTTPS eWay Adapter User’s Guide Sun Microsystems, Inc.
  • Page 39 [ policy_anything ] countryName= optional stateOrProvinceName= optional localityName= optional organizationName= optional organizationalUnitName= optional commonName = supplied emailAddress = optional #################################################################### [ req ] default_bits= 1024 default_keyfile = privkey.pem distinguished_name= req_distinguished_name attributes= req_attributes HTTPS eWay Adapter User’s Guide Sun Microsystems, Inc.
  • Page 40 Copyright © 1998-2001 The OpenSSL Project. All rights reserved. Copyright © 1994-2002 World Wide Web Consortium, (Massachusetts Institute of Technology, Institut National de Recherche en Informatique et en Automatique, Keio University). All Rights Reserved. http://www.w3.org/Consortium/Legal/ HTTPS eWay Adapter User’s Guide Sun Microsystems, Inc.

  • Page 41: Configuring The Https Eway

    Configuring the eWay Connectivity Map Properties When you connect an External Application to a Collaboration, Enterprise Designer automatically assigns the appropriate eWay to the link. Each eWay is supplied with a HTTPS eWay Adapter User’s Guide Sun Microsystems, Inc.
  • Page 42 The eWay Properties window appears, displaying the default properties for the eWay. Figure 12 eWay Properties - Client To configure the HTTPS Server eWay properties: On the Enterprise Designer’s Connectivity Map, double-click the HTTPS Server eWay icon. HTTPS eWay Adapter User’s Guide Sun Microsystems, Inc.

  • Page 43: Configuring The Eway Environment Properties

    Environment. When you create a new HTTPS External System, you may configure the type of External System required. Available External System properties include: HTTP Settings Proxy Configuration Security Connection Pool Settings HTTPS eWay Adapter User’s Guide Sun Microsystems, Inc.

  • Page 44: Eway Connectivity Map Properties

    Click on any property field to make it editable. After modifying the configuration properties, click OK to save the changes. eWay Connectivity Map Properties The eWay Connectivity Map consists of the following properties categories. HTTPS eWay Adapter User’s Guide Sun Microsystems, Inc.

  • Page 45: Configuring The Connectivity Map Https Eway Properties

    The default is text/*. Configuring the Connectivity Map HTTPS Server eWay 5.4.2 Properties The HTTPS Server eWay Properties include parameters used by the external system. HTTPS eWay Adapter User’s Guide Sun Microsystems, Inc.

  • Page 46: Eway Environment Properties

    The following list identifies the HTTPS eWay properties. There are four Environment Configuration categories that the HTTPS eWay implements. Property Categories Configured in the Logical Host Environment HTTP Settings on page 47 HTTPS eWay Adapter User’s Guide Sun Microsystems, Inc.

  • Page 47: Http Settings

    URLs, be sure the targeting URL supports the encoding used in this property. A list of the character encoding supported by the Java 2 platform is at the Sun Web site: http://java.sun.com HTTPS eWay Adapter User’s Guide Sun Microsystems, Inc.

  • Page 48: Proxy Configuration

    This specifies the HTTPS proxy host name. to which requests to an HTTP server or reception of data from an HTTP server may be delegated to a proxy. This sets the proxy port for secured HTTP connections. HTTPS eWay Adapter User’s Guide Sun Microsystems, Inc.

  • Page 49: Security

    “Creating and Starting the Domain” on page 81 to create a new domain. Security 5.5.3 The Environment Configuration Security properties are used to perform HTTP authentication and SSL connections. They include the following configuration sections: Authentication HTTPS eWay Adapter User’s Guide Sun Microsystems, Inc.

  • Page 50: Authentication

    If you are running the Sun SeeBeyond Integration Server on AIX, choose or enter one of the following settings: SSL-TLS TLSv1 SSLv3 SSLv2 For details on these settings, see the appropriate JSSE documentation. HTTPS eWay Adapter User’s Guide Sun Microsystems, Inc.
  • Page 51 PKCS12 and JKS keystore types require passwords for access but do not require user names. If you enter a value for this property, it is ignored for PKCS12 and JKS. HTTPS eWay Adapter User’s Guide Sun Microsystems, Inc.

  • Page 52: Additional Ssl Section Notes

    You can use this property to enforce strict checking of the server host name in the request URL and the host name in the received server certificate. Required Values True or False; the default is False. HTTPS eWay Adapter User’s Guide Sun Microsystems, Inc.

  • Page 53: Connection Pool Settings

    Specifies the number of seconds that a A valid numeric value. The Timeout physical connection may remain unused default is 300. before it is closed. 0 (zero) indicates that there is no limit. HTTPS eWay Adapter User’s Guide Sun Microsystems, Inc.

  • Page 54: Setting Acceptor Threads Property For Https Server Mode

    To adjust the number of threads that wait for HTTP connections (Acceptor threads) according to the needs of your application, refer to the Sun SeeBeyond eGate™ Integrator System Administration Guide for more information. HTTPS eWay Adapter User’s Guide Sun Microsystems, Inc.

  • Page 55: Implementing The Https Eway Bpel Sample Projects

    Business Process, it automatically invokes that component using its Web Services interface. eGate components that can interface with eInsight in this way include: Object Type Definitions (OTDs) eWays Collaborations See the eInsight Business Process Manager User’s Guide for details. HTTPS eWay Adapter User’s Guide Sun Microsystems, Inc.

  • Page 56: Https Eway With Einsight

    Checks or sets whether the requested session ID came in as a ookie cookie. isRequestedSessionIdFromU Checks or sets whether the requested session ID came in as part of the request URL. isRequestedSessionIdValid Checks or sets whether the requested session ID is still valid. HTTPS eWay Adapter User’s Guide Sun Microsystems, Inc.
  • Page 57 Web header. values (WebParameterList) Gets or sets an array String objects containing all the values the given request parameter has, or null if the parameter does not exist. HTTPS eWay Adapter User’s Guide Sun Microsystems, Inc.

  • Page 58: About The Https Eway Einsight Sample Projects

    “Creating and Starting the Domain” on page Build and deploy the Project (see “Building and Deploying the Project” on page The following pages provide step-by-step instructions for creating the prjHTTPClient_BPEL and prjHTTPServer_BPEL sample Projects. HTTPS eWay Adapter User’s Guide Sun Microsystems, Inc.

  • Page 59: Building And Deploying The Prjhttpclient_Bpel Sample Project

    POST Operations: Posts a name/value pair to a form and writes the same information to an HTML file, to confirm the posting. Figure 16 shows the flow of the sample HTTPS eWay Project. HTTPS eWay Adapter User’s Guide Sun Microsystems, Inc.

  • Page 60: Project Operations

    The HTTPS eWay Project uses the following input/output data files: Get_Sample.xml Post_Sample.xml MultipleData_In.dtd These files have the following content: GET Command: Get_Sample.xml The input data file for the GET command is: <website> <method>GET</method> <url>http://www.yahoo.com</url> <data/> </website> HTTPS eWay Adapter User’s Guide Sun Microsystems, Inc.

  • Page 61: Creating A Project

    The next step is to create a Data Type Definition (DTD) OTD as an input file for this HTTPS sample Project. Steps required to create new DTD: In the Enterprise Explorer, right-click prjHTTPClient_BPEL and select New > Object Type Definition from the pop-up menu. HTTPS eWay Adapter User’s Guide Sun Microsystems, Inc.
  • Page 62 Click Next. From the Include DTDs to Selected List window, browse to the MultipleData_In.dtd located in the sample folder. Click Select. The MultipleData_In.dtd file appears in the Selected DTD Files pane. See Figure HTTPS eWay Adapter User’s Guide Sun Microsystems, Inc.
  • Page 63 Building and Deploying the prjHTTPClient_BPEL Sample Project Figure 18 Include DTDs to Selected List Click Next. From the Select Document Elements section, select MultipleData_In_website and click Next. The OTD Options screen appears. HTTPS eWay Adapter User’s Guide Sun Microsystems, Inc.

  • Page 64: Creating A Business Process

    Project Explorer as the OTD icon MultipleData_In_website. Creating a Business Process 6.5.4 The next step is to create the Project’s Business Process. The logic of the Business Process is shown in Figure 20. HTTPS eWay Adapter User’s Guide Sun Microsystems, Inc.
  • Page 65 GET operation, it is routed to Case 1. If the inbound file requests a POST operation, it is routed to Case 2. Table 11 shows how these cases operate of this Business Process. HTTPS eWay Adapter User’s Guide Sun Microsystems, Inc.
  • Page 66 From the Business Process canvas toolbar: Decision (a Decision End icon also appears) Two Business Rule icons, for your two cases Again by dragging, arrange these icons on the canvas as shown in Figure 21. HTTPS eWay Adapter User’s Guide Sun Microsystems, Inc.
  • Page 67 To do this operation, right-click on the desired link and choose Add Business Rule from the pop-up menu. See Figure 23 for the appropriate links where you must add these Link Business Rules. HTTPS eWay Adapter User’s Guide Sun Microsystems, Inc.
  • Page 68 Output pane, and dropping it onto the contents node you want to assign it to, in the Input pane. In this way, create the first Link Business Rule, as shown in Figure 24. HTTPS eWay Adapter User’s Guide Sun Microsystems, Inc.
  • Page 69 Building and Deploying the prjHTTPClient_BPEL Sample Project Figure 24 Business Rule Designer: First Link Business Rule In the same way as you did previously, create additional Link Business Rules, as shown in Figure 25 and Figure 26. HTTPS eWay Adapter User’s Guide Sun Microsystems, Inc.
  • Page 70 Chapter 6 Section 6.5 Implementing the HTTPS eWay BPEL Sample Projects Building and Deploying the prjHTTPClient_BPEL Sample Project Figure 25 Business Rule Designer: Second Link Business Rule HTTPS eWay Adapter User’s Guide Sun Microsystems, Inc.
  • Page 71 Using the Business Rule Designer in the same way as you did previously, set properties for the Business Rule icon component for Case 1 by dragging and dropping the nodes, as shown in Figure 27. HTTPS eWay Adapter User’s Guide Sun Microsystems, Inc.
  • Page 72 Building and Deploying the prjHTTPClient_BPEL Sample Project Figure 27 Business Rule Designer: Case 1 Business Rule Set properties For the Business Rule icon component for Case 2 by dragging and dropping the nodes, as shown in Figure 28. HTTPS eWay Adapter User’s Guide Sun Microsystems, Inc.
  • Page 73 Drag Method under MultipleData_In_with_top_website.unmarshal.Output to any1 under EQUAL in the left pane. Drag GET under string literal to any2. Drag return boolean under EQUAL to Result (boolean) in the right pane. See Figure 29. HTTPS eWay Adapter User’s Guide Sun Microsystems, Inc.
  • Page 74 Drag Method under MultipleData_In_with_top_website.unmarshal.Output to any1 under EQUAL in the left pane. Drag POST under string literal to any2. Drag return boolean under EQUAL to Result (boolean) in the right pane. See Figure 30. HTTPS eWay Adapter User’s Guide Sun Microsystems, Inc.

  • Page 75: Creating A Connectivity Map

    New > Connectivity Map from the shortcut menu. The new Connectivity Map appears and a node for the Connectivity Map is added under the Project on the Project Explorer tree labeled CMap1. Rename the Connectivity Map cmHTTPClient. HTTPS eWay Adapter User’s Guide Sun Microsystems, Inc.

  • Page 76: Selecting External Applications

    Defining the Business Process Define your Business Process by combining the Business Process icon with the Service icon in the Connectivity Map. To do so, drag and drop the bpHTTPClient icon from the HTTPS eWay Adapter User’s Guide Sun Microsystems, Inc.

  • Page 77: Binding The Eway Components

    Invoked Services) to the eaHTTPClientOUT External Application. From the HttpBpelService Binding dialog box, map FileReceiver to the FileClientOUT External Application, as seen in Figure 32. Figure 32 Connectivity Map - Associating (Binding) the Project’s Components HTTPS eWay Adapter User’s Guide Sun Microsystems, Inc.

  • Page 78: Creating An Environment

    Environment Explorer tree under LogicalHost1. Save changes to the repository. The Environment Explorer and Environment Editor now appear as displayed in Figure 33. Figure 33 Environment Editor - envHTTPClient_BPEL Save your current changes to the Repository. HTTPS eWay Adapter User’s Guide Sun Microsystems, Inc.

  • Page 79: Configuring The Eways

    Select a directory, for example C:/DATA/output Configuring the HTTPS eWay Properties From the Environment Explorer tree, right-click the esHTTP External System and select Properties from the shortcut menu. The Properties Editor appears. HTTPS eWay Adapter User’s Guide Sun Microsystems, Inc.

  • Page 80: Configuring The Integration Server

    New > Deployment Profile. Enter a name for the Deployment Profile (for this sample dpHTTPClient_BPEL). Select envHTTPClient_BPEL as the Environment and click OK. From the Deployment Editor toolbar, click the Automap icon (see Figure 34). HTTPS eWay Adapter User’s Guide Sun Microsystems, Inc.

  • Page 81: Creating And Starting The Domain

    Project is built and then deployed. Create and Start the Domain Navigate to your <JavaCAPS51>\logicalhost directory (where <JavaCAPS51> is the location of your Java Composite Application Platform Suite installation. Double-click the domainmgr.bat file. The Domain Manager appears. HTTPS eWay Adapter User’s Guide Sun Microsystems, Inc.

  • Page 82: Building And Deploying The Project

    HttpClient_BPEL_output0.htm (sample output file example) HttpClient_BPEL_output1.htm (sample output file example) To run your deployed sample Project, do the following: From your configured input directory, paste (or rename) the sample input file to trigger the eWay. HTTPS eWay Adapter User’s Guide Sun Microsystems, Inc.

  • Page 83: Building And Deploying The Prjhttpserver_Bpel Sample Project

    <HTML><HEAD><TITLE>HTTPS Test Page</TITLE></HEAD> <BODY> <FORM ACTION="http://localhost:18001/ Deployment1_servlet_HttpServerSample/ HttpServerSample" METHOD=POST> <TABLE> <TR><TD>First Name:</TD><TD><INPUT NAME=fname></TD></TR> <TR><TD>Last Name:</TD><TD><INPUT NAME=lname></TD></TR> <TR><TD>EMail:</TD><TD><INPUT NAME=email></TD></TR> <TR><TD>Sex:</TD><TD><INPUT type="radio" name="sex" value="Male">Male</TD></TR> <TR><TD></TD><TD><INPUT type="radio" name="sex" value="Female">Female</TD></TR> <TR><TD></TD><TD></TD></TR> </TABLE> <BR> <CENTER><INPUT TYPE=submit VALUE="Submit"></CENTER> HTTPS eWay Adapter User’s Guide Sun Microsystems, Inc.

  • Page 84: Project Forms

    Server Name>:<IS port>/<Deployment_name>_servlet_ <servlet_url from properties>/<servlet_url from properties> Project Forms Figure 36 shows the original form. Figure 36 Server Sample Project: Original Form Figure 37 shows the input form. HTTPS eWay Adapter User’s Guide Sun Microsystems, Inc.
  • Page 85 Implementing the HTTPS eWay BPEL Sample Projects Building and Deploying the prjHTTPServer_BPEL Sample Project Figure 37 Server Sample Project: Input Form Figure 38 shows the output form. Figure 38 Server Sample Project: Output Form HTTPS eWay Adapter User’s Guide Sun Microsystems, Inc.

  • Page 86: Project Operations

    Arrange the Start and End icons at opposite sides of the canvas. From the Project Explorer pane, drag the processRequest icon under the HTTPServer OTD nodes onto the canvas between the Start and End. See Figure 39. HTTPS eWay Adapter User’s Guide Sun Microsystems, Inc.
  • Page 87 Figure 41. To do this operation, right- click on the desired link and choose Add Business Rule from the pop-up menu. See Figure 41 for the appropriate links where you must add the Business Rules. HTTPS eWay Adapter User’s Guide Sun Microsystems, Inc.
  • Page 88 Business Rule Designer to create your Business Rules. From the Output pane, drag the name/value pair nodes (under WebParameterList) to the name/value pair nodes (under ParamList) n the Input pane. See Figure 42. HTTPS eWay Adapter User’s Guide Sun Microsystems, Inc.
  • Page 89 Building and Deploying the prjHTTPServer_BPEL Sample Project Figure 42 Business Rule Designer: Server Receive Business Rule From the Output pane, drag the contents node to the text node (under headerInfo) n the Input pane. See Figure 43. HTTPS eWay Adapter User’s Guide Sun Microsystems, Inc.

  • Page 90: Creating A Connectivity Map

    Connectivity Map. Name the Connectivity Map cmHTTPServer. Selecting External Applications Follow the steps outlined in “Selecting External Applications” on page 76 to select the external applications for the prjHTTPServer_BPEL Project’s Connectivity Map. HTTPS eWay Adapter User’s Guide Sun Microsystems, Inc.

  • Page 91: Populating The Connectivity Map

    HTTPSender in the HttpServer1 Binding dialog box, and drag the cursor to the HTTPServer1 External Application in the Connectivity Map. A link is now visible between HTTPServer1 and HttpServer1, as seen in Figure 45. HTTPS eWay Adapter User’s Guide Sun Microsystems, Inc.

  • Page 92: Creating An Environment

    HttpServerSample in the servlet-url property field, and click OK. For further information on configuring the HTTPS Server eWay Connectivity Map and Environment properties, see “eWay Connectivity Map Properties” on page 44 “eWay Environment Properties” on page HTTPS eWay Adapter User’s Guide Sun Microsystems, Inc.

  • Page 93: Creating And Activating The Deployment Profile

    Scroll to the Logical Host directory: <JavaCAPS51>\logicalhost\is\lib\install\templates\ where <JavaCAPS51> is the location of your Sun Java Composite Application Platform Suite installation Enter the following statements in the server.policy file: //JavaCAPS HTTPS eWay permission java.security.SecurityPermission “insertProvider.SunJSSE”; HTTPS eWay Adapter User’s Guide Sun Microsystems, Inc.
  • Page 94 Project. Note: You may need to create a new domain server after changing the Logical Host’s server policy file or modify the security policy for the existing domain per step two above. HTTPS eWay Adapter User’s Guide Sun Microsystems, Inc.

  • Page 95: Implementing The Https Eway Jcd Sample Projects

    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 Sun Microsystems, Inc.

  • Page 96: Importing A Sample Project

    Project Overview on page 97 Creating a Project on page 99 Creating the OTD on page 99 Creating the Collaboration Definition (Java) on page 99 Creating a Connectivity Map on page 101 HTTPS eWay Adapter User’s Guide Sun Microsystems, Inc.

  • Page 97: Project Overview

    The HTTPS eWay sample Project demonstrates how the HTTPS eWay processes information from an HTTPS system. Resulting or confirming information is then written to a text file. This scenario is illustrated in Figure 46. HTTPS eWay Adapter User’s Guide Sun Microsystems, Inc.

  • Page 98: Project Operations

    The eGate OTD wizard is used to create a DTD-based OTD. The input data file specifies an URL for HTTP commands. The XML DTD code for this sample input data file is: <!ELEMENT website (method, url, data)> <!ELEMENT method (#PCDATA)> <!ELEMENT url (#PCDATA)> <!ELEMENT data (#PCDATA)> HTTPS eWay Adapter User’s Guide Sun Microsystems, Inc.

  • Page 99: Creating A Project

    The Collaboration Editor user interface allows you to create the Business Rules that implement your business logic for a Java-based Collaboration. You can create the desired Business Rules for your Project by dragging and dropping values from a source HTTPS eWay Adapter User’s Guide Sun Microsystems, Inc.
  • Page 100 HTTPS functions, which are in turn able to call HTTPS eWay methods. The Business Rules for the jcdHTTPClient Java Collaboration Definition are displayed in Figure 47 and Figure 48. Figure 47 jcdHTTPClient Collaboration Definition - Part 1 HTTPS eWay Adapter User’s Guide Sun Microsystems, Inc.

  • Page 101: Creating A Connectivity Map

    File External System (2) Business Service (a service is a container for Java Collaborations, Business Processes, and so forth) HTTP Client External System Figure 49 shows the components in the Connectivity Map. HTTPS eWay Adapter User’s Guide Sun Microsystems, Inc.

  • Page 102: Defining The Business Process

    HTTPClient in the HttpClient1 Binding dialog box, and drag the cursor to the HTTPClient1 External Application in the Connectivity Map. A link is now visible between HTTPClient1 and jcdHttpClient1, as seen in Figure 50. HTTPS eWay Adapter User’s Guide Sun Microsystems, Inc.

  • Page 103: Creating An Environment

    You must configure eWay properties in both the Connectivity Map and the Environment Explorer. Follow the steps outlined in “eWay Connectivity Map Properties” on page 44 “eWay Environment Properties” on page 46 to configure the eWay properties for the prjHTTPClient_JCD Project. HTTPS eWay Adapter User’s Guide Sun Microsystems, Inc.

  • Page 104: Creating And Activating The Deployment Profile

    The HTTPS eWay server sample Project prjHTTPServer_JCD demonstrates how the HTTPS eWay receives information via HTTP from a server. Resulting or confirming information is then written to a data file. Project Overview on page 105 HTTPS eWay Adapter User’s Guide Sun Microsystems, Inc.

  • Page 105: Project Overview

    You must make a change in the HTML code shown previously. In the code where it shows: <FORM ACTION="http://localhost:18001/ Deployment1_servlet_HttpServerSample/ HttpServerSample" METHOD=POST> You must make changes based on your own Environment. The logic for the ACTION parameter is: http://<IS Server Name>:<IS port>/<Deployment_name>_servlet_ <servlet_url from properties>/<servlet_url from properties> HTTPS eWay Adapter User’s Guide Sun Microsystems, Inc.

  • Page 106: Project Forms

    Building and Deploying the prjHTTPServer_JCD Sample Project Project Forms Figure 51 shows the original form. Figure 51 Server Sample Project: Original Form Figure 52 shows the input form. Figure 52 Server Sample Project: Input Form HTTPS eWay Adapter User’s Guide Sun Microsystems, Inc.

  • Page 107: Project Operations

    From the Project Explorer tree, right-click the Repository and select New Project. A new Project (Project1) appears on the Project Explorer tree. Right-click Project1 and select Rename form the shortcut menu. Rename the Project (for this sample, prjHTTPServer_JCD). HTTPS eWay Adapter User’s Guide Sun Microsystems, Inc.

  • Page 108: Creating The Otd

    A Connectivity Map provides a canvas for assembling and configuring a Project’s components. The prjHTTPServer_JCD Project only uses one Connectivity Map. Follow the steps outlined in “Creating a Connectivity Map” on page 75 to create a Connectivity Map. Name the Connectivity Map cmHTTPServer. HTTPS eWay Adapter User’s Guide Sun Microsystems, Inc.

  • Page 109: Selecting External Applications

    From the HttpServer1 Binding dialog box, map HTTPSender (under Implemented Services) to the HTTPServer1 External Application. To do this, click on HTTPSender in the HttpServer1 Binding dialog box, and drag the cursor to the HTTPS eWay Adapter User’s Guide Sun Microsystems, Inc.

  • Page 110: Creating An Environment

    HttpServerSample in the servlet-url property field, and click OK. For further information on configuring the HTTPS Server eWay Connectivity Map and Environment properties, see “eWay Connectivity Map Properties” on page 44 “eWay Environment Properties” on page HTTPS eWay Adapter User’s Guide Sun Microsystems, Inc.

  • Page 111: Creating And Activating The Deployment Profile

    Scroll to the Logical Host directory: <JavaCAPS51>\logicalhost\is\lib\install\templates\ where <JavaCAPS51> is the location of your Sun Java Composite Application Platform Suite installation Enter the following statements in the server.policy file: HTTPS eWay Adapter User’s Guide Sun Microsystems, Inc.
  • Page 112 Project. Note: You may need to create a new domain server after changing the Logical Host’s server policy file or modify the security policy for the existing domain per step two above. HTTPS eWay Adapter User’s Guide Sun Microsystems, Inc.

  • Page 113: Index

    Java Collaborations, overview 99, 108 operation 60, 98 overview 59 Project sample, JCD overview 97 GET method 9 Project sample, server before running Project 83, 105 operation 86, 107 Handshaking, SSL 33 HTTPS eWay Adapter User’s Guide Sun Microsystems, Inc.
  • Page 114 HTTPS eWay 41 connection retry settings 50 eWay Connectivity Map 41, 44 eWay environment properties 43 outbound eWay 45 SSL Handshaking 33 Supporting documents 14 text conventions 13 TrustStore 29 generating 29, 32 HTTPS eWay Adapter User’s Guide Sun Microsystems, Inc.

Table of Contents