Horizon Information Portal 3.x Authentication

Minimum version required

The features described on this page require EZproxy 4.0h GA (2007-07-11) or later.

Configuration

EZproxy can be configured to verify patron information against the account feature of a SirsiDynix Horizon Information Portal 3.x server. A sample configuration employing all available options is:

::HIP
Debug
Profile profile
OverviewSubmenu overview
ProfileSubmenu info
URL http://hip.yourlib.org/ipac20/ipac.jsp
Unauthenticated; Stop
IfTest Balance >n 5.00; Deny excessfines.htm
IfTest ItemsLost >n 0; Deny itemslost.htm
IfTest ItemsOverdue >n 0; Banner overdues.htm
IfTest Location *Some Branch*; Stop
Deny wrongbranch.htm
/HIP

During initial configuration, if you include Debug as the first line after ::HIP, then EZproxy will record additional messages to messages.txt/ezproxy.msgto simplify configuration. Once everything is working, Debug should be removed.

Profile is used to specify which HIP profile should be used when testing access. If no profile is specified, EZproxy will connect without specifying a profile. The information EZproxy uses to authenticate the user is based on the information required by the profile (e.g., if the profile requires barcode and pin, then EZproxy will submit the "user" as the barcode the the "pass" as the pin to check access).

In this example, OverviewSubmenu and ProfileSubmenu are both optional. Each example shows the default value used if these are omitted. During configuration, you should log into the My Account area of HIP and click on the Overview tab then verify the submenu that appears in the Overview URL. If it is something different than the word overview, you should specify this value with OverviewSubmenu. The same applies for the Profile tab.

The URL directive specifies the base URL to the Horizon Information Portal. This line should typically be followed immediately by Unauthenticated; Stop which directs EZproxy to stop performing HIP processing if the user account information is not accepted.

IfTest demonstrates how to perform optional numeric tests on the outstanding balance, the number of items lost, and the number of items overdue. The Location test is a wildcard string test to check if the user has a particular home branch. In this example, users who are not associated to the specified branch are denied access.

In addition to the directives shown, the HIP block may also incorporate any of the common conditions and actions.