Skip to main content
Matrix42 Self-Service Help Center

HowTo: Configure proxy settings for Active Directory Connector

  1. Last updated
  2. Save as PDF

Summary

When you installed the Active Directory Connector on a server, which requires to through a proxy (possibly with authentication) to connect to the internet, you need to configure the connector accordingly. This article explains how to do this.

Proxy authentication is supported since version 1.0.16.13.

Auto proxy configuration with a .pac file using the ProxyAutoConfigScriptAddress is supported since version 2.7.0.0.

Goal

After completing this how-to you will have configured to installed Active Directory Connector to use a proxy server to connect to the internet.

First Step: Configure Registration Wizard

If the Active Directory Connector Registration Wizard is currently running, please close it first.
Open the following file in a text editor (e.g. notepad):

C:\Program Files\matrix42\MyWorkspace Cloud Connector\Tools\Configuration\appSettings.production.config

Add the following keys according to your proxy environment (some keys are optional, see below to find the correct combination):

<add key="ACSTunnel.ProxyAutoConfigScriptAddress" value="http://1.2.3.4:5678/proxy.pac" />
<add key="ACSTunnel.ProxyAddress" value="http://1.2.3.4:5678" />
<add key="ACSTunnel.ProxyUserName" value="user" />
<add key="ACSTunnel.ProxyPassword" value="password" />
<add key="ACSTunnel.ProxyDomain" value="domain" />

Second Step: Configure Windows Service

First stop the windows service Matrix42 Universal Agent Framework (Matrix42UAF). Then open the following file in a text editor (e.g. notepad):

C:\Program Files\matrix42\Universal Agent Framework\Matrix42.Platform.Service.Host.exe.config

Add the following code between <appSettings> and </appSettings> (some keys are optional, see below to find the correct combination):

<add key="ACSTunnel.ProxyAutoConfigScriptAddress" value="http://1.2.3.4:5678/proxy.pac" />
<add key="ACSTunnel.ProxyAddress" value="http://1.2.3.4:5678" />
<add key="ACSTunnel.ProxyUserName" value="user" />
<add key="ACSTunnel.ProxyPassword" value="password" />
<add key="ACSTunnel.ProxyDomain" value="domain" />

Combinations of Proxy-Settings

The following combinations of the proxy settings are supported:

  • None: Will not use any proxy server.
  • Only ProxyAutoConfigScriptAddress/ProxyAddress: Will use the specified proxy server with default or no authentication.
  • ProxyAutoConfigScriptAddress/ProxyAddress, ProxyUserName and ProxyPassword: Will use the specified proxy server with basic authentication.
  • ProxyAutoConfigScriptAddress/ProxyAddress, ProxyUserName, ProxyPassword and ProxyDomain: Will use the specified proxy server with windows authentication.

The if both ProxyAutoConfigScriptAddress and ProxyAddress are specified, the ProxyAutoConfigScriptAddress will be used.