Use a proxy server


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.
  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. 
      <configuration>
      	...
      			</providers>
      		</roleManagers>
      	</system.web>
      	
      	 <!-- Add a proxy for bridge connectors to use -->
      	<system.net>
      		<defaultProxy enabled = "true" useDefaultCredentials = "true">
      			<proxy
      				autoDetect="false"
      				bypassonlocal="false"
      				proxyaddress="http://{PROXY ADDRESS}:{PROXY PORT}"
      				usesystemdefault="false"
      			/>
      		</defaultProxy>
      	</system.net>
      </configuration>
    4. Replace {PROXY ADDRESS} and {PROXY PORT} with your proxy information, as in the following example:

      proxyaddress="http://172.18.176.206:80"
    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 … }