Defining an Inlet

How to:

Each inlet contains a sequence of listeners, optional decryptors, and optional preparsers.

Listeners are defined as protocol handlers and are responsible for startup, shutdown, and obtaining the incoming messages. Listeners receive the messages from the transport protocol, set special registers, such as header values and input source, and then pass the message to a decryptor.

Decryptors can apply a decryption algorithm to the incoming message and verify the security of the message. A decryptor can be used to verify that the sender is authorized, to check that the message has not been changed, and to decrypt any part of the message that has been encrypted. Finally the decryptor passes the message to a preparser.

Preparsers convert transported messages into processable documents. For example, some preparsers convert non-XML messages into XML documents. Preparsers can be chained, so that the output of one preparser becomes the input of the next preparser. Input to the first preparser is a byte stream, and output is a properly encoded string. Subsequent preparsers accept and emit strings.


Top of page

x
Procedure: How to Define an Inlet

To define an inlet using the iWay Service Manager Administration Console:

  1. In the left console pane of the Registry menu, select Inlets.

    The Inlets pane opens, as shown in the following image.

    The table that is provided lists each inlet that is defined with a brief description. If you click the document schematic icon in the References column for a specific inlet, you will see which components are referencing that inlet.

    The following image shows the result of clicking the schematic icon for the file1 inlet:

  2. Click Add.

    The New Inlet Definition pane opens, as shown in the following image.

  3. Enter a name, for example, SampleInlet, and description for the inlet.
  4. Click Finish.

    The Construct Inlet pane opens, as shown in the following image.

    The table that is provided is used to list the components that are currently registered with the inlet.

  5. Click Add.

    The Select component type pane opens, as shown in the following image.

    The table that is provided lists the component types you can select and register with the inlet you are defining.

    • Listener. Protocol handlers that receive input for a channel from a configured endpoint.
    • Decryptor. Used to decrypt a document.
    • Preparser. A logical process that handles documents before they are parsed by the system, for example, converting a non-XML document to XML.

    Note: Each inlet is required to have a registered listener. The remaining components are optional during inlet configuration.


iWay Software