ebrary

ebrary has two options for remote access - Single-Sign-On or Patron Login + EZproxy. Add the database stanza that corresponds with your method.

Single-Sign-On

ebrary single-sign-on requires the following database stanza in config.txt:

Title Ebook Central SSO
Option ebraryUnencodedTokens
ebrarySite -URL=http://ebookcentral.proquest.com:80 YOUREBCENTRALSITE
URL https://ebookcentral.proquest.com/lib/YOUREBCENTRALSITE
HJ ebookcentral.proquest.com
DJ ebookcentral.proquest.com
NeverProxy ebookcentral.proquest.com
NeverProxy YOUREBCENTRALSITE.ebookcentral.proquest.com
NeverProxy acs.ebookcentral.proquest.com

Replace YOUREBCENTRALSITE with the YOUREBECENTRALSITE name provided by ProQuest. If you have questions about this, please contact ProQuest support.

Patron Login + EZproxy

ebrary patron login + EZproxy requires the following database stanza in config.txt:

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

Replace YOUREBCENTRALSITE with the YOUREBCENTRALSITE name provided by ProQuest. If you have questions about this, please contact ProQuest support.

ebrary Migration to Ebook Central

ebrary is now part of the Proquest Ebook Central platform. If you are migrating from an existing ebrary site to the new platform, please follow the instructions below. If you are a new Ebook Central subscriber, please see the new stanza on Ebook Central.

ebrary Migration to Ebook Central

If you have an existing subscription to EBRARY that is being migrated to the Ebook Central site, first determine which migration method is appropriate for your migration based on the headers and details below, then follow those steps.

Upgrading from ebrary ONLY to Ebook Central (no existing EBL or Ebook Central site) with Single Sign On (SSO)

Use this method if you have a stanza like the legacy single-sign-on configuration below in your config.txt file. This option will allow users to access ebrary and their personal libraries by clicking on your proxied links. They will not have to sign in to access their saved items and bookshelves.

  1. Leave your existing ebrary stanza exactly as it is. Make sure it is placed before ANY ExcludeIP directives. This option is NOT compatible with AutoLoginIP lines; you cannot have any AutoLoginIP directives in config.txt if you are using this option.

  2. Add the following stanza below your existing stanza, before any ExcludeIP directives. Replace YOUREBCENTRALSITE with the Ebook Central site ID contained in your migration paperwork.
    Title Ebook Central SSO
    Option ebraryUnencodedTokens
    ebrarySite -URL=http://ebookcentral.proquest.com:80 YOUREBCENTRALSITE
    URL https://ebookcentral.proquest.com/lib/YOUREBCENTRALSITE
    HJ ebookcentral.proquest.com
    DJ ebookcentral.proquest.com
    NeverProxy ebookcentral.proquest.com
    NeverProxy YOUREBCENTRALSITE.ebookcentral.proquest.com
    NeverProxy acs.ebookcentral.proquest.com
    This stanza can be added any time prior to your upgrade, and it will not interfere with your existing ebrary access.

  3. Continue to use your existing starting point URLs until ProQuest confirms migration is complete. At this time, you can update your starting point URLs to include target URLs from the new Ebook Central stanza added in step three.

Note: If you use the kb to manage your MARC records for ProQuest ebooks, make sure you DO NOT remove the old stanza until 14 days after your migration date. This will keep redirects functioning until enough time has passed to ensure that you have updated your local MARC records to point to the new platform. After your MARC records have been updated, you can remove the old stanza. If you have questions contact OCLC Support.

Upgrading from IP + proxied links on ebrary to EZproxy SSO on Ebook Central

Use this option is you currently have either of the legacy non-single-sign-on stanzas in your config.txt file. With this method, your users access ebrary through EZproxy and then must sign in using their ebrary credentials to access their personal bookshelf and saved items. By upgrading to SSO, users will automatically be taken directly to their personal bookshelf and see all saved items.

Note: When using the single-sign-on configuration with ebrary, EZproxy will pass your users' username to ebrary during authentication due to the Option ebraryUnecodedTokens directive. The username is considered in some cases to be personally identifiable information (PII).

  1. Leave your existing ebrary stanza as is. It can be placed anywhere in config.txt.

  2. Contact ebooksupport@proquest.com to let them know you would like to use the SSO configuration with your new Ebook Central site. SSO will not work unless ProQuest has made the necessary changes to your site configuration.

  3. Add the following stanza to your config.txt file making sure it is placed before any ExcludeIP directives. This option is NOT compatible with AutoLoginIP lines; you cannot have any AutoLoginIP directives in config.txt if you are using this option. Replace YOUREBCENTRALSITE with the Ebook Central site ID contained in your migration paperwork.
    Title Ebook Central SSO
    Option ebraryUnencodedTokens
    ebrarySite -URL=http://ebookcentral.proquest.com:80 YOUREBCENTRALSITE
    URL https://ebookcentral.proquest.com/lib/YOUREBCENTRALSITE
    HJ ebookcentral.proquest.com
    DJ ebookcentral.proquest.com
    NeverProxy ebookcentral.proquest.com
    NeverProxy YOUREBCENTRALSITE.ebookcentral.proquest.com
    NeverProxy acs.ebookcentral.proquest.com
  4. Continue to use your existing starting point URLs until ProQuest confirms migration is complete. At this time, you can update your starting point URLs to include target URLs from the new Ebook Central stanza added in step three.

Note: If you use the kb to manage your MARC records for ProQuest ebooks, make sure you DO NOT remove the old stanza until 14 days after your migration date. This will keep redirects functioning until enough time has passed to ensure that you have updated your local MARC records to point to the new platform. After your MARC records have been updated, you can remove the old stanza. If you have questions contact OCLC Support.

Upgrading from IP + EZproxy proxied links on ebrary to Patron Login + EZproxy Proxied links on Ebook Central

If you will continue to use EZproxy to allow patrons to access Ebook Central and require them to sign in with a separate Ebook Central username and password to access their personal bookshelves, use the following method.

  1. Leave your existing ebrary stanza as is. It can be placed anywhere in config.txt.

  2. Add the following stanza below your existing ebrary stanza.
    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
    Replace YOUREBCENTRALSITE with the EBCentralSite ID included in your migration paperwork.

  3. Continue to use your existing starting point URLs until ProQuest confirms migration is complete. At this time, you can update your starting point URLs to include target URLs from the new Ebook Central stanza added in step two.

Note: If you use the kb to manage your MARC records for ProQuest ebooks, make sure you DO NOT remove the old stanza until 14 days after your migration date. This will keep redirects functioning until enough time has passed to ensure that you have updated your local MARC records to point to the new platform. After your MARC records have been updated, you can remove the old stanza. If you have questions contact OCLC Support.

Legacy ebrary Stanzas

Single-Sign-On Configuration

Note: When using the single-sign-on configuration with ebrary, EZproxy will pass your users' username to ebrary during authentication due to the Option ebraryUnecodedTokens directive. The username is considered in some cases to be personally identifiable information (PII).

To activate ebrary Single-Sign-On User Authentication:

  1. Contact ebrary Customer Support at support@ebrary.com to arrange the ebrary configuration for single-sign-on. For more information about setting up SSO with ebrary, see ebrary's support site: EZproxy Single Sign On (SSO).

  2. Add the following stanza to config.txt before any ExcludeIP directives. This option is NOT compatible with AutoLoginIP lines; you cannot have any AutoLoginIP directives in config.txt if you are using this option:
    Option ebraryUnencodedTokens
    ebrarySite YOUREBRARYSITE
    Host site.ebrary.com
    URL http://site.ebrary.com/lib/YOUREBRARYSITE
    Neverproxy *.ebrary.com
    replacing YOUREBRARYSITE with your ebrary site name. Your current YOURSITE will be listed on the premigration checklist if you are migrating from a previous platform.

  3. Test with ebrary.

    It is very important that you back up the ezproxy.tkn file on a regular basis; see the single-sign-on details section below.

    If you are switching from ebrary proxy access to Single-Sign-On, existing user created ebrary bookshelves will need to be migrated to the new automatic bookshelves, ebrary Customer Support will provide additional information.

Single-Sign-On Details

User authentication method requirements

To maintain persistent identifiers, EZproxy requires unique user login information, and most EZproxy user authentication methods provide such information. AutoLoginIP and referring URL are incompatible since they do not provide unique user information.

Sites that use CGI authentication should insure that they are providing "loguser" information to associate distinct user information. See CGI Authentication for more information, including reference scripts for implementing CGI authentication.

Using EZproxy without Single-Sign-On (non-SSO):

7 line (with SSL certificate)

Option DomainCookieOnly
Title ebrary
URL http://site.ebrary.com/lib/CHANNELNAME
DJ ebrary.com
Find "site.ebrary.com/
Replace "^psite.ebrary.com^/
Option Cookie

5 line basic configuration (no SSL certificate, and whenSSL requirement is disabled):

Title ebrary
URL http://site.ebrary.com/lib/CHANNELNAME
DJ ebrary.com
Find "site.ebrary.com/
Replace "^psite.ebrary.com^/