CLEO AS2 Test Guide Document Version 2.3, March 1, 2005 Copyright 2005 Cleo Communications Process Map If just getting started with LexiCom or VLTrader, follow these steps to configure and run a test with the appropriate Cleo pre-configured AS2 test host: Overview Obtain your local host address from your system administrator (page 1). Configure your client-side firewall (page 2.) Create a new self-signed certificate (page 2 & 3.) If there is a corresponding test host, activate the appropriate Pre-configured Cleo AS2 System Test host(s) and the Local Listener (page 4). Configure your Local Listener (page 5.) Run a test (page 5.) The pre-configured CLEO AS2 System Test Hosts for Wal-Mart Meijer Sterling Commerce GXS Kohls and Local Listener are provided to allow a quick test of your system installation and configuration. You will only need to define a couple parameters specific to your installation. Obtain Your Local Host Address A static visible external IP address (or qualified host name which includes your domain address) for the system where you have installed LexiCom or VLTrader (your local host) must be obtained. You will use this address or host name to properly configure your Local Listener and to eventually exchange URL information with your trading partner. 1
Contact your systems administrator if you do not know your external IP address or host name or obtain it from the following link: http://www.cleo.com/whoami Configure Your Client-Side Firewall Note: Contact your systems administrator with questions pertaining to your firewall. If you are using a firewall, the following rules will need to be created: For communication to the CLEO AS2 System Test site, open 208.46.32.210 to port 5080 Certificate Creation AS2 requires a local listener and a certificate is required to run the listener. LexiCom and VLTrader provide an integrated Certificate Manager, which you may use to create a self-signed certificate. Note: If you already have a signing certificate, you can import it and use it to test with the Cleo AS2 test host instead of creating a self signed certificate. See the section, Certificate Manager: Reference, in the LexiCom/VLTrader User s Guide for instructions on importing a certificate; otherwise continue with the following instructions for generating a selfsigned certificate. Generating Self-Signed Certificates Select the Certificates icon on the LexiCom or VLTrader panel: 2
1. Right-click the Users store in the tree pane and select Generate>Selfsigned User Certificate An editor display similar to the following will appear: 2. Enter the required information. The above is an example. Note: Be sure to record your User Alias and Password, as they will be required later to configure the Local Listener. 3
User Alias Common Name Email Organization Unit Organization City State Country Signature Algorithm DigitalSignature KeyEncipherment Valid For Private Key Size Private Key Password Confirm Password An arbitrary name for the certificate (e.g. Cleo ) A user name for client-style certificates; a fully qualified computer name (or registered IP address) for server-style certificates (e.g. cleo.dficomm.dficom.com ). e.g. user@cleo.com This could be a company department (e.g. Cleo Engineering, or Cleo Production ) Official company name (e.g. DFI Communications, Inc. ) Complete city name (e.g. Loves Park ) Complete state name (e.g. Illinois ) Two characters only (e.g. US ) Either MD5 or SHA-1. Cleo suggests SHA-1 Set if certificate is to be used for SSL client or S/MIME (AS2) signing. This field should generally be checked. Set if certificate is to be used for SSL server or S/MIME (AS2) encryption. This field should generally be checked. The number of months that this certificate will be valid. By default, it is set to 24 months, but may be increased up to 96 months. 512-bit or 1024-bit (1024 bit size is recommended as it provides stronger encryption) This is an arbitrary password. This is a case sensitive value. Make sure you remember this password. You will need it in order to associate the Server ID to a Host. Re-enter the private key password. 3. After all the required information is entered, click OK. Because the generation of a self-signed certificate involves public-private key pair generation, this process may take some time. After the key-pair and certificate are created, the certificate is added under Users in the tree pane 4. Close the Certificate Manger window to continue. Configuration Activate the appropriate CLEO AS2 System Test host(s): 1. Click the Preconfigured tab in the tree pane. 2. Find the desired CLEO AS2 System Test host(s) in the list of pre-configured hosts and right-click on it. 4
3. Select Clone and Activate. The entire pre-configured host and branch will be copied and made active and the new active host will automatically be selected in the tree. The new active host alias may be appended with a number, if necessary, to make it unique. The original pre-configured host will remain in the Preconfigured tree. The Local Listener The Local Listener receives and handles all inbound requests to your VersaLex product. Inbound requests include unsolicited and asynchronous AS2/HTTP trading partner messages and VersaLex web browser user requests (supported only on Unix and Windows platforms). The Local Listener must be configured properly in order for the Cleo Test Server to successfully send you messages. A detailed description of the necessary steps for configuring the Local Listener for receving AS2 messages may be found in Section 6 (Local Listener) of the User s Guide. You may view the latest User s Guide online at either http://www.cleo.com/lexicomdoc or http://www.cleo.com/vltraderdoc. You will need to provide your product serial number in order to access this site which may be found through the Tools>License menu option. You may also use the Listener Configuration Wizard to help you configure the Local Listener. To access the wizard, right-click on the Local Listener in the active tree pane and select Wizard... or click the pane. wizard button in the Local Listener content Run a Test 1. Click on one of the Cleo AS2 System Test <send> actions: 5
2. Click the Run button to start the send action and run your test with the Cleo AS2 Test System. 3. You may use your mouse to drag and expand the message pane and verify a successful session. Note: There may be a delay between the Result: Success Asynchronous MDN request has been queued, message and the Result: Success Sent and received Message Integrity Check code match message as the test server queues and sends the MDN. 6