Adding SSO capability to your EZproxy configuration
Log in as a manager. In the administration interface, select the "Organization" tab. Scroll down to the "Security" tab and copy the "EZproxy configuration" line similar to the following:
Paste this line into your EZproxy configuration file, usually named ezproxy.txt. You must then restart your EZproxy server, which normally takes only a few seconds.
Connecting to www.pretnumerique.ca services
Direct your users to your EZproxy server's "/sso/cantookstation" URL in order to log in to www.pretnumerique.ca
Settings
| Name | Required | Description |
|---|---|---|
| context | No | Allows sending an ISBN in the following format: "isbn:9782896940233" in order to redirect to a particular ebook's details page upon login. |
Example of use with the \"context\" parameter:
Known issues
Problem
If you attempt to connect via SSO a user who has not yet authenticated through EZproxy, and then send him directly to a book's details page by passing the ISBN via the \"context\" parameter, the user may be redirected to the home page instead. This is due to a known bug that should be fixed in version 5.6.4 of EZproxy.
Solution
Meanwhile, you can circumvent this problem by using the URL below instead of the one above. This workaround should work in all cases, whether the patron is logged in or not.
Problem
You get the following message when trying to connect: \"An error has occurred and we have been notified Keypoxy::ExpiredTimestampError\".
Solution
Make sure that the EZProxy server's time is accurate. Any difference exceeding 35 seconds will result in an unsuccessful connection. We suggest that you synchronize your time with an NTP server.
Problem
The connection creates a redirect loop (HTTP 310)
Solution
Add the following line to ezproxy.txt: