Proxy Configuration

Last Updated: 17 Dec 2015

The Proxy Configuration screen allows you to configure the proxy settings on your system, creating a default (or primary) proxy and giving you the ability to create alternate proxies, matched on specified URL patterns.

To access the Proxy Configuration screen, click on the System Configuration System config icon icon in the top right hand corner of the screen – a drop down list will appear under this icon. From this list, select Proxy Configuration – the screen will appear.

Primary Proxy Configuration

The Primary Proxy Configuration section allows you to configure and enable the primary proxy server to use on your Squiz Matrix system. When enabled, this proxy will act as the default proxy on the system and will be used unless an alternative proxy configuration is matched. The Primary Proxy Configuration section of the Proxy Configuration screen is shown in the figure below.

5-0-0_primary-proxy-configuration.png
Primary Proxy Configuration

The following fields are available:

  • Proxy Status: this field will list the status of the primary proxy. If the proxy settings have been enabled in the Enable Proxy field, this field will state whether the proxy configuration has passed or failed. If the proxy settings have been disabled, this field will list Disabled.
  • Enable Proxy: select whether or not to enable the primary proxy settings. If this field is set to Yes, the proxy settings will be enabled and the status of the proxy will be listed in the Proxy Status field. If this field is set to No, the proxy settings will be disabled and the proxy will not be used on the system.
  • Hostname: enter the hostname or IP address of the proxy server.
  • Port: enter the port number where the proxy server runs.
  • Username: enter the username for authentication to the proxy server.
  • Password: enter the password for authentication to the proxy server.

Proxy URL Manipulation

The Proxy URL Manipulation section allows you to ignore port numbers specified in URLs printed by Squiz Matrix. The Proxy URL Manipulation section of the Proxy Configuration screen is shown in the figure below.

5-0-0_proxy-url-manipulation-section.png
Proxy URL Manipulation

In the Ignore Port Number field, select whether or not to hide port numbers specified in URLs. If this field is set to Yes, URLs printed by Squiz Matrix will not contain the port number by which the system is being accessed, as shown in the example below:

http://www.example.com:3128/home/ -> http://www.example.com/home/

By default, this field is set to No.

Alternative Proxy Configuration

The Alternative Proxy Configuration section allows you to configure alternate proxy configurations to use when matched on a specified URL pattern. The Alternative Proxy Configuration section of the Proxy Configuration screen is shown in the figure below.

5-0-0_alternative-proxy-configuration-section.png
Alternative Proxy Configuration

To add an alternative proxy, select the Add New Proxy field and click Commit.

You can add as many alternative proxies as you like. Please note that the requesting URL will be matched against the URL pattern of each alternative proxy, from top to bottom. Only the first matching proxy will be used.

The fields available for an alternative proxy are shown in the figure below.

5-0-0_alternative-proxy.png
An Alternative Proxy

The following fields are available:

  • Hostname: enter the hostname or IP address of the alternative proxy server. Leaving this field blank will allow you to disable the use of the global proxy on URLs that match the alternative proxy.
  • Port: enter the port number where the alternative proxy server runs.
  • Username: enter the username for authentication to the alternative proxy server.
  • Password: enter the password for authentication to the alternative proxy server.
  • Pattern: specify a URL pattern that will be matched against requesting URLs. If this pattern is matched, the alternative proxy will be used instead of the system's primary proxy. For example, if this pattern is set to URL does contain squiz, then the proxy will be used if the requesting URL contains the value squiz, for instance, http://www.squizsuite.net.
  • Active?: select this field to enable the alternative proxy on your system. If this field is enabled, the alternative proxy will be used if the specified URL pattern matches the requesting URL. If this field is not selected, the alternative proxy will not be used.
  • Delete?: to delete the alternative proxy, select this field and click Commit. The alternative proxy will be deleted.

SSL Accelerator Configuration

The SSL Accelerator Configuration section allows you to configure an SSL (Secure Sockets Layer) accelerator on your system.

An SSL accelerator is a hardware/software proxy whose primary function is to handle the decoding of secure (https://) requests. These settings allow Squiz Matrix to detect the presence of the SSL accelerator and send links using the https:// protocol, as expected.

The SSL Accelerator Configuration section of the Proxy Configuration screen is shown in the figure below.

5-0-0_ssl-accelerator-configuration-section.png
SSL Accelerator Configuration

The following fields are available:

  • Handing Enabled?: select whether or not to enable the SSL accelerator settings. If this field is set to Yes, the SSL accelerator settings will be enabled and Squiz Matrix will attempt to detect an SSL accelerator on incoming http:// requests.
  • Match Method: select the method to determine whether a http:// request has been made through an SSL accelerator. The following matching options are available:
    • IP Address: the request is made from a specified IP addressed.
    • Header: the request contains a specified header name and value (stored in the $_SERVER variable).
    • Both: the request is both made from a specified IP address and contains a specified header name and value.
  • IP Address: specify an IP address to use for matching against http:// requests made to Squiz Matrix. This field should be used if either IP Address or Both is selected in the Match Method field. When enabled, the IP address entered into this field will be matched against http:// requests to determine if they have been made through an SSL accelerator.
  • Header Name / Value: specify a header name and value to use for matching against the header information of http:// requests made to Squiz Matrix, stored in the $_SERVER variable. This field should be used if either Header or Both is selected in the Match Method field. When enabled, the header information entered into these fields will be matched against http:// requests to determine if they have been made through an SSL accelerator.
  • Force Secure?: select whether or not Squiz Matrix will always produce secure (https://) URLs when it detects that it is running behind an SSL accelerator. If this field is set to Yes, secure URLs will be used except where an asset has been set to force standard http:// URLs. By default, this field is set to No.

Previous Chapter Next Chapter

The Latest

Let Us Know What You Think

Let us know if you spot any errors or if you have any ideas on how we can improve the Matrix Community Website.

Contact Squiz for Demo

Let us show you the true power of Squiz Matrix by giving you a personalised demonstration.