Setting up an HTTPS gateway

You set up an HTTPS gateway so that documents can be sent from the hub to your participant's IP address. When you set up an HTTPS gateway, you can also specify that documents be sent through a configured proxy server.

To create HTTPS gateways, use the following procedure.

  1. Click Account Admin > Profiles > Community Participant.
  2. Enter search criteria and click Search, or click Search without entering any search criteria to display a list of all participants.
  3. Click the View details icon to display the participant's profile.
  4. Click Gateways.
  5. Click Create.

Gateway Details

From the Gateway List page, perform the following steps:

  1. Type a name to identify the gateway. This is a required field.
  2. Optionally indicate the status of the gateway. Enabled is the default. A gateway that is enabled is ready to send documents. A gateway that is disabled cannot send documents.
  3. Optionally indicate whether the gateway is Online or Offline. The default is Online.
  4. Optionally enter a description of the gateway.

Gateway Configuration

In the Gateway Configuration section of the page, perform the following steps:

  1. Select HTTPS/1.0 or HTTPS/1.1 from the Transport list.
  2. Optionally, select a proxy server to be used. The Forward Proxy List includes any proxy servers that you have created, including the default proxy server. The default value for this field is Use default forward proxy. If you want the selected participant to use a different proxy server, select that server from the list. If you do not want to use this feature with the selected participant, select Use no forward proxy.
  3. In the Address field, enter the URI where the document will be delivered. This field is required.

    The format is: https://<server_name>:<optional_port>/<path>

    For example:

    https://anotherserver.ibm.com:57443/bcgreceiver/Receiver
  4. Optionally enter a user name and password, if a user name and password are required to access the secure HTTP server.
  5. In the Retry Count field, enter the number of times you want the gateway to attempt to send a document before it fails. The default is 3.
  6. In the Retry Interval field, enter the amount of time the gateway should wait before attempting to send the document again. The default is 300 seconds.
  7. In the Number of Threads field, enter the number of documents that can be processed simultaneously. The default is 3.
  8. In the Validate Client IP field, select Yes if you want the IP address of the sender to be validated before the document is processed. Select No otherwise. The default is No.
  9. In the Validate Client SSL Cert field, select Yes if you want the digital certificate of the sending partner to be validated against the business ID associated with the document. The default is No.
  10. In the Auto Queue field, select Yes if you want the gateway to be placed offline (automatically) if a delivery failure is about to occur because the number of retries has been exhausted. Select No otherwise. The default is No.

    When you select Auto Queue, all documents remain queued until the gateway is placed online manually.

  11. In the Connection Timeout field, enter the number of seconds a socket will remain open with no traffic. The default is 120 seconds.
  12. If you want to configure the Preprocess or Postprocess step for the gateway, go to Configuring handlers. Otherwise, click Save.

Copyright IBM Corp. 2003, 2005