Registering Partners Using the Config UI

Register the partner using the Config UI.

Register the partner with the identity information as follows:

Procedure

  1. Start the Config UI. See Starting GUI for details.
  2. Select the gateway project configuration.
  3. Click the PARTNER tab.
  4. Add a new partner. See Using Partners tab for details.
  5. Set the following fields for the new partner:
    Parameter Description
    Partner Serial Number Specifies the client’s identity that the Apache HTTP server forwards in the SerialNumber HTTP header of requests that are submitted by this partner. This can either be the certificate’s serial number or the subject distinguished name as used for the digital certificate.

    For example, the value can be defined as follows:

    Partner Serial Number: /C=US/ST=California/L=Palo Alto/O=Cloud Software Group, Inc./OU=ActiveMatrix Service Gateway/CN=ASG Demo Client01/emailAddress=asgclient01@tibasg.co.pd

    Partner Issuer CA Specifies the realm in which the client’s identity is valid. This is always the issuer distinguished name as used from the digital certificate for that partner.

    For example, the value can be defined as follows:

    Partner Issuer CA: /C=US/ST=California/O=Cloud Software Group, Inc./OU=ActiveMatrix Service Gateway/CN=TIBCO ASG Certificate Authority/emailAddress=admin@tibasg.co.pd

    Note: Partner Serial Number and Partner Issuer CA fields contain distinguished names as defined by the X.509 standard. The X.509 standard defines the fields, field names, and abbreviations used to refer to the fields.
  6. Click the Partner Operations tab.
  7. Define a ping operation (internal_ping) for a new partner. See Facade Access for details.
  8. Save the configuration.
  9. Start the Core Engine. See Starting Core Engine
  10. Test the configuration.
    1. Open a web browser window.
    2. Enter the following URL to submit a ping operation request:
            http://machine_name:listening_port_value/ping
    3. Verify that you receive ASG is alive response from TIBCO API Exchange Gateway on the web browser.