AnonymousURL

Minimum version required

The features described on this page require EZproxy 4.0a GA (2006-08-02) or later.

Overview

AnonymousURL is a position-dependent directive that interactions with database definitions. It is rarely used, and when used, should be applied with great caution as it directs EZproxy to allow people to retrieve select web content through your EZproxy server without authenticating. Its most common use is to authorize EZproxy to allow people to retrieve RSS links through EZproxy.

This is a dangerous directive

If you are not clear exactly what this directive does, OCLC encourages you not to use it. If you need help constructing such entries, contact support@oclc.org for assistance.

Syntax

The complete syntax is:

AnonymousURL [-RE] [-CS] [+|-] wildurl

If -RE is present, it specifies that wildurl is a regular expression. If -CS is present, it specifies that a case-sensitive comparison should be performed. If + appears in front of wildurl (and if - does not appear), it specifies that EZproxy should allow any URL matching wildurl to be retrieved by unauthenticated users. If - appear in front of wildurl, it specifies that EZproxy should not allow any URL matching wildurl to be retrieved by unauthenticated users.

If you specify -RE but not -CS, be aware that the URL that is being tested will be converted to lower-case, but the regular expression will not be changed, so all literal text in the regular expression should be specified in lower-case or else it will not match.

The recommended use of this directive is to place anonymousurl + lines before the Title line of the database definition that matches the URL, and a anonymousurl -* directive before the Title line of the next database_definition to prevent the directive from affecting any other database definitions.

Example

If Some Database provides rss feeds at http://www.somedb.com/rss/feedname.xml, you might use this:

AnonymousURL -RE +http://www.somedb.com/rss/[a-z]+.xml

Title Some Database
URL http://www.somedb.com/
Domain somedb.com

AnonymousURL -*

You would then need to determine the EZproxy version of the hostname for www.somedb.com and use it to construct a URL such as http://www.somedb.com.ezproxy.yourlib.org/rss/feedname.xml which you would use in your RSS reader.