How to configure the Connector for proxy internet access

Product: Connector for Sitecore

Version: all versions

Question

Can I configure the Connector for Sitecore for proxy Internet access?

Answer

Clay Tablet does not directly interact with a proxy. If the Sitecore process can reach the Internet through a proxy, so can the Connector. You can also configure proxy access for the Connector through system setup, as described in the note below.

To configure the Sitecore process to use a certain proxy regardless of system setup, edit Website/web.config, as follows:

<system.net> 
...
<defaultProxy>
<proxy proxyaddress="url:port" bypassonlocal="true" />
</defaultProxy>
</system.net>

or

<system.net>
...
<defaultProxy useDefaultCredentials="true">
<proxy usesystemdefault="False" scriptLocation="http://<IIS Server or IP Address>/wpad.dat" />
</defaultProxy>
</system.net>

Note: Some proxies require the Connector to use a special "buffer" mode to communicate with AWS.

• For version 3.5.0.3 and higher, when you edit Website/web.config, add the following entry to turn on that mode: 

<appSettings>
...
<add key="CT_AWSS3Connection_NeedProxy" value="True"/>
</appSettings>

• For earlier versions, contact Clay Tablet Support about deploying a special build of Affirma.ThreeSharp.dll, which has the "buffer" mode on all the time.

For more information, refer to the following resources:

• http://msdn.microsoft.com/en-us/library/dkwyc043.aspx
• http://blogs.msdn.com/b/rickrain/archive/2011/03/25/why-scriptlocation-may-not-work-when-pointing-to-a-proxy-script-file-in-your-application-config-file.aspx

Note about configuring proxy access through system setup: .NET applications, including the Connector for Sitecore, typically use the Microsoft Internet Explorer configuration for the Internet connection setting. Sometimes, the logged-in user can access the Internet via a proxy server because of a per-user proxy setting in Microsoft Internet Explorer, but Sitecore cannot reach AWS. This occurs because the Sitecore server runs as service, so the proxy setting does not apply to the system user that runs the Sitecore process. For more information, see https://claytablet.zendesk.com/hc/en-us/articles/202612415-Troubleshooting-Invalid-product-key-error-although-key-files-are-correctly-installed.