Salesforce

Ebook Central: Platform upgrade - proxy configuration

« Go Back

Information

 
TitleEbook Central: Platform upgrade - proxy configuration
Summary
Content
UPGRADING FROM MYILIBRARY
For libraries using Athens, Shibboleth, or IP authentication with a proxy server:
  • If you are an existing Ebook Central customer, you will continue to use your same authentication method. Please ensure your configuration matches our recommendations listed below.
  • If you are new to Ebook Central, the authentication method you used for MyiLibrary will be transferred to Ebook Central. Depending on your authentication set up, you might have to make a few changes to your configuration. Please visit this help article for new customers for further information.

UPGRADING FROM EBL AND/OR EBRARY
1.
UPGRADING FROM EBL

   1a. EZproxy Shared Secret on EBL >> EZproxy Shared Secret on Ebook Central
  • Leave existing EBL stanza exactly as it was
    • Make sure it is placed before any ExcludeIP or AutoLoginIP lines because the proxy login is used for patrons to sign into their personal account as well as for authentication
    • YOURSITE = EBL site ID = Ebook Central site ID -- they are always the same
  • Add the following Ebook Central stanza (no special location required, this stanza can be added at any time):
Title Ebook Central Proxied
URL https://ebookcentral.proquest.com/lib/YOURSITE
HJ http://ebookcentral.proquest.com/lib/YOURSITE
DJ ebookcentral.proquest.com
NeverProxy acs.ebookcentral.proquest.com

Title -hide Ebook Central reroute
NeverProxy ebookcentral.proquest.com
NeverProxy YOURSITE.ebookcentral.proquest.com
NeverProxy acs.ebookcentral.proquest.com

   1b. Patron Login + EZproxy proxied links on EBL >> Patron Login + EZproxy proxied links on Ebook Central
  • Leave existing EBL stanza exactly as it was
    • Stanza can be placed anywhere
    • YOURSITE = EBL site ID = Ebook Central site ID -- they are always the same
  • Add the following Ebook Central stanza (below the Exclude IPs, if you would like onsite users to bypass the proxy login):
Title Ebook Central Proxied
URL https://ebookcentral.proquest.com/lib/YOURSITE
HJ http://ebookcentral.proquest.com/lib/YOURSITE
DJ ebookcentral.proquest.com
NeverProxy acs.ebookcentral.proquest.com

 
   1c. Patron Login + WAM proxied links on EBL >> Patron Login + WAM proxied links on Ebook Central
  • Add the following to your WAM forward table:
    • ebookcentral.proquest.com

   1d. Patron Login + Squid proxied links on ebrary >> Patron Login + Squid proxied links on Ebook Central
  • You will likely need to edit squid.conf, adding or updating an 'acl' line to allow/approve/whitelist the following:
    • ebookcentral.proquest.com

2. UPGRADING FROM EBRARY to an existing Ebook Central site
This includes:
  • ebrary stage-2 upgrades - the Ebook Central site is already in place (settings were originally based on ebrary site's settings).
  • Joint stage-2 upgrades where the EBL site was already upgraded - the Ebook Central site is already in place (settings were originally based on EBL site's settings). Follow the EBL instructions for proxy settings (from section 1 above), and leave ebrary stanza in place.
  • EBL+ebrary back-to-back upgrades - EBL is upgraded first (settings will be based on EBL site's settings). Follow the EBL instructions for proxy settings (from section 1 above), and leave ebrary stanza in place.
By default, only the existing Ebook Central authentication will be used.  No ebrary authentication settings (such as IPs) will be copied over.  If this is as you want it:
  • Leave existing ebrary stanza exactly as it was
  • Leave existing Ebook Central stanza exactly as it was


3. UPGRADING FROM EBRARY *ONLY* -- that is, no existing EBL or Ebook Central site

   3a. EZproxy SSO on ebrary >> EZproxy SSO on Ebook Central​
  • Not sure if you are using EZproxy SSO on ebrary? Check your EZproxy config file. If you have the following stanza for ebrary, where xxxxx is your ebrary site ID, you are set up with SSO:
Option ebraryUnencodedTokens
ebrarySite xxxxx
Host site.ebrary.com
URL http://site.ebrary.com/lib/xxxxx
Neverproxy *.ebrary.com
  • Leave existing ebrary stanza exactly as it was
  • Add the following stanza, where YOUREBCENTRALSITE is your Ebook Central site ID
Title Ebook Central SSO
Option ebraryUnencodedTokens
ebrarySite -URL=https://ebookcentral.proquest.com:443 YOUREBCENTRALSITE
URL https://ebookcentral.proquest.com/lib/YOUREBCENTRALSITE
HJ http://ebookcentral.proquest.com
NeverProxy ebookcentral.proquest.com
NeverProxy YOUREBCENTRALSITE.ebookcentral.proquest.com
NeverProxy acs.ebookcentral.proquest.com
  • Make sure both stanzas are placed before any AutoLoginIP lines because the proxy login is used for patrons to sign into their personal account as well as for authentication
  • Our system only allows letters and numbers plus the following special characters in the patron username: _ . - @ ". The userID sent by EZproxy must not contain any other special characters, or authentication will fail.
  • You can add the Ebook Central stanza at any time prior to your upgrade.

     
   3b. IP + proxied links on ebrary >> EZproxy SSO on Ebook Central
  • When upgrading to Ebook Central, it is the perfect time to switch to EZproxy SSO.  With SSO, patrons sign into their personal account through your proxy server - alleviating the need to create and remember a separate login. And for off-campus users, once they sign in to access the site, they're automagically signed into their personal account  >See more
  • Not sure if you are using non-SSO EZProxy access to ebrary? Check your EZProxy config for your ebrary stanza. The ebrary stanzas for non-SSO setups are available at Admins, Remote Access: Configuration for basic proxy access
  • Leave your ebrary stanza exactly as it was
  • Add the following stanza, where YOUREBCENTRALSITE is your Ebook Central site ID
 
Title Ebook Central SSO
Option ebraryUnencodedTokens
ebrarySite -URL=https://ebookcentral.proquest.com:443 YOUREBCENTRALSITE
URL https://ebookcentral.proquest.com/lib/YOUREBCENTRALSITE
HJ http://ebookcentral.proquest.com
NeverProxy ebookcentral.proquest.com
NeverProxy YOUREBCENTRALSITE.ebookcentral.proquest.com
NeverProxy acs.ebookcentral.proquest.com
 
  • Make sure it is placed before any AutoLoginIP lines because the proxy login is used for patrons to sign into their personal account as well as for authentication
  • You can add the Ebook Central stanza at any time prior to your upgrade.
  • Our system only allows letters and numbers plus the following special characters in the patron username: _ . - @ ". The userID sent by EZproxy must not contain any other special characters, or authentication will fail.
  • It is essential to contact the Technical Support Team to request the necessary changes be made to the site configuration.

   3c. IP + EZproxy proxied links on ebrary >> Patron Login + EZproxy proxied links on Ebook Central
  • If you choose to use IP + simple proxied links on Ebook Central, you'll actually be using an authentication method we refer to as Patron Login  >See more 
  • Not sure if you are using non-SSO EZProxy access to ebrary? Check your EZProxy config for your ebrary stanza. The ebrary stanzas for non-SSO setups are available at Admins, Remote Access: Configuration for basic proxy access
  • Leave your ebrary stanza exactly as it was
  • Add the following stanza, where YOUREBCENTRALSITE is your Ebook Central site ID
 
Title Ebook Central Proxied
URL https://ebookcentral.proquest.com/lib/YOUREBCENTRALSITE
HJ http://ebookcentral.proquest.com/lib/YOUREBCENTRALSITE
DJ ebookcentral.proquest.com
NeverProxy acs.ebookcentral.proquest.com
 
  • If you would like your onsite users to bypass the proxy login when using proxied links, please note that you will need to place this stanza below your Exclude IP directives.


   3d. IP + WAM proxied links on ebrary >> Patron Login + WAM proxied links on Ebook Central
  • If you choose to use IP + simple proxied links on Ebook Central, you'll actually be using an authentication method we refer to as Patron Login  >See more 
  • Add the following to your WAM forward table:
    • ebookcentral.proquest.com

   3e. IP + Squid proxied links on ebrary >> Patron Login + Squid proxied links on Ebook Central
  • If you choose to use IP + simple proxied links on Ebook Central, you'll actually be using an authentication method we refer to as Patron Login  >See more 
  • You will likely need to edit squid.conf, adding or updating an 'acl' line to allow/approve/whitelist the following:
    • ebookcentral.proquest.com


 
URL NameEbook-Central-Platform-migration-proxy-configuration
Created Date2021-10-05 18:18

Powered by