Using a Proxy with the Printerpoint Agent

The Printerpoint Agent requires access outside the network to communicate with the Printerpoint cloud servers. 

In some cases, if the network has a proxy server, there are additional steps required to allow the agent to communicate.

There are three options for allowing Printerpoint to communicate through a proxy. The Printerpoint agent only makes outbound requests, there are no inbound requests to the agent from the Printerpoint cloud servers.

1. Create an exception in the proxy server for outbound traffic to the Printerpoint cloud servers
2. Define the proxy settings at the Agent and use Windows credentials to authenticate the proxy
3. Point the Printerpoint agent to a proxy URL and define the credentials in the Printerpoint agent settings

Option 1: Create an exception in the Proxy server for Printerpoint traffic

In this method, Printerpoint traffic is explicitly allowed at the proxy server level. A specific exception is made for any outbound traffic going to *.printerpoint.com.

Option 2: Define the proxy settings at the Agent and use Windows credentials to authenticate the proxy

Proxy information can be configured directly in the Agent configuration. These instructions are supported for Printerpoint Agent version 6.0.0 and higher.

1. Install the Printerpoint Agent and confirm that it is unable to communicate with the Printerpoint Server. 
2. Browse to C:\programdata\Sepialine\PrinterpointAgent and locate proxy.xml
3. If proxy.xml is not present, you can create the file in Notepad
4. Open proxy.xml in Notepad or another text editor and define the proxy URL
5. Set the Printerpoint Agent service to use a specific Windows user account that is allowed to communicate through the proxy

Proxy with credentials not defined

<?xml version='1.0'?>

<ProxyConfiguration>

<!-- ProxyCredentials or all sub-elements may be empty or omitted to use system credentials -->

                <ProxyAddress>PROXY_URL_AND_PORT</ProxyAddress> <!-- Define the proxy here -->

            <ProxyCredentials>

                    <Username></Username>  

                    <Password></Password>

                    <Domain></Domain>

            </ProxyCredentials>

</ProxyConfiguration>

Option 3: Define the proxy settings at the Agent and set the Windows credentials directly in the Agent configuration

This is similar to option 2, but the Windows credentials are stored in the Printerpoint Agent configuration file, and the agent can be run using the default user account. One downside of this approach is if the password is changed, the connection will stop working until the configuration is updated. 

Proxy with explicitly defined credentials

<?xml version='1.0'?>

<ProxyConfiguration>

<!-- ProxyCredentials or all sub-elements may be empty or omitted to use system credentials -->

                 <ProxyAddress>PROXY_URL_AND_PORT</ProxyAddress>

            <ProxyCredentials>

                     <Username>USERNAME</Username>  

                     <Password>PASSWORD</Password>

                     <Domain>DOMAIN</Domain>

            </ProxyCredentials>

</ProxyConfiguration>