Use a proxy server

Feature deprecation: On the January 1, 2021 decommission start date, Genesys development will begin to scale down the support services and remove unused connector services as final customers migrate off the connectors. Genesys will also introduce periodic disabling of the connectors during off hours. In early 2021, Genesys will post a schedule for disabling each connector, with two-week advance notice. Genesys’ objective throughout the decommission and removal process is to ensure that we do not negatively impact our customers’ businesses. For more information, see Deprecation: Genesys Cloud Bridge integrations.

You can configure the Bridge Server and connectors behind a web proxy for restricting or monitoring outbound traffic. The Bridge Server and connectors only support proxy servers with unauthenticated HTTP CONNECT tunneling.

Warning: Use of a proxy server is an advanced configuration that requires changes to system configuration files. Back up original versions of these files before changing them.
  1. Specify your proxy server when you install the Bridge Server.

    For more information, see Install the Bridge Server.

  2. In an administrator command prompt, type the following:
    netsh winhttp set proxy proxy-server="http=<your_proxy_server>,https=<your_proxy_server>"
  3. Update the machine.config files.
    1. Save backups of the machine.config files at the following two locations: C:\Windows\Microsoft.NET\Framework64\v4.0.30319\Config C:\Windows\Microsoft.NET\Framework\v4.0.30319\Config
    2. Run a text editor as an administrator and open the original two machine.config files.
    3. In each file, add the following text in blue between the configuration elements. 
      	 <!-- Add a proxy for bridge connectors to use -->
      		<defaultProxy enabled = "true" useDefaultCredentials = "true">
      				proxyaddress="http://{PROXY ADDRESS}:{PROXY PORT}"
    4. Replace {PROXY ADDRESS} and {PROXY PORT} with your proxy information, as in the following example:

    5. Save the files.
    6. Restart your services.

    For more information, see the following Microsoft articles:

    If you make invalid changes to the files, the connector fails to start. The following message appears in the ininbridgehost log file for the connector:

    ::API::log : loader: Could not create plugin instance
    System.Reflection.TargetInvocationException: Exception has been thrown by the target of an invocation.
       { … stack trace … }
    shared_ptr<DotnetPlugin>* plugin)
    Caused by: System.TypeInitializationException: The type initializer for 'System.Net.ServicePointManager' threw an exception.
       { … stack trace … }
    Caused by: System.TypeInitializationException: The type initializer for 'System.Net.ComNetOS' threw an exception.
       at System.Net.ServicePointManager..cctor()
    Caused by: System.Configuration.ConfigurationErrorsException: Configuration system failed to initialize
      { … stack trace … }
    Caused by: System.Configuration.ConfigurationErrorsException: Unrecognized element.
    (C:\Windows\Microsoft.NET\Framework64\v4.0.30319\Config\machine.config line 301)
      { … stack trace … }