Testing the EZproxy configuration
From WCN
Contents |
During the configuration process it might be useful to see what the results of an authentication attempt. Below are instructions for configuring your EZproxy server to show the results of an authentication attempt in userObjectResponse format.
Add the following directive to "config.txt" file. This will require a restart of EZproxy.
Option UserObjectTestMode
After testing is completed this Option should be either removed or commented out:
#Option UserObjectTestMode
Due to a bug in EZProxy use these instructions to pull an User Object until further notice
After restarting testing is possible by following the URL to your EZproxy server as described below:
https://myproxy.myinstitution.edu/login?url=https://myproxy.myinstitution.edu/userObject?service=getToken
[edit] A fully populated and functioning userObjectResponse
<?xml version="1.0" encoding="UTF-8"?>
<userObjectResponse>
<serviceStatus>OK</serviceStatus>
<userDocument>
<lastAuthenticated>2009-01-23T17:16:13Z</lastAuthenticated>
<groupNumber>WORLD_CAT_GROUP_ID</groupNumber>
<instNumber>WORLD_CAT_REGISTRY_ID</instNumber>
<uid>999999</uid>
<location>plxc</location>
<category>11</category>
<forename>Jeff</forename>
<surname>Greer</surname>
<emailAddress>jeff.greer@oclc.org</emailAddress>
<dateFormat>MM-DD-YY</dateFormat>
<joinDate>01-21-09</joinDate>
<expiryDate>03-03-09</expiryDate>
<bannedInRemoteCirculation>N</bannedInRemoteCirculation>
</userDocument>
</userObjectResponse>
[edit] Mapping Locations and User Categories User Objects
Because locations and category are ILS defined Navigator needs to map the codes passed back in the user object to codes used in NRE.
[edit] Categories
Once the EZProxy implementer has verified your user object he/she will contact someone from NRE implementations who will contact you and ask that you to gather all the possible categories the ILS can send in an user object in a file and send to them to be mapped for your authentication service.
Your patron/user categories will be mapped to one of the categories agreed in the unified list of consortia categories. Each consortium's list is different, click on your consortia below to view the unified list of categories.
The NRE implementer will map your patron categories and send a file back for your approval.
If you choose not to return patron categories a default will be selected for all patrons/users who successfully authenticate.
[edit] Locations
If you have multiple requesting locations configure in NRE we will need to map the location code returned in the user object to the appropriate NRE location.
Single locations can be defaulted.
