]> git.evergreen-ils.org Git - Evergreen.git/blob - docs/modules/integrations/pages/ezproxy.adoc
Docs: adding information about 3.6 features from the release notes
[Evergreen.git] / docs / modules / integrations / pages / ezproxy.adoc
1 = EZProxy =
2
3 Evergreen can provide CGI authentication for EZProxy.
4 To enable this, you will need to:
5
6 . Add a new User Activity Type to Evergreen for EZProxy CGI authentications.
7 . Add a new Remote Authentication Profile to Evergreen. You will probably want
8 to use `EZProxyCGI` as the name.
9 . Edit the `<Location /api/ezproxy>` stanza in Evergreen's eg_vhost configuration
10 file. In particular, you will need to allow access to from your EZProxy server,
11 fill in the base uri of your EZProxy server, and add a secret to the
12 _OILSRemoteAuthEZProxySecret_ variable.
13 . Restart Apache.
14 . Edit the EZProxy user.txt file.  You will likely want to add a stanza such
15 as the following:
16
17 .Sample user.txt stanza
18 ----
19 ::CGI=http://your-evergreen-catalog.com/api/ezproxy?url=^R
20 ::Ticket
21 MD5 <same secret as in eg_vhost config>
22 Expired; Deny expiredticket.htm
23 /Ticket
24 ----
25
26 When this feature is enabled, users will see an Evergreen-based login screen.
27 You may customize the look and feel of this login screen by editing the relevant
28 template toolkit files.
29