Skip to main content
OCLC Support

URL (version 3)

Learn how to use the URL (version 3) config.txt directive to construct a web browser form to bring a user into a web server in EZproxy.

This version of URL specifies the information needed for EZproxy to construct a web browser form to bring a user into a web server, most often without proxying.

If a user accesses a /login/label URL from an IP address that requires user authentication (as opposed to an ExcludeIP address), and the user has not authenticated to EZproxy already, then the user will be challenged to authenticate before being allowed to proceed.

When an authenticated user or a user accessing from an ExcludeIP address accesses a /login/label
URL, EZproxy will provide access using qualifiers and options.

Qualifiers 

Qualifier Description
-Form= method Specify the type of form to construct. Value may be get, post, or dynamic.
label Label to use when building EZproxy URLs that refer to this database stanza.
url URL to which to either redirect users or to retrieve for -Form= dynamic.

Options

Option Description
-RewriteHost Specify that remote users should not be sent url, but instead should be sent to the proxied version of url.

Syntax

URL -Form= method [-RewriteHost] label url

Examples

Enable a URL similar to http://ezproxy.yourlib.org/login/somedb?database=history to direct EZproxy to create a form with a destination of http://www.somedb.com/login.asp with fixed form variables of username and password and take the value of database specified in the URL to create a form variable named database with the value history. The user will be sent to this form without proxying.

Title Some Database
URL -Form=post somedb http://www.somedb.com/login.asp
FormVariable username=someuser
FormVariable password=somepass
FormVariable database 
         

Perform the same processing as the previous example, except specify that remote users should also be proxied when access the remote resource. Unlike the previous example, this version also contains a Domain directive to specify other hosts that should be proxied.

Title Some Database
URL -Form=post -RewriteHost somedb http://www.somedb.com/login.asp
FormVariable username=someuser
FormVariable password=somepass
FormVariable database
D somedb.com