Configuring the Telnet Listener

The Telnet listener can be configured much like any other listener in iWay Service Manager. Once the listener is configured, it is then compiled into a channel. No other components are necessary for this channel. The channel must be active for the Telnet Management Connection to be used.

To prevent conflicts and accidental connections, iWay strongly suggests specifying a unique port number (instead of the standard default port number 23) during the configuration process.

The Authentication Realm field identifies the provider that will authenticate the user based on the password, and make available the ACL tokens (roles or authorities) that the user has. Authenifcation realms are available for the console user file, a properties file, SQL, LDAP, and JAAS.

Procedure: How to Configure the TCP Listener

To configure a TCP listener:

Ensure that iWay Service Manager is running.
On Windows, you can start iWay Service Manager by clicking Start, selecting Programs, iWay 6.0.1 SM, and then Start Service Manager for the configuration you are currently using.

For more information on starting and stopping iWay Service Manager, see the iWay Service Manager User's Guide.
Open a browser window and point to the following URL:
```
http://host:port/ism
```
where:
host
Is the host machine on which iWay Service Manager is installed.
port
Is the port on which iWay Service Manager is listening. The default port is 9999.
On Windows, alternatively, you can click Start, select Programs, iWay 6.0.1 SM, and then click Console.
A login dialog box opens.
Type a user name and password for the configuration you are using, and click OK.
The iWay Service Manager Administration Console opens.
Click Registry in the top pane, and then click Listeners in the left pane.
The Listeners pane opens.

The table that is provided lists all the previously configured listeners and a brief description for each.
Click Add.
The Select listener type pane opens.
Select TCP from the Type drop-down list and click Next.
The Configuration parameters for the TCP listener pane opens.

Note: The parameters prefixed with a (*) in the listener configuration pane are required.
Provide the appropriate values for the TCP listener parameters.
For more information, see TCP Listener Configuration Parameters.
Click Next.
You are returned to the Select listener type pane.
Enter a name for the TCP listener and description (optional).
Click Finish.
You can now use this listener as part of your channel configuration where the business logic will be applied to the received messages.

Parameter	Description
Telnet
Port	TCP port for receipt of Telnet requests. Note: To prevent conflicts and accidental connections, iWay strongly suggests specifying a unique port number (instead of the standard default port number 23) during the configuration process.
Local bind address	Local bind address for multi-homed hosts. This parameter value is usually not specified.
Timeout	Period in seconds of inactivity after which the connection is timed out. The default value is 600 seconds.
Security
Allowable Clients	If supplied, only messages from this list of fully qualified host names and/or IP addresses are accepted. Accepts comma-separated list or use the FILE() function.
Authentication Realm	Name of a configured authentication realm to validate logins. For full access to management commands, the user must be granted administrative privileges (admin role). If an authentication realm is not supplied, the logins will be delegated to the Web console's user database.
Secure Connection	Use SSL to secure the channel. By default, this parameter is set to False.
SSL Context Provider	Named iWay Security provider for SSL Context.
SSL Client Authentication	If set to True, the authentication will be required from the client.