Skip to main content
OCLC Support

Option ReferInHostname

Learn how to use the Option ReferInHostname config.txt directive to specify that when EZproxy is creating a referring URL to authenticate the user into a remote web server.

Option RefererInHostname specifies that when EZproxy is creating a referring URL to authenticate the user into a remote web server, the referring hostname should include the value of the Referer directive. By default, if an EZproxy server named ezproxy.yourlib.org is using LoginPort 80 and a Referer value of demo, then the remote web server will see the request as being referred from http://ezproxy.yourlib.org/referer/demo. If Option RefererInHostname is enabled and EZproxy operates in proxy by hostname, the referring URL would change to http://demo.ezproxy.yourlib.org/referer/demo.

This option can be useful if working with remote web server that authenticate solely based on the hostname portion of the referring URL, without the ability to match on other portions of the URL.

This option affects all databases that use referring URL authentication. It cannot be enabled and disabled on a database stanza by database stanza basis.

Syntax

Option RefererInHostname

Example

Enable the inclusion of the Referer value in referring URLs and configure Some Database to use referring URL authentication.

Option RefererInHostname 
Referer secret 
Title Some Database
URL http://www.somedb.com

Related directives

Option ProxyByHostname, Referer