Jump to: navigation, search

Client-Side Port Definition

The client-side port definition feature enables a client application (of server type) to define its connection parameters before connecting to the server application. This enables the server application to control the number of client connections. In addition, if the client application is located behind a firewall, the server application will be able to accept the client connection by verifying its predefined connection parameters.

Security Benefits

The client-side port definition feature enables a customer to better control the data connections through their firewalls, by enabling them to precisely define the connections that can tunnel through the firewalls. This reduces the susceptibility to denial-of-service (DoS) attacks, where an excessive number of malicious application-level requests arrive at the same server-side port. This can result in the server application dropping its performance or even becoming unstable. It also affects the other applications on the same server or in the network.

Supporting Components

This feature applies to the following components:

  • Configuration Server Proxy on all of its connections, except to its HA partners
  • License Resource Manager when connecting to Configuration Server/Configuration Server Proxy
  • Media T-Servers when connecting to Configuration Server/Configuration Server Proxy
  • Network T-Servers when connecting to Configuration Server/Configuration Server Proxy
  • Load Distribution Server on all of its connections with T-Server and Configuration Layer.
  • Universal Router Server when connecting to Configuration Server/Configuration Server Proxy, T-Server, Custom Server, Stat Server, and DB Server
  • Custom Server when connecting to Configuration Server/Configuration Server Proxy
  • Outbound Contact Server when connecting to Configuration Server/Configuration Server Proxy, T-Server, Stat Server, and DB Server
  • CPD Server and CPD Proxy Server when connecting to Configuration Server/Configuration Server Proxy and T-Server
  • IVR Server and IVR Drivers for WVR for AIX, and for MPS when connecting to Configuration Server/Configuration Server Proxy
  • Stat Server when connecting to Configuration Server/Configuration Server Proxy, T-Server, DB Server, and Interaction Server
  • Genesys Voice Platform (GVP) when connecting to Configuration Server/Configuration Server Proxy
  • Interaction Server when connecting to Universal Contact Server, Interaction Server, Email Server Java, Chat Server, SMS Server, Social Messaging Server, Classification Server, Stat Server, Message Server, and Configuration Server/Configuration Server Proxy
  • Chat Server when connecting to Message Server, Configuration Server/Configuration Server Proxy, Interaction Server, and Universal Contact Server
  • Web API Server Java when connecting to Configuration Server/Configuration Server Proxy, Solution Control Server, and Message Server
  • Web API Server .NET when connecting to Configuration Server/Configuration Server Proxy, Solution Control Server, and Message Server
  • SMS Server when connecting to Protocol Adapter, Interaction Server, Message Server, Configuration Server/Configuration Server Proxy, and Solution Control Server
  • Classification Server when connecting to Configuration Server/Configuration Server Proxy and Message Server
  • Social Messaging Server when connecting to Message Server, Configuration Server/Configuration Server Proxy, and Interaction Server
  • Email Server Java when connecting to Configuration Server/Configuration Server Proxy, Message Server, Interaction Server, and Universal Contact Server
  • Genesys Info Mart when connecting to Configuration Server/Configuration Server Proxy and Message Server
  • CCPulse+ when connecting to Configuration Server/Configuration Server Proxy
    Important
    For CCPulse+ connections to Configuration Server, refer to the Reporting 8.0 CCPulse+ Administrator's Guide.
  • Workspace Desktop Edition (formerly known as Interaction Workspace) when connecting to Configuration Server, Stat Server, Universal Contact Server, Interaction Server, and T-Server/SIP Server.
    Important
    For Workspace Desktop Edition connections to Configuration Server, please refer to the Workspace Desktop Edition Deployment Guide. For the other connections, the procedures described in this guide are applicable.
  • Genesys Rules Engine and Genesys Rules Authoring Tool when connecting to Configuration Server/Configuration Server Proxy
  • Genesys Interactive Insights on its connections between server components. Refer to Genesys Interactive Insights documentation for more information.

In addition, Enterprise SDK and Platform SDK support client-side port definition for Genesys components that support this feature. For details about how client-side port definition can be used in custom-built applications, refer to the appropriate API Reference for your development platform.

Known Issues and Recommendations

Several known issues exist in the current client-side port definition feature implementation:

  • Activation of this feature requires you to supply client parameters, which Genesys recommends that you do through the Genesys Installation Wizard.
  • The Media Configuration Wizard does not support the client-side port definition feature configuration. When installing T-Server in an environment where there will be a port-restricted firewall between T-Server and Configuration Server, you must initially configure and install such a T-Server manually.
  • If the client-side port definition feature is enabled during T-Server installation, when T-Server starts, it will report warning messages in its log about command-line parameters related to this feature. Ignore these messages.
  • If a client’s connection parameters to Configuration Server are defined manually in several different places, make sure that those entries are identical.
  • If you add this feature to configured redundant components, the port number (and, optional, IP address) specified in the primary server Application object are automatically propagated to the backup server Application object. Correct these parameters in the backup server Application object manually.
  • Genesys licensing functionality does not support the client-side port definition feature configuration.

Feature Configuration

To configure client-side configuration, do the following steps:

1. Specify the client’s connection parameters (the port number and optionally, the IP address). These parameters will be used for the initial connection to Configuration Server. [+] Show steps
2. Add a Configuration Server Application object to the client’s Connections. [+] Show steps
3. (Optional) Add a client’s connection parameters to the server’s connections properties. [+] Show steps

Feedback

Comment on this article:

blog comments powered by Disqus
This page was last modified on August 30, 2016, at 12:26.