Determining and providing your URL information

The AS2, AS3/FTP server (Cleo Harmony and Cleo VLTrader applications only), and ebMS protocols require you to forward your Cleo Harmony, Cleo VLTrader, or Cleo LexiCom URL to your trading partner.

Local Listener

If you have not already done so, configure your Local Listener. See Configuring the Local Listener.

Use the Local Listener Configuration Wizard configuration wizard (see Using the wizard to create a host or mailbox) and follow the steps to specify the address and ports. 
Note: You can also use the Local Listener Configuration Wizard to create signing/encryption certificates.

URL exchange

The method of URL exchange must be agreed upon with the trading partner.  The mailbox Notes tab may come preconfigured with specific information concerning URL exchange with a particular trading partner.

The Email Profile utility automatically builds the URL.  If you are not using the utility, you must build the URL by hand.

Building an URL using the Email Profile Utility

If emailing, use the Email Profile utility. See Emailing a profile to your trading partner
Note: This utility is also used to send your signing/encryption certificates.
Even if the utility is not used to forward your profile to your trading partner, you can use the utility to capture the information locally.

Building an URL for AS2 and ebMS

AS2 and ebMS are HTTP protocols. An HTTP URL is of the form: http(s)://your-host:httpport/your-resource-path where:
  • http or https is specified depending on whether you are using an HTTP or HTTP/s Port from the Configuring a Local Listener for HTTP.
  • your-host is the fully qualified name (recommended) or static, external IP address of the VersaLex computer. For AS2, this is My External Address in the Configuring AS2 Service. Contact your systems administrator if you do not know your fully qualified name or external IP address. You may also obtain your external IP address by accessing http://www.cleo.com/whoami .
  • httpport is the HTTP or HTTP/s Port in the Local Listener: HTTP tab. See Configuring a Local Listener for HTTP. Including :httpport in the URL is optional when the standard port is used. Port 80 is the standard port for HTTP and port 443 is the standard port for HTTP/s.
  • If you are using Cleo VLProxy software (or a third party reverse proxy), http or https, your-host, and httpport depend on the proxy settings.
  • your-resource-path is the Resource Path in either the AS2 Service: AS2 tab or the ebMS Service: ebXML tab. See Configuring AS2 Service and Configuring ebXML Message Service.

Building an URL for AS3 and FTP

For AS3 server or FTP server are FTP protocols. An FTP URL is of the form: ftp(s)://your-host:ftpport where:
  • ftp is specified if using an FTP or FTP/s Explicit Port and ftps is specified if using an FTP/s Implicit Port from the Local Listener: FTP tab .
  • your-host is the fully qualified name (recommended) or static, external IP address of the VersaLex computer. Contact your systems administrator if you do not know your fully qualified name or external IP address. You may also obtain your external IP address by accessing http://www.cleo.com/whoami .
  • ftpport is the FTP or FTP/s Port in the Local Listener: FTP tab. See Configuring a Local Listener for FTP.  (Inclusion of :ftpport in the URL is optional when the standard port is being used. Port 21 is the standard port for FTP and FTP/s Implicit and port 990 is the standard port for FTP/s Explicit.)
  • If using Cleo VLProxy (or a third party reverse proxy), ftp or ftps, your-host, and ftpport depend on the proxy settings.